--- title: "Okta: Configurando a Integração de Ações de Remediação" slug: "okta-configuring-the-remediation-actions-integration" updated: 2026-11-17T00:09:20Z published: 2026-11-17T00:09:20Z canonical: "knowledge.catonetworks.com/okta-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. # Okta: Configurando a Integração de 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 Okta O conector de Ações de Remediação Okta permite que o Cato execute ações de resposta em contas de usuário Okta durante uma investigação. Ele usa um token de API separado, sem afetar outros conectores Okta, como Atividades de Aplicativo. - **Desativar Usuário:** Encontra o usuário cujo login ou email principal do Okta corresponde ao email solicitado e desativa a conta. O status da conta torna-se **Desativado**. Se a conta já estiver desativada, a ação relata essa condição e é bem-sucedida. - **Revogar Sessões de Login:** Encontra o usuário cujo login ou email principal do Okta corresponde ao email solicitado e limpa todas as sessões ativas do Okta. Ele revoga o acesso ao OpenID Connect e aos tokens de atualização emitidos para o usuário. Também limpa dispositivos de autenticação multifatorial (MFA) lembrados, solicitando ao usuário MFA no próximo login em cada dispositivo. A conta não está desativada. A ação funciona para qualquer status de usuário, incluindo usuários desativados. Cada ação é executada em um usuário, identificado por email, e relata **Concluída** ou **Falhou** com um motivo. ## Configurando a Integração Okta Para configurar a integração, identifique seu domínio do Okta, crie um token de API dedicado e crie o conector na Aplicação de Gerenciamento Cato (CMA). ### Prerequisites - Uma conta de administrador Okta que pode criar tokens de API, desativar usuários e limpar suas sessões. Use a função de **Super Administrador** ou uma função de administrador personalizada com essas permissões: Ambas as permissões de ciclo de vida também estão incluídas em `okta.users.lifecycle.manage`. - `okta.users.read` - `okta.users.lifecycle.deactivate` para **Desativar Usuário** - `okta.users.lifecycle.clearSessions` para **Revogar Sessões de Login**, exibido como **Limpar sessões de usuários** no Console do Administrador Um token de API herda as permissões de sua conta de criação. A função **Administrador Somente-Leitura** usada para Atividades de Aplicativo é insuficiente. Use uma conta dedicada cujo ciclo de vida e permissões são geridos para esta integração. Desativar a conta também desativa seus tokens de API. ### Passo 1: Configurar a Integração no Okta Use a URL base da organização Okta, incluindo `https://`, como a **URL de Domínio Okta**. Exemplos incluem: - `https://companyname.okta.com` - `https://companyname.okta-emea.com` - `https://companyname.oktapreview.com` Não use uma URL do Console do Administrador contendo `-admin` ou anexe `/admin`. Se a sua organização usa um domínio personalizado para APIs Okta, use essa URL base. Para detalhes, veja [organizações Okta](https://developer.okta.com/docs/concepts/okta-organizations/). Crie um token de API SSWS separado para este conector em vez de reutilizar um token de Atividades de Aplicativo. Trate o token como uma senha. Não coloque-o no controle de versão, tickets ou chat. **Para configurar a integração no Okta:** 1. Identifique a URL base para a sua organização Okta. Copie e salve a **URL de Domínio Okta** para que possa ser inserida no CMA. 2. Faça login no Console do Administrador Okta com a conta dedicada. 3. Navegue até **Segurança > API**. 4. Selecione a guia **Tokens**. 5. Clique em **Criar token**. 6. Digite um nome descritivo, como `Cato Remediation Actions`. 7. Configure a restrição de zona de rede do token de acordo com a política de segurança da sua organização. Certifique-se de que a restrição permita que o serviço Cato conecte-se à sua organização Okta. 8. Clique em **Criar token**. 9. Copie e salve o **Token de API** para que ele possa ser inserido no CMA. Para o procedimento Okta, veja [Gerenciar tokens de API Okta](https://help.okta.com/en-us/content/topics/security/api.htm). Os tokens SSWS permanecem válidos por 30 dias a partir da criação ou último uso. Cada solicitação de API bem-sucedida atualiza o período de inatividade de 30 dias. A rotação de token é manual. **Para rodar o token de API:** 1. Crie um token de substituição usando o procedimento acima. 2. Atualize o conector no CMA com o token de substituição. 3. Confirme que o Status da Conexão está **Conectado**. 4. Revogue o token antigo no Okta. ### 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 criar o conector da 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 a primeira etapa. - **Aplicação SaaS:** Okta - **Nome:** Digite um nome para a integração - **Descrição:** Opcionalmente, digite uma descrição - **URL do Domínio Okta:** Digite a URL base identificada na Etapa 1 - **Token da API:** Cole o valor do token somente, sem o prefixo `SSWS` 7. Clique em **Salvar**. O aplicativo está visível na tabela de **Aplicativos Integrados** com status de **Conectado**. ## Limitações de Serviços - **A desativação é destrutiva:** O Okta desliga o usuário de todos os aplicativos atribuídos. Isso pode destruir dados de usuários, como email ou arquivos. O Okta documenta esta ação como não recuperável. - **Revogação de Sessão:** O Okta documenta que **Revogar Sessões de Login** não limpa sessões criadas para aplicativos web ou nativos. - **Correspondência exata de e-mail:** O e-mail solicitado deve corresponder exatamente ao login ou e-mail principal armazenado no Okta, incluindo a diferença entre maiúsculas e minúsculas. Caso contrário, a ação relata **Falha** com a razão **Nenhum usuário Okta corresponde ao e-mail solicitado**. - **Proprietário do Token:** **Desativar Usuário** e **Revogar Sessões de Login** não podem ter como alvo a conta que possui o token da API do conector. Desativar essa conta invalida o token. - **Status da Conexão:** **Conectado** apenas confirma que o token pode listar usuários. Permissões ausentes para desativação ou limpeza de sessões são relatadas como resultado **Falha** quando uma ação é executada. - **Ciclo de vida do token:** Um token SSWS se torna inválido se a conta que o criou for desativada. Ele expira após 30 dias sem uso.