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.
To configure the Remediation Actions integration, you need to:
Configure the required settings in the SaaS application
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:
okta.users.readokta.users.lifecycle.deactivatepara Desativar Usuáriookta.users.lifecycle.clearSessionspara Revogar Sessões de Login, exibido como Limpar sessões de usuários no Console do Administrador
Ambas as permissões de ciclo de vida também estão incluídas em
okta.users.lifecycle.manage.
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.comhttps://companyname.okta-emea.comhttps://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.
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:
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.
Faça login no Console do Administrador Okta com a conta dedicada.
Navegue até Segurança > API.
Selecione a guia Tokens.
Clique em Criar token.
Digite um nome descritivo, como
Cato Remediation Actions.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.
Clique em Criar token.
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.
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:
Crie um token de substituição usando o procedimento acima.
Atualize o conector no CMA com o token de substituição.
Confirme que o Status da Conexão está Conectado.
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:
No menu de navegação, clique em Recursos > Integrações
Clique na aba Integrações Ativas.
Clique em Novo. O painel de Nova Integração é aberto.
Selecione a Aplicação SaaS que deseja adicionar.
No menu suspenso Capacidade, selecione Ações de Remediação.
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
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.