--- title: "Box: Configurando a Integração das Ações de Remediação" slug: "box-configuring-the-remediation-actions-integration" updated: 2026-11-17T00:09:24Z published: 2026-11-17T00:09:24Z canonical: "knowledge.catonetworks.com/box-configuring-the-remediation-actions-integration" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # Box: Configurando a Integração das Ações de Remediação ## Visão Geral XOps integrations let you take response actions in connected third-party applications as part of an investigation. You can revoke a user’s sessions or disable their account in your single sign-on (SSO) provider or a specific application. These actions help you contain threats by restricting access to affected accounts. To enable these actions, configure a connector for the relevant third-party application. For more information, see [Mitigating Threats in XOps Stories](/v1/docs/mitigating-threats-in-xops-stories). To configure the Remediation Actions integration, you need to: 1. Configure the required settings in the SaaS application 2. Create the API connector in the CMA A XOps license is required for Remediation Actions integrations. ### Benefícios de Conectar o Box O conector de Ações de Remediação do Box permite que o Cato execute ações de resposta em usuários do Box durante uma investigação. Ele usa um App de Plataforma Box dedicado com acesso de escrita, sem afetar outros conectores Box, como Atividades do Aplicativo e Descoberta de Dados. - **Desativar Usuário:** Encontra o usuário Box gerenciado cujo login corresponde ao email solicitado, ignorando a diferença de letras, e define o status da conta como **Inativo**. O usuário não pode mais fazer login e é desconectado de todos os aplicativos do Box. Pastas e arquivos do usuário são ocultados dos colaboradores até que a conta seja reativada. Os colaboradores mantêm seus níveis de permissão. O conteúdo, os grupos e a licença do usuário são mantidos. Se o usuário já estiver inativo, a ação relata essa condição e tem sucesso. - **Revogar Sessões de Login:** Encontra o usuário gerenciado da mesma forma e solicita que o Box encerre todas as sessões ativas. A conta permanece ativa e a senha não é alterada, então o usuário pode fazer login novamente. O Box executa a terminação da sessão como um trabalho em segundo plano. A ação é bem-sucedida quando o Box aceita o trabalho, e o resultado do trabalho aparece nos eventos do administrador do Box. A ação também é executada para um usuário inativo. Cada ação é executada em um único usuário, identificado por email, e relata **Concluído** ou **Falhou** com um motivo. Os motivos de falha incluem email ausente, nenhum usuário correspondente ou um erro do Box durante a pesquisa do usuário ou a solicitação de ação. Quando o Box retorna um código de erro e uma mensagem, eles aparecem no resultado. ## Configurando a Integração do Box Para configurar a integração, crie e autorize um App de Plataforma Box dedicado, depois crie o conector no Aplicativo de Gerenciamento Cato (CMA). ### Prerequisites - Uma licença Box Enterprise - Um Administrador Box que possa criar um App de Plataforma e aprová-lo para a empresa - Autenticação de dois fatores ativada na Conta Box que cria o aplicativo. Sem ela, o **Client Secret** fica indisponível. O escopo **Gerenciar usuários** concede amplas permissões sobre os usuários gerenciados, incluindo alterar logins, redefinir senhas, mudar funções e gerenciar seu conteúdo empresarial. Use um aplicativo de Plataforma dedicado para este conector. Não adicione este escopo ao aplicativo usado por outros conectores Box. ### Passo 1: Configurar a Integração no Box Crie um Aplicativo de Plataforma dedicado com acesso empresarial e permissão para gerenciar usuários. **Para configurar a integração no Box:** 1. Faça login no Console de Desenvolvedor Box em `https://<your_tenant>.app.box.com/developers/console`. 2. Crie um Aplicativo de Plataforma. 3. Escolha **Aplicativo Personalizado** e insira um nome. Selecione **Integração** como o propósito e **Segurança & Conformidade** como a categoria. 4. Escolha **Autenticação do Servidor (Concessão de Credenciais do Cliente)** e clique em **Criar Aplicativo**. 5. Na página de **Configurações Gerais**, copie e salve o **ID Empresarial** para que possa ser inserido no CMA. Insira este valor como o **ID de Assunto do Box**. 6. Na página de **Configuração**, clique em **Buscar Client Secret**. Copie e salve o **Client ID** e o **Client Secret** para que possam ser inseridos no CMA. 7. Na página de **Configuração**, defina o **Nível de Acesso do Aplicativo** para **Acesso ao Aplicativo + Empresarial**. Esta configuração fornece acesso aos usuários em toda a empresa, em vez de apenas aos próprios usuários do aplicativo. 8. Sob **Escopos do Aplicativo**, selecione **Gerenciar usuários**, e clique em **Salvar Alterações**. Este escopo é necessário para consultar usuários por email, desativar usuários e encerrar sessões de login. 9. Vá para a página de **Autorização** e clique em **Revisar e Enviar**. 10. Solicite que o Administrador da Box aprove o aplicativo para a empresa usando a notificação por email. Armazene o **Segredo do Cliente** com segurança. Não o coloque no controle de origem, tickets ou chat. Se você alterar os escopos do aplicativo, o Administrador Box deve reautorizar o aplicativo em **Console do Administrador > Plataforma > Aplicativos de Plataforma**. ### Passo 2: Criar o Conector de API no CMA Depois de configurar uma integração com a aplicação requerida, adicione os detalhes no CMA. Para Box, selecione **autenticação OAuth2 para Box** e insira as credenciais do Passo 1. **Para criar o conector de API no CMA:** 1. No menu de navegação, clique em **Recursos > Integrações** 2. Clique na aba **Integrações Ativas**. 3. Clique em Novo. O painel de **Nova Integração** é aberto. 4. Selecione a **Aplicação SaaS** que deseja adicionar. 5. No menu suspenso **Capacidade**, selecione **Ações de Remediação**. 6. Adicione os detalhes criados durante o passo um. - **Aplicativo SaaS:** Box - Selecione **autenticação OAuth2 para Box** - **ID do Cliente:** Digite o ID do Cliente do Passo 1 - **Segredo do Cliente:** Digite o Segredo do Cliente do Passo 1 - **ID do Sujeito Box (ID da Empresa):** Digite o ID da Empresa do Passo 1 - Insira um nome para a integração - **(Opcional)** Digite uma descrição 7. Clique em **Salvar**. O aplicativo está visível na tabela de **Aplicativos Integrados** com status de **Conectado**. ## Limitações de Serviços - **Somente usuários geridos:** Ambas as ações procuram apenas usuários geridos na sua empresa Box. Colaboradores externos não são encontrados, mesmo se seu login corresponder ao email solicitado. A ação reporta que nenhum usuário correspondente foi encontrado. - **Conta de serviço do conector:** A própria conta de serviço do conector não pode ser alvo. As contas de serviço não são retornadas pelas buscas de usuários Box. Uma ação com o objetivo de repassar o login dessa conta reporta que nenhum usuário correspondente foi encontrado. - **Entradas subsequentes:** as entradas subsequentes não são bloqueadas por **Revogar Sessões de Login**. A conta permanece ativa e a senha não é alterada. O usuário, ou qualquer pessoa que possua suas credenciais, pode entrar novamente. Use **Desativar Usuário** para bloquear acesso. - **Resultados de terminação de sessão:** O número de sessões encerradas não é reportado por **Revogar Sessões de Login**. Box aceita a solicitação antes da execução do trabalho em segundo plano, sem verificar contra as sessões do usuário. Verifique os eventos de admin da Box para o resultado do trabalho. - **Acesso do colaborador ao conteúdo:** Os arquivos e pastas do usuário estão ocultos dos colaboradores por **Desativar Usuários** até que a conta seja reativada. O conteúdo permanece no Box. Para restaurar o acesso de login e colaborador, defina o status do usuário como **Ativo** no Console de Administração do Box. - **Status da Conexão:** Apenas o login e a pesquisa de usuário são verificados pelo teste de conexão. **Conectado** confirma que o Cato pode autenticar com as credenciais do aplicativo e listar usuários gerenciados pela empresa. Uma permissão ausente para desativar usuários ou encerrar sessões é relatada quando uma ação é executada, como um resultado **Falhado** com o erro do Box. - **Autenticação:** Apenas o fluxo de credenciais do cliente OAuth 2.0 é suportado.