Vue d’ensemble
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.
Avantages de la connexion à Okta
Le connecteur des actions de remédiation Okta permet à Cato de prendre des mesures sur les comptes utilisateurs Okta lors d'une investigation. Il utilise un jeton API séparé, sans affecter les autres connecteurs Okta, tels que les Activités d'Applications.
Désactiver l'utilisateur : Trouve l'utilisateur dont le login Okta ou l'email primaire correspond à l'email demandé et désactive le compte. Le statut du compte devient Désapprovisionné. Si le compte est déjà désactivé, l'action signale cette condition et réussit.
Révoquer les sessions de connexion : Trouve l'utilisateur dont le login Okta ou l'email primaire correspond à l'email demandé et efface toutes les sessions Okta actives. Il révoque les identifiants d'accès et les jetons de rafraîchissement OpenID Connect et OAuth délivrés à l'utilisateur. Il efface également les appareils d'authentification multifactorielle (MFA) mémorisés, incitant l'utilisateur à effectuer une authentification MFA à la prochaine connexion sur chaque appareil. Le compte n'est pas désactivé. L'action fonctionne pour n'importe quel statut d'utilisateur, y compris pour les utilisateurs désactivés.
Chaque action est exécutée sur un utilisateur, identifié par email, et signale Terminé ou Échoué avec une raison.
Configurer l'intégration Okta
Pour configurer l'intégration, identifiez votre domaine Okta, créez un jeton API dédié, et créez le connecteur dans l'Application de gestion Cato (CMA).
Pré-requis
Un compte administrateur Okta qui peut créer des jetons API, désactiver des utilisateurs et effacer leurs sessions. Utilisez le rôle Super Administrateur ou un rôle d'administrateur personnalisé avec ces autorisations :
okta.users.readokta.users.lifecycle.deactivatepour Désactiver l'utilisateurokta.users.lifecycle.clearSessionspour Révoquer les sessions de connexion, affiché comme Effacer les sessions des utilisateurs dans la console d'administration
Les deux autorisations de cycle de vie sont également incluses dans
okta.users.lifecycle.manage.
Un token d’API hérite des autorisations de son compte créateur. Le rôle Administrateur en lecture seule utilisé pour les Activités des Applications est insuffisant.
Utilisez un compte dédié dont le cycle de vie et les autorisations sont gérés pour cette intégration. Désactiver le compte désactive également ses tokens API.
Étape 1 : Configurer l’Intégration dans Okta
Utilisez l’URL de base de votre organisation Okta, y compris https://, comme URL du domaine Okta. Exemples incluent :
https://companyname.okta.comhttps://companyname.okta-emea.comhttps://companyname.oktapreview.com
N’utilisez pas une URL de la console d’administration contenant -admin ou en ajoutant /admin. Si votre organisation utilise un domaine personnalisé pour les API Okta, utilisez cette URL de base. Pour plus de détails, voir organisations Okta.
Créez un token API SSWS distinct pour ce connecteur au lieu de réutiliser un token des Activités des Applications. Traitez le token comme un mot de passe. Ne le placez pas dans le contrôle source, les tickets ou le chat.
Pour configurer l'intégration dans Okta :
Identifiez l'URL de base pour votre organisation Okta. Copiez et enregistrez l’URL du domaine Okta pour pouvoir le saisir dans le CMA.
Connectez-vous à la console d'administration Okta avec le compte dédié.
Accédez à Sécurité > API.
Sélectionnez l'onglet Tokens.
Cliquez sur Créer un token.
Entrez un nom descriptif, tel que
Actions de Remédiation Cato.Configurez la restriction de zone réseau du token selon la politique de sécurité de votre organisation. Assurez-vous que la restriction permet au service Cato de se connecter à votre organisation Okta.
Cliquez sur Créer un token.
Copiez et enregistrez le Token API pour pouvoir le saisir dans le CMA. Pour la procédure Okta, voir Gérer les tokens API Okta.
Les tokens SSWS restent valides 30 jours après leur création ou leur dernière utilisation. Chaque requête API réussie rafraîchit la période d'inactivité de 30 jours. La rotation du token est manuelle.
Pour renouveler le jeton API :
Créez un jeton de remplacement en utilisant la procédure ci-dessus.
Mettez à jour le connecteur dans le CMA avec le jeton de remplacement.
Confirmez que son statut de connexion est Connecté.
Révoquez l'ancien token dans Okta.
Étape 2 : Créer le connecteur API dans la CMA
Une fois que vous avez configuré une intégration avec l'application requise, ajoutez les détails dans le CMA.
Pour créer le connecteur d'API dans le CMA :
Dans le menu de navigation, cliquez sur Ressources > Intégrations
Cliquez sur l'onglet Intégrations Activées.
Cliquez sur Nouveau. Le panneau Nouvelle Intégration s'ouvre.
Sélectionnez l'Application SaaS que vous souhaitez ajouter.
Dans le menu déroulant Capacité, sélectionnez Actions de Remédiation.
Ajoutez les détails créés au cours de l'étape un.
Application SaaS : Okta
Nom : Entrez un nom pour l'intégration
Description : Facultativement, entrez une description
URL du Domaine Okta : Entrez l'URL de base identifiée à l'Étape 1
Token API : Collez uniquement la valeur du token, sans le préfixe
SSWS
Cliquez sur Sauvegarder.
L'Application est visible dans le tableau Applications Intégrées avec un statut Connecté.
Limites connues
La désactivation est destructive : Okta désactive l'utilisateur de toutes les applications assignées. Cela peut détruire les données utilisateur, telles que les emails ou fichiers. Okta documente cette action comme non récupérable.
Révocation de session : Okta précise que Révoquer les Sessions de Connexion n'efface pas les sessions créées pour les applications web ou natives.
Correspondance exacte de l'email : L'email demandé doit correspondre exactement à l'email de connexion ou principal stocké sur Okta, y compris la casse. Sinon, l'action rapporte Échoué avec la raison Aucun utilisateur Okta ne correspond à l'email demandé.
Propriétaire du token : Désactiver l'utilisateur et Révoquer les Sessions de Connexion ne peuvent cibler le compte qui possède le token API du connecteur. Désactiver ce compte rend le token invalide.
Statut de la connexion : Connecté confirme uniquement que le token peut lister les utilisateurs. Les autorisations de désactivation ou d'effacement des sessions manquantes sont signalées comme un résultat Échoué lorsqu'une action est exécutée.
Cycle de vie du token : Un token SSWS devient invalide si son compte créateur est désactivé. Il expire après 30 jours sans utilisation.