Box : Configuration de l'Intégration des Actions de Remédiation

Prev Next

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:

  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.

Avantages de la connexion de Box

Le connecteur d'actions de remédiation Box permet à Cato de prendre des mesures de réponse sur les utilisateurs Box lors d'une investigation. Il utilise une application dédiée de la plateforme Box avec accès en écriture, sans affecter les autres connecteurs Box, tels que les Activités de l'Application et Découverte des Données.

  • Désactiver un utilisateur : Trouve l'utilisateur Box géré dont l'identifiant correspond à l'email requis, en ignorant la casse, et définit le statut du compte sur Inactif. L'utilisateur ne peut plus se connecter et est déconnecté de toutes les applications Box. Les dossiers et fichiers de l'utilisateur sont cachés aux collaborateurs jusqu'à ce que le compte soit réactivé. Les collaborateurs conservent leurs niveaux d'autorisation. Le contenu, les groupes et le siège de l'utilisateur sont conservés. Si l'utilisateur est déjà inactif, l'action signale cette condition et réussit.

  • Révoquer les sessions de connexion : Trouve l'utilisateur géré de la même manière et demande à Box de terminer toutes les sessions actives. Le compte reste actif et le mot de passe est inchangé, donc l'utilisateur peut se reconnecter. Box exécute la terminaison de session comme tâche de fond. L'action réussit lorsque Box accepte la tâche, et le résultat de la tâche apparaît dans les événements admin Box. L'action s'exécute également pour un utilisateur inactif.

Chaque action fonctionne sur un utilisateur, identifié par email, et signale Terminé ou Échoué avec une raison. Les raisons d'échec incluent un email manquant, aucun utilisateur correspondant, ou une erreur Box pendant la recherche ou la demande d'action. Lorsque Box renvoie un code d'erreur et un message, ils apparaissent dans le résultat.

Configuration de l'Intégration Box

Pour configurer l'intégration, créez et autorisez une application dédiée de la plateforme Box, puis créez le connecteur dans l'application de gestion Cato.

Pré-requis

  • Une licence Box Enterprise
  • Un Box Admin qui peut créer une application de plateforme et l'approuver pour l'entreprise
  • Authentification à deux facteurs activée sur le compte Box qui crée l'application. Sans cela, la Clé secrète du client est indisponible.

La portée Gérer les utilisateurs offre de larges autorisations sur les utilisateurs gérés, incluant la modification des connexions, la réinitialisation des mots de passe, le changement de rôles et la gestion de leur contenu d'entreprise. Utilisez une Application de Plateforme dédiée pour ce connecteur. Ne pas ajouter cette portée à l'application utilisée par d'autres connecteurs Box.

Étape 1 : Configurer l'Intégration dans Box

Créer une Application de Plateforme dédiée avec accès d'entreprise et permission de gérer les utilisateurs.

Pour configurer l'intégration dans Box :

  1. Connectez-vous à la Console de Développeur Box à https://<your_tenant>.app.box.com/developers/console.
  2. Créer une Application de Plateforme.
  3. Choisir Application Personnalisée et entrer un nom. Sélectionnez Intégration comme objectif et Sécurité & Conformité comme catégorie.
  4. Sélectionnez Authentification Serveur (Client Credentials Grant) puis cliquez sur Créer Application.
  5. Sur la page Paramètres Généraux, copiez et enregistrez l'ID Entreprise pour l'ajouter dans le CMA. Entrez cette valeur comme ID de Sujet Box.
  6. Sur la page Configuration, cliquez sur Récupérer Clé Secrète du Client. Copiez et enregistrez l'ID client et la clé secrète client pour qu'ils puissent être saisis dans le CMA.
  7. Sur la page Configuration, définissez Niveau d'Accès de l'Application sur Accès Application + Entreprise. Ce paramètre offre un accès aux utilisateurs à travers l'entreprise, plutôt qu'uniquement aux utilisateurs de l'application elle-même.
  8. Sous Portées d'Application, sélectionnez Gérer les utilisateurs, puis cliquez sur Enregistrer les Modifications. Cette portée est requise pour rechercher des utilisateurs par email, désactiver des utilisateurs et terminer les sessions de connexion.
  9. Allez à la page Autorisation et cliquez sur Examiner et Soumettre.
  10. Demandez à l'Admin Box d'approuver l'application pour l'entreprise en utilisant la notification par e-mail.

Stockez le Secret du Client en toute sécurité. Ne le placez pas dans le contrôle source, les tickets ou le chat. Si vous modifiez les portées de l'application, l'Admin Box doit réautoriser l'application depuis Admin Console > Platform > Applications de la Plateforme.

É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 Box, sélectionnez authentification OAuth2 pour Box et entrez les informations d'identification de l'étape 1.

Pour créer le Connecteur API dans le CMA :

  1. Dans le menu de navigation, cliquez sur Ressources > Intégrations
  2. Cliquez sur l'onglet Intégrations Configurées.
  3. Cliquez sur Nouveau<\/strong>. Le panneau Nouvelle Intégration s'ouvre.
  4. Sélectionnez l'Application SaaS que vous souhaitez ajouter.
  5. Dans le menu déroulant Capacité, sélectionnez Actions de remédiation.
  6. Ajoutez les détails créés au cours de l'étape un.
    • Application SaaS : Box
    • Sélectionnez authentification OAuth2 pour Box
    • ID Client : Entrez l'ID Client de l'étape 1
    • Secret du Client : Entrez le Secret du Client de l'étape 1
    • ID de la Box (ID de l'Entreprise) : Entrez l'ID de l'Entreprise de l'étape 1
    • Entrez un nom pour l'intégration
    • (Optionnel) Entrez une description
  7. Cliquez sur Sauvegarder.

L'Application est visible dans le tableau Applications Intégrées avec un statut Connecté.

Limites connues

  • Utilisateurs gérés uniquement : Les deux actions recherchent uniquement les utilisateurs gérés dans votre entreprise Box. Les collaborateurs externes ne sont pas trouvés, même si leur identifiant correspond à l'e-mail demandé. L'action indique qu'aucun utilisateur ne correspond.

  • Compte de service du connecteur : Le compte propre au connecteur ne peut pas être ciblé. Les comptes de service ne sont pas retournés par les recherches d'utilisateurs Box. Une action visant à ce compte indique qu'aucun utilisateur ne correspond.

  • Connexions ultérieures : Les connexions ultérieures ne sont pas bloquées par Révoquer les Sessions de Connexion. Le compte reste actif et le mot de passe est inchangé. L'utilisateur, ou toute personne possédant ses identifiants, peut se re-connecter. Utilisez Désactiver l'utilisateur pour bloquer l'accès.

  • Résultats de la fin de session : Le nombre de sessions terminées n'est pas signalé par Révoquer les Sessions de Connexion. Box accepte la demande avant que le travail d'arrière-plan ne soit exécuté, sans la vérifier par rapport aux sessions utilisateur. Vérifiez les événements admin Box pour le résultat du travail.

  • Accès au contenu des collaborateurs : Les dossiers et les fichiers de l'utilisateur sont masqués par Désactiver Utilisateur jusqu'à ce que le compte soit réactivé. Le contenu reste dans Box. Pour restaurer la connexion et l'accès des collaborateurs, définissez le statut de l'utilisateur sur Actif dans la Console d'administration Box.

  • Statut de la connexion : Seuls la connexion et la recherche d'utilisateur sont vérifiés par le test de connexion. Connecté confirme que Cato peut s'authentifier avec les identifiants de l'application et lister les utilisateurs gérés par l'entreprise. Un manque de permission pour désactiver les utilisateurs ou terminer les sessions est signalé lors de l'exécution d'une action, comme un résultat Échoué avec l'erreur Box.

  • Authentification : Seul le flux des identifiants client OAuth 2.0 est pris en charge.