Cet article explique comment configurer le connecteur Microsoft OneDrive pour la politique App & Data API Protection pour votre compte et créer une règle OneDrive pour la Politique de Protection des Données
La politique App & Protection des données API nécessite une licence distincte de Cato. Veuillez contacter votre représentant Cato ou le revendeur officiel pour plus d'informations.
Remarque :
Veuillez contacter SaaSecAPI@catonetworks.com ou votre revendeur officiel Cato pour plus d'informations sur l'utilisation de la Politique de Protection de l'API des Applications & Données.
Vue d'ensemble des Connecteurs Microsoft
Créez les connecteurs pour les applications Microsoft 365 et OneDrive SaaS.
Chaque application Microsoft OneDrive et locataire Azure (selon l'application 365) est soumise à la limitation de débit de Microsoft. Pour plus d'informations, consultez la documentation Microsoft.
Pré-requis
Le connecteur Microsoft 365 nécessite un administrateur avec le rôle d'administrateur global pour donner des autorisations à Protection des données API
Autorisations requises pour les connecteurs API pour OneDrive
Pour permettre à l'API de protection des données d'analyser les actifs et le contenu des fichiers et dossiers OneDrive, le connecteur donne à Cato les autorisations et actions suivantes avec l'application OneDrive :
Autoriser l'accès à l'application en utilisant Oauth2
Recevoir un token de l'application pour établir et maintenir une connexion sécurisée
Se connecter aux API Microsoft, récupérer des données et analyser des fichiers conformément à la politique App & Data API Protection, y compris :
Lire les fichiers dans toutes les collections de sites
Se connecter et lire les profils complets des utilisateurs
Écrire des fichiers dans toutes les collections sites (bientôt disponible)
Travailler avec les connecteurs API Microsoft OneDrive
Cette section explique comment créer des connecteurs API pour Microsoft 365 et OneDrive, et les connecter à votre compte Cato.
Comprendre les connecteurs API pour Microsoft OneDrive
Pour permettre à l'API de protection des données d'analyser les actifs et le contenu pour Microsoft OneDrive, vous devez d'abord configurer le connecteur Microsoft 365 comme application parente pour donner des autorisations de lecture au connecteur OneDrive. L'application parente dispose uniquement des autorisations nécessaires pour gérer les connecteurs Microsoft. Ensuite, si nécessaire, vous pouvez créer un connecteur Microsoft 365 distinct pour chaque locataire Azure.
Étape 1 : Créer le Connecteur Microsoft 365
Utilisez l'Application de gestion Cato pour créer le connecteur d'application SaaS Microsoft 365 pour le locataire Azure pour l'application Microsoft OneDrive que vous analysez avec l'API de protection des données. Vous devez disposer des identifiants corrects pour vous authentifier à l'application Microsoft OneDrive pour l'ajouter à votre compte Cato.
Avant de pouvoir créer et configurer les paramètres du connecteur, vous devez d'abord activer l'API de protection des données pour votre compte.
Tout d’abord, configurez l’intégration MS Tenant en tant que connecteur principal. Ce connecteur peut être utilisé pour toutes les intégrations Microsoft. Si vous avez déjà créé le connecteur principal, passez à l'étape 2.

Pour créer l'intégration du locataire MS :
Dans le menu de navigation, sélectionnez Ressources > Intégrations et cliquez sur l’onglet Applications intégrées.
Cliquez sur Ajouter un nouveau site. Le panneau Nouveau connecteur s'ouvre.
Dans le panneau Nouveau connecteur, sélectionnez l'application Locataire MS (Configurer un nouveau locataire MS).

Entrez le nom du connecteur.
Cliquez sur Autoriser et Enregistrer.
Un nouvel onglet de navigateur s'ouvre dans l'application Microsoft 365.
Dans le nouvel onglet de navigateur, authentifiez-vous à l'application Microsoft 365 :
Sélectionnez le compte Microsoft pour l'application Microsoft 365.
Sinon, une erreur d'authentification Microsoft peut survenir.
Entrez le mot de passe de l'application et l'approuvez.
Acceptez les autorisations pour permettre à Cato d'accéder à l'application Microsoft 365.
L'écran indique que vous avez correctement appliqué les autorisations pour l'application.

Vous pouvez fermer l'onglet de navigateur et revenir à l'Application de gestion Cato.
L'application SaaS Microsoft 365 est ajoutée à l'onglet Applications intégrées.
Étape 2 : Créer le Connecteur Microsoft OneDrive
Le connecteur Microsoft OneDrive permet au moteur Data Protection API d'analyser les fichiers pour le contenu que vous définissez dans la politique de protection des données.
Remarque :
Lorsque vous créez un connecteur API pour une application Microsoft 365, le connecteur crée un certificat d'authentification valable pour 3 mois, et renouvelle le certificat 7 jours avant expiration.
Pour créer le connecteur pour Microsoft OneDrive :
Dans le menu de navigation, sélectionnez Ressources > Intégrations et cliquez sur l’onglet Applications intégrées.
Cliquez sur New. Le panneau Nouveau Connecteur s'ouvre.
Créez une nouvelle Application SaaS OneDrive, pour le parent connecteur que vous avez créé dans la section précédente.
Cliquez sur Autoriser et Enregistrer.
Dans un nouvel onglet de navigateur, authentifiez-vous à l'application OneDrive.
Sélectionnez le compte Microsoft pour l'application OneDrive et connectez-vous.
Entrez le mot de passe de l'application et l'approuvez.
Accepter les autorisations pour que Cato accède à l'application OneDrive.

L'écran indique que vous avez correctement appliqué les autorisations pour l'application.
Vous pouvez fermer l'onglet du navigateur et revenir à l'application de gestion Cato.
Il peut falloir plusieurs secondes pour que Microsoft Azure traite la demande, donc si vous recevez une erreur, rafraîchissez le navigateur.
L'application SaaS OneDrive est ajoutée à l'onglet Applications Intégrées.
Comprendre l'état du connecteur
La colonne Statut sur l'écran des Paramètres des connecteurs montre l'état de la connexion entre l'application Microsoft et votre compte Cato. Voici les explications des états :
Connecté - Votre compte est connecté à l'application et fonctionne correctement
Avertissement de connexion - Certains utilisateurs dans le locataire Azure ne sont pas configurés correctement pour supporter Protection des données API (par exemple, pas d'adresse e-mail définie pour l'utilisateur). Veuillez ouvrir un ticket auprès du Support.
Erreur de connexion - Problème de connectivité ou d'autorisations, ou limitation de débit (limitation de Microsoft) avec le connecteur Microsoft. Veuillez ouvrir un ticket auprès du Support.
Consentement de l'Utilisateur en Attente - Le connecteur OneDrive est créé dans l'écran Paramètres de Connexion, mais vous n'avez pas terminé le processus dans le compte OneDrive pour l'autoriser à se connecter à Cato.
Ajout de règles OneDrive à la politique de protection des données
Cette section explique comment utiliser la Politique de Protection des Données pour surveiller et gérer les actions que vos utilisateurs effectuent avec les fichiers OneDrive. Par exemple, partager des fichiers, créer de nouveaux fichiers, téléverser, etc.
Pour en savoir plus sur les profils de contenu DLP, voir Créer des profils de contenu DLP.
Comprendre les actions OneDrive
Lorsque vous créez une règle de Protection des données, vous pouvez définir différentes actions pour surveiller ou remédier aux violations de la politique lorsque la règle correspond. Chaque action génère automatiquement un événement, et vous pouvez également choisir de recevoir une notification par email. Pour plus d'informations sur les événements de l'API de Protection des Données, voir ci-dessous Analyser les événements de l'API de Protection des Données.
Voici les actions que vous pouvez définir pour que le moteur de Protection des données effectue lorsque la règle correspond :
Surveiller - Génère un événement pour vous permettre de surveiller le trafic qui correspond à la règle.
Supprimer les Partages - Lorsque l'utilisateur tente de partager un fichier, le moteur API de Protection des données supprime l'autorisation de partage non autorisée, et l'utilisateur recevant un lien vers le fichier partagé n'aura pas les permissions pour accéder au fichier.
Quarantaine - Lorsque l'utilisateur tente de téléverser un fichier, le moteur API de Protection des données le déplace vers un dossier de quarantaine et les utilisateurs ne peuvent plus y accéder. L'admin OneDrive peut accéder au fichier dans le dossier de quarantaine. Pour des informations sur la configuration des dossiers de quarantaine, voir préparation à la mise en quarantaine des fichiers.
Préparation à la quarantaine des fichiers
Configurez des dossiers de quarantaine pour les règles de Protection des Données et Prévention des Menaces, et définissez l'administrateur OneDrive avec les autorisations pour accéder aux dossiers. Vous pouvez configurer des dossiers de quarantaine pour chaque administrateur OneDrive pour le locataire. Lorsque vous configurez les dossiers, vous pouvez ensuite créer des règles avec l'action Mettre en quarantaine, et définir le dossier dans lequel le fichier est déplacé.

Pour configurer des dossiers de quarantaine pour un administrateur OneDrive :
Depuis le volet de navigation, sélectionnez Sécurité > App & Protection des données API et sélectionnez l'onglet Paramètres.
Cliquez sur New. Le panneau Dossier de mise en quarantaine s'ouvre.

Sélectionnez le connecteur d'application OneDrive.
Sélectionnez l'administrateur OneDrive pour avoir accès à ces dossiers de quarantaine.
Cliquez sur Sauvegarder.
Un dossier de Protection des Données et un dossier de Prévention des Menaces sont créés pour l'administrateur, et peuvent être configurés dans les règles avec l'action Mettre en quarantaine. Les dossiers sont nommés avec l'adresse e-mail de l'administrateur, et situés dans les répertoires OneDrive suivants :
Dossier de Protection des Données : Cato_Qarantine/Cato_Qarantine_DataProtection
Dossier de Prévention des Menaces : Cato_Qarantine/Cato_Qarantine_ThreatPrevention
Configurer les règles OneDrive
Utilisez la page de Protection des données pour ajouter les règles d'application SaaS dans votre politique de Protection des données.
Créez une règle de protection des données pour définir le trafic qui est analysé par l'API de protection des données. Créez des règles distinctes pour chaque connecteur d'application SaaS, puis définissez les critères déterminant le trafic qui est analysé.
Pour plus d'informations sur les paramètres de règle OneDrive, voir ci-dessous comprendre les règles OneDrive.

Pour créer une nouvelle règle de Protection des données pour l'application OneDrive :
Dans le volet de navigation, sélectionnez Sécurité > App & Protection de l'API des Données et sélectionnez ou développez Protection des Données.
Cliquez sur New. Le panneau Nouvelle règle s'ouvre.
Dans Connecteur d'application, sélectionnez l'application OneDrive.
Dans la section Général, entrez les paramètres pour la règle.
Dans Propriétaire, sélectionnez un ou plusieurs propriétaires de fichiers OneDrive (valeur par défaut : N'importe lequel).
Lorsque vous sélectionnez plusieurs propriétaires, il y a une relation OU entre eux.
Dans Options de partage, sélectionnez un ou plusieurs types de permissions de fichiers (valeur par défaut est N'importe lequel).
Lorsque vous sélectionnez plusieurs options, il existe une relation OU entre elles.
Dans Pièces jointes, définissez les critères pour spécifier les fichiers qui sont analysés (le paramètre par défaut est d'analyser tous les fichiers).
Dans Profil de contenu, sélectionnez le Profil de Contenu DLP pour cette règle.
Sélectionnez une Action.
Pour l'action Mise en quarantaine, sélectionnez un Chemin du dossier de mise en quarantaine. Pour plus d'informations sur les dossiers de quarantaine, voir ci-dessus ???.
(Optionnel) Configurez les options de suivi pour générer Événements et Envoyer des Notifications.
Pour plus d'informations sur les notifications, voir l'article pertinent pour les Groupes d'Abonnement, Listes de Diffusion, et Intégrations d'Alerte dans la section Alertes.
Cliquez sur Sauvegarder. La règle est ajoutée à la Politique de Protection des données.
Comprendre les règles OneDrive
Cette section explique comment définir les paramètres des règles de Protection des données pour scanner le trafic OneDrive approprié. Chaque règle peut être définie selon les critères suivants :
Propriétaire - utilisateurs individuels ou types d'utilisateurs Azure qui sont les propriétaires des répertoires OneDrive pertinents (valeur par défaut : N'importe lequel)
Options de partage - Sélectionnez le type de permissions de partage de fichiers qui correspondent à cette règle (valeur par défaut est N'importe)
Par exemple, pour surveiller les fichiers partagés avec n'importe quel utilisateur externe, sélectionnez Lien externe.
Pièces jointes - Critères pour les pièces jointes qui sont analysées (valeur par défaut est toutes les pièces jointes)
Type de Fichier
Nom du fichier
Taille du fichier (la taille maximale du fichier est de 100 MB)
Profil de contenu - Profil de Protection contre la perte de Données qui définit l'inspection du contenu DLP (Sécurité > Profils DLP > Profils DLP > Profil de contenu)
Actions - Voir ci-dessus compréhension des actions OneDrive
Définir des fichiers ou des pièces jointes pour une règle
Vous pouvez définir des fichiers spécifiques (ou des pièces jointes) pour une règle et limiter le moteur API SaaS pour ne scanner que les fichiers spécifiés afin de voir s'ils correspondent au profil de contenu DLP.
Lorsque vous ajoutez plusieurs fichiers à une règle, sélectionnez la relation entre eux :
Satisfaire à l'une (OU) - Correspondez à l'un des types de fichiers dans la règle
Satisfaire à toutes (ET) - Correspondez à tous les types de fichiers dans la règle (sinon, la règle est ignorée)
Vous pouvez utiliser le paramètre du nom de fichier dans une règle pour définir le nom de fichier exact ou utiliser des jokers pour définir des mots-clés. Par exemple, vous pouvez définir le nom de fichier comme interne pour correspondre à tous les noms de fichiers qui contiennent le mot interne.
Travailler avec des règles de protection de données ordonnées
Le moteur API de Protection des Données inspecte les données séquentiellement et vérifie si elles correspondent à une règle. Si les données ne correspondent pas à une règle, alors elles ne sont pas inspectées. Les règles en haut de la base de règles ont une priorité plus élevée et elles sont appliquées avant les règles en bas de la base de règles. Chaque type d'application ou connecteur est uniquement appliqué aux données une seule fois.
Meilleures pratiques - Pour maximiser l'efficacité de votre base de règles, nous recommandons que pour chaque type de connecteur, les règles pour des utilisateurs spécifiques aient une priorité plus élevée que les règles qui s'appliquent à Tous les utilisateurs.
Par exemple, si les données correspondent à un connecteur dans la règle n°2, les données sont inspectées par le moteur API de Protection des Données. Le moteur ne continue pas à appliquer les règles #3 et au-delà pour le même connecteur. Cependant, les données pourraient correspondre à une règle de moindre priorité avec un connecteur différent.
Ajouter la protection contre les menaces au connecteur
Vous pouvez créer des règles de Protection contre les menaces pour le connecteur afin d'analyser les fichiers et les pièces jointes pour voir s'il y a des logiciels malveillants et des virus en utilisant les moteurs Anti-Malware et NG Anti-Malware qui sont activés pour votre compte. Le moteur API de Protection des données scanne le trafic du connecteur et applique l'action et les options de suivi que vous configurez pour la règle.
Ce sont les actions que vous pouvez définir pour que le moteur de Protection contre les menaces exécute lorsqu'une règle est correspondante :
Surveiller - Génère un événement pour vous permettre de surveiller le trafic qui correspond à la règle.
Supprimer les Partages - Lorsque l'utilisateur tente de partager un fichier, le moteur API de Protection des données supprime l'autorisation de partage non autorisée, et l'utilisateur recevant un lien vers le fichier partagé n'aura pas les permissions pour accéder au fichier.
Quarantaine - Lorsque l'utilisateur tente de téléverser un fichier, le moteur API de Protection des données le déplace vers un dossier de quarantaine et les utilisateurs ne peuvent plus y accéder. L'admin OneDrive peut accéder au fichier dans le dossier de quarantaine. Pour des informations sur la configuration des dossiers de quarantaine, voir préparation à la mise en quarantaine des fichiers.
Chaque action génère automatiquement un événement, et vous pouvez également choisir de recevoir une notification par e-mail. Pour plus d'informations sur les événements de l'API de Protection des Données, voir ci-dessous Analyser les événements de l'API de Protection des Données.
Lorsque vous créez une règle App & Data API Protection, les moteurs de protection anti-malware activés pour votre compte (Sécurité > Anti-Malware) effectuent des analyses de logiciels malveillants sur les fichiers envoyés pour cette application de connecteur.
La capture d'écran suivante montre une règle de protection contre les menaces pour le connecteur OneDrive qui analyse les fichiers envoyés par les utilisateurs internes ou les invités :

Créer une exception pour un fichier
Parfois, il y a un fichier bloqué par les moteurs API de Protection des données de Cato que vous savez être sûr, et vous devez l'autoriser dans le réseau. Les exceptions Anti-Malware de la politique de hachage de fichier s'appliquent également à la Protection API Application & Données. Pour plus d'informations sur l'ajout de fichiers à la politique de hachage de fichier, consultez Gestion des exceptions Anti-Malware.
Analyse des événements Data Protection API
La page Accueil > Événements affiche tous les événements de l'API de Protection des Données pour votre compte. Les outils de recherche puissants vous permettent d'approfondir et d'identifier les rares événements qui contiennent les données pertinentes dont vous avez besoin.
Les événements Data Protection API peuvent être identifiés par les champs suivants :
Type d'événement - Sécurité
Sous-Type - Protection des données API de sécurité SaaS et Anti-Malware API de sécurité SaaS
Vous pouvez en apprendre plus sur l'utilisation de la page des Événements ici.
Explication des champs des événements de l'API de Protection des Données
Nom de Champ | Nom d'affichage |
|---|---|
Collaborateurs | Adresses électroniques des utilisateurs ayant reçu le fichier |
Nom du connecteur | Nom pour le connecteur défini pour la règle |
Type de connecteur | Application SaaS définie pour ce connecteur |
Profil de Protection contre la Perte de Données (DLP) | Profil de contenu DLP ayant généré cet événement |
Nom de fichier | Nom du fichier joint |
Types de données correspondantes | Types de données dans le profil de contenu correspondant à la règle |
Propriétaire | Propriétaire du fichier |
Type de connecteur parent | Connecteur parent Microsoft 365 |
Règle | Nom de la règle dans la politique de Protection des données |
Gravité | Gravité définie pour la règle |
Portée du Partage | Options de partage pour le fichier OneDrive |