--- title: "Dépannage de la Sécurité AI pour les Applications" slug: "troubleshooting-ai-security-for-apps" updated: 2026-10-25T00:14:55Z published: 2026-10-25T00:14:55Z canonical: "knowledge.catonetworks.com/troubleshooting-ai-security-for-apps" --- > ## 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. # Dépannage de la Sécurité AI pour les Applications ## Aperçu Ce manuel couvre l'ensemble des problèmes de Sécurité AI pour Applications dans CMA, y compris les Gardiens qui n'inspectent pas ou n'activent pas le trafic agent/LLM, les intégrations Passerelle AI qui ne transmettent pas les Événements, les intégrations Agent géré qui échouent à se connecter ou à synchroniser, et les règles de Politique des Gardiens qui n'ont pas l'effet escompté. Les composants concernés couvrent les Gardiens de Sécurité AI (mode Proxy, API, et Passerelle AI), les règles de Politique des Gardiens et leurs Profils Moteur, les intégrations Passerelle AI, les Intégrations Agent géré et la licence de Sécurité AI pour Applications sous-jacente. Lorsque l'un de ces éléments échoue, les clients perdent la visibilité sur le Trafic agent/LLM et l'Activité agent géré, l'application de la Politique ne peut pas avoir lieu, et les objectifs de gouvernance et de conformité ne sont pas atteints. ## Symptômes - Un garde affiche zéro invocations dans CMA même si l'application connectée envoie activement du trafic. - Une règle de politique de déploiement des gardes est configurée mais ne correspond jamais, ou correspond de manière incohérente à des demandes similaires. - Une règle Bloquer ou Anonymiser & Bloquer est correspondante, mais la demande est uniquement surveillée, ou aucune action n'est visiblement appliquée. - Une intégration de passerelle AI (Portkey, LiteLLM ou Kong) est configurée, mais le trafic acheminé par la passerelle n'apparaît jamais pour inspection dans CMA. - Une intégration d'agent géré s'affiche comme déconnectée, échoue au test de connexion ou échoue lors de l'installation du script/de la pile CloudFormation. - Une intégration d'agent géré s'affiche comme active, mais aucune configuration ou session d'agent n'apparaît dans CMA. ## Causes possibles - La licence de sécurité AI pour les applications est expirée ou non activée. - Le basculement global de la politique de déploiement activée des gardes est désactivé dans CMA. - Le garde est créé mais ne reçoit pas réellement de trafic. L'application ou la passerelle n'est pas pointée vers le point final du garde (Mode Proxy/API) ou le garde-fou de la passerelle AI n'est pas inclus dans la configuration de la passerelle. - Une règle de politique d'interaction des gardes est désactivée, non publiée, ou scindée au mauvais profil de moteur, direction (Utilisateur, Assistant, Entrée de l'outil, Sortie de l'outil) ou action. - Un paramètre spécifique à la plateforme requis pour la visibilité de l'agent géré n'a pas été activé. - La latence de rafraîchissement de données attendue n'a pas encore été écoulée. - Le fournisseur LLM affecté, la plateforme d'agent ou le type de passerelle ne sont actuellement pas pris en charge par le garde ou l'intégration d'agent géré en question. ## Évaluation initiale Complétez ces vérifications avant un dépannage plus approfondi. La plupart des problèmes remontent à l'un de ces prérequis. ### Valider la licence de sécurité AI. Vérifiez que la licence des utilisateurs finaux de sécurité AI (couvre la sécurité AI pour les agents) est activée et qu'elle n'est pas expirée. Naviguez vers **CMA > Compte > Licences > Sécurité Premium** et confirmez que la licence est présente, active et dans sa période de validité. ![Image](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(220).png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A14%3A27Z&se=2026-11-22T15%3A14%3A27Z&sr=b&sp=r&sig=XGcv%2BUhB7HBg9ROPU9Rd8I6Qghrtkbfwg%2B1n%2Flr%2FlaI%3D){height="" width=""} Si la licence est absente, désactivée ou expirée, les fonctions de Sécurité AI pour les Applications, y compris la création des gardes, l'application de la politique d'interaction des gardes, les intégrations de passerelle AI, et les intégrations d'agent géré, ne fonctionneront pas quel que soit la configuration. Résolvez tous les problèmes de licence avant de continuer avec les étapes de ce document. ### Valider que la politique des gardes est activée. Naviguez vers **CMA > Sécurité AI > Politique de Déploiement des Gardes** et assurez-vous que le commutateur Politique DNS activée est coché. C'est une étape simple qui est facile à négliger, et aucune règle ne prendra effet tant qu'elle est désactivée. ![Image](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(243).png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A14%3A27Z&se=2026-11-22T15%3A14%3A27Z&sr=b&sp=r&sig=oNCyPyOYxNBD7BiWCho0sv7sjh996XxDRtqMX0p412o%3D) ### Valider le déploiement des gardes et le routage du trafic Un garde inspecte uniquement le trafic qu'il reçoit réellement. Avant de supposer un problème de politique ou de détection, confirmez que le garde est correctement dans le chemin du trafic. 1. Naviguez vers **Sécurité AI > Gardes** et confirmez que le garde affecté existe et est configuré avec le bon **Type** (Proxy, API ou Passerelle AI) pour le déploiement en question. 2. Générer une invite utilisateur à partir de l'agent local. Le nombre d'invocations affiché dans CMA devrait augmenter avec chaque invite. Si les invocations n'augmentent pas, cela indique une possible mauvaise configuration de l'application. ![Image](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(244).png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A14%3A27Z&se=2026-11-22T15%3A14%3A27Z&sr=b&sp=r&sig=3haTAUeQdBEE8kCA6dZtPflJcpckC3J1111nLNVAGIU%3D) 3. Ouvrez le garde affecté et naviguez vers l'onglet de déploiement. En fonction du type de garde, les valeurs spécifiques de cet onglet doivent être présentes dans la configuration de l'application : - Pour tous les types de gardes, confirmez que la clé API configurée dans l'application correspond à une clé active, non révoquée, affichée dans CMA. Vous pouvez régénérer la clé API dans CMA si nécessaire, cela invalide la clé précédente, alors mettez à jour l'application immédiatement après la régénération. ![Image](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(245).png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A14%3A27Z&se=2026-11-22T15%3A14%3A27Z&sr=b&sp=r&sig=QwoFuFdWC0ljc6sQsMXgAIW%2BDPwJY2zaQBxwNCj2%2F%2FE%3D) - Pour **Proxy et Gardes API**, confirmez que l'application pointe vers l'URL de point de terminaison du garde en modifiant le fichier de configuration de l'application (par exemple, **config.py**) et en ajoutant **GUARD_API_KEY**, **BASE_URL**, **MODEL_ID**, et lorsque le garde est de type proxy et que la clé LLM n'a pas été fournie dans CMA, **LLM_PROVIDER_API_KEY**. - Assurez-vous que tous les **en-têtes de requête** requis, en particulier ceux marqués d'un astérisque (*), sont inclus dans le code client de l'application (par exemple, **client.py**). Pour plus d'informations sur le déploiement des gardes, voir [Exemple: Implémentation de gardes pour un Chat Bot](https://knowledge.catonetworks.com/docs/example-implementing-guards){target=`_blank`} . - Pour un **Garde Passerelle AI**, confirmez que l'intégration de la passerelle correspondante (Portkey, LiteLLM ou Kong) est configurée pour acheminer le trafic via Cato. La clé API émise par Cato et la barrière de sécurité doivent être ajoutées à la propre configuration de la passerelle (par exemple, **config.yaml** pour LiteLLM). ### Valider la connexion d'intégration de l'agent géré Les intégrations d'agents gérés sont des connexions en lecture seule avec des plateformes d'agents tiers et utilisent un modèle différent de celui des gardes. Il n'y a pas d'inspection du trafic, uniquement l'inventaire et le sondage des sessions. 1. Naviguez vers **Sécurité AI > Intégrations > Plateforme Agent Géré** et confirmez que l'intégration pertinente (Amazon Bedrock, Amazon Quick, Microsoft Foundry, Copilot Studio ou Gemini Enterprise Agent Platform) affiche un statut **Actif** et que l'intégration a été entièrement configurée. 2. Pour **Amazon Bedrock** ou **Amazon Quick**, confirmer que la pile CloudFormation a terminé l'installation avec succès dans le bon compte AWS (ou, pour un déploiement multi-compte, dans le compte gestion d'AWS Organizations) et que toutes les [conditions préalables](https://knowledge.catonetworks.com/docs/configuring-amazon-bedrock) documentées d'AWS sont satisfaites. 3. Pour **Microsoft Foundry** ou **Copilot Studio**, confirmer que chaque étape de configuration a été complétée par le titulaire de rôle approprié et que les [prérequis](https://knowledge.catonetworks.com/docs/configuring-copilot-studio) documentés sont respectés : - Un administrateur Entra ID (Administrateur d'application, Administrateur d'application cloud ou Administrateur global) a accordé un consentement général au niveau du locataire à l'application Cato Networks AI Security Integration via le lien de consentement administrateur de Cato Networks. - Pour Foundry, un propriétaire d'abonnement ou un administrateur d'accès utilisateur a attribué le rôle d'utilisateur des services cognitifs à l'application Cato sur chaque abonnement contenant des ressources Foundry. - Pour Copilot Studio, un administrateur de la plateforme Power (ou administrateur global) a enregistré l'application Cato comme une **application de gestion** à l'aide du script d'enregistrement PowerShell dans Azure Cloud Shell, et a activé les **Sessions d'agent** pour chaque environnement non-développeur pertinent. - Un admin Cato a saisi le bon **ID Entra Microsoft ID Tenant** dans le CMA et a cliqué avec succès sur **Tester la connexion** avant de sauvegarder. Un ID de locataire non correspondant est une cause fréquente d'échecs de Test de Connexion. 4. Pour **Gemini Enterprise Agent Platform**, confirmer que le script de configuration Google Cloud a été exécuté dans le bon projet Google Cloud (exécutez `gcloud config set project PROJECT_ID` si nécessaire), que l'identité exécutant le script avait la permission d'activer les APIs et de créer des ressources IAM/Fédération d'identité de charge de travail, et que le token d'intégration n'avait pas expiré avant l'exécution du script. Si la connexion ne peut être vérifiée immédiatement après une exécution de script réussie, laissez plusieurs minutes pour que les changements IAM de Google Cloud se propagent avant de réessayer. 5. Confirmer le délai prévu pour l'actualisation des données avant de conclure qu'une intégration est défaillante : - Foundry et Copilot Studio récupèrent les données immédiatement à la connexion et ensuite toutes les heures. - L'activité Bedrock AgentCore dépend de la livraison par AWS des traces CloudWatch, ce qui peut prendre du temps après la première invocation de l'agent. ## Dépannage du Problème Les étapes pour résoudre les symptômes que les administrateurs ou les utilisateurs peuvent rencontrer sont répertoriées ci-dessous. Ces étapes visent à identifier les causes possibles des problèmes rencontrés. ### Dépannage d'un Garde Affichant Aucune Invocation Cela s'applique lorsque la page des Gardes (**AI Security > Guards**) affiche zéro invocation dans le CMA. 1. Confirmer que la licence AI Security for Apps est valide et que des invites utilisateur ont été générées depuis l'application concernée. 2. Pour les gardes proxy, confirmez que le fournisseur AI est pris en charge par Cato comme documenté dans [Travailler avec les Gardes de Sécurité AI](https://knowledge.catonetworks.com/docs/working-with-ai-security-guards){target=`_blank`}. 3. Naviguez vers **Accueil > Événements**, filtrez par **Type d'événement = Sécurité AI** et confirmez si des événements liés aux gardes sont générés. Si aucun n'arrive, assurez-vous que le garde a été déployé dans la configuration de l'application, comme expliqué dans [Valider le Déploiement du Garde et le Routage du Trafic](/v1/docs/troubleshooting-ai-security-for-apps#validate-guard-deployment-and-traffic-routing). ![Image](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(246).png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A14%3A27Z&se=2026-11-22T15%3A14%3A27Z&sr=b&sp=r&sig=0HVFezrjU%2F%2B0k695dvPZSNdkzY7sHCP%2BMHGmsG3RXzE%3D) 4. Vérifiez la connectivité de l'API Sécurité AI en exécutant **curl -v https://api.aisec.catonetworks.com** via CLI. La sortie doit montrer la résolution FQDN, une poignée de main TLS réussie et une réponse HTTP (généralement HTTP 404). 5. Pour confirmer qu'un garde spécifique est joignable et réactif, vous pouvez exécuter une commande curl en utilisant l'exemple de requête (inclure une clé de garde valide) depuis **Sécurité AI > Gardes > Déploiement**. Une réponse réussie doit inclure la règle de politique de garde correspondante et l'action qui serait appliquée. ![Image](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(247).png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A14%3A27Z&se=2026-11-22T15%3A14%3A27Z&sr=b&sp=r&sig=IDs41WkunTwwcusOPGJtFbz2pwKktTvc4J%2FQLfi5WDc%3D) 6. Si le garde est correctement configuré sur l'application, le garde est accessible via curl et aucun événement CMA n'est généré, escaladez vers le Support Cato avec le type de garde/configuration (Proxy, API, ou Passerelle AI), détails de l'application et fichiers de configuration (rediger les clés API) ### Résolution des problèmes des règles de politique de garde ne prenant pas effet Cela s'applique lorsque la page des gardes montre des invocations, mais les règles de politique des gardes ne prennent pas l'action configurée. 1. Naviguez vers **Sécurité AI > Politique des Gardes**, confirmez que **Politique des Gardes Activée** est coché et que la règle affectée est publiée. 2. Confirmez que le **Profil du Moteur** attaché à la règle inclut effectivement le détecteur attendu pour capturer le contenu en question. Vous pouvez utiliser le [Terrain de Jeu du Moteur](https://knowledge.catonetworks.com/v1/docs/testing-engine-profiles-in-the-playground){target=`_blank`} pour valider que le contenu du prompt déclenche le détecteur dans le profil du moteur avant de poursuivre le dépannage. 3. Confirmez que la **Direction** de la règle correspond à l'endroit où le contenu apparaît réellement. Un détecteur ciblant la Sortie de l'Outil n'évaluera pas un prompt en direction de l'Utilisateur, et vice versa. 4. Confirmez que l'**Action** configurée sur la règle est l'action attendue. Une règle configurée pour **Anonymiser & Bloquer** ou **Anonymiser et Surveiller** appliquera une action en fonction du type de contenu détecté dans le prompt, comme expliqué dans [Action Inattendue Appliquée par la Politique](https://knowledge.catonetworks.com/docs/troubleshooting-ai-security-for-users#:~:text=Unexpected%20Action%20Applied%20by%20the%20Policy){target=`_blank`} . 5. Si plusieurs règles peuvent s'appliquer au même événement, confirmez quelle règle a réellement été exécutée en examinant le détail de l'événement. Les règles sont évaluées indépendamment et ne dépendent pas de l'ordre. Si plus d'une règle est déclenchée, l'action la plus stricte est appliquée. Une action d'événement menée moins strictement que prévu signifie généralement que la portée de la règle plus stricte, le profil de moteur ou la direction n'a pas réellement correspond à cet événement. 6. Si la règle est activée, correctement portée et le contenu doit correspondre, mais que l'action attendue n'est toujours pas appliquée, escaladez vers le support Cato avec l'ID d'événement, une capture d'écran de la règle (Profil du moteur, Direction, Action), et la Garde ou l'intégration par laquelle le trafic a été reçu. ### Dépannage des configurations d'agent ou des sessions manquantes Ceci s'applique lorsque les configurations d'agent géré attendues ou les sessions d'agent sont manquantes ou incomplètes dans le CMA. 1. Confirmez que l'intégration elle-même apparaît comme active, voir [Valider la connexion d'intégration de l'agent géré](/v1/docs/troubleshooting-ai-security-for-apps#validate-managed-agent-integration-connection) avant de dépanner les données manquantes à l'intérieur. 2. Permettez la cadence normale de rafraîchissement de la plateforme : au moins un cycle horaire pour Microsoft Foundry et Copilot Studio, et jusqu’au temps nécessaire pour qu’AWS génère et délivre les traces CloudWatch pour Bedrock AgentCore. 3. Validez que Cato supporte la visibilité des sessions d'agents dans le CMA pour l'application gérée affectée, comme documenté dans [Travailler avec les agents gérés](https://knowledge.catonetworks.com/docs/working-with-managed-agents){target=`_blank`} . 4. Pour **Amazon Bedrock AgentCore**, confirmez que la **Recherche de transactions CloudWatch** est activée (AWS Console > Application Signals (APM) > Recherche de transactions, avec ingestion des enregistrements comme des journaux structurés). Sans cela, Cato peut montrer des agents AgentCore dans l'inventaire mais jamais leur activité. 5. Pour **Copilot Studio**, confirmez que les **Sessions d'agents** sont activées pour l'environnement spécifique auquel l'agent manquant appartient (**Centre d'administration de la plate-forme de puissance > Gérer > Environnements > [environnement] > Paramètres > Produit > Fonctionnalités > Agents Copilot Studio**), et confirmez que l'environnement n'est pas un environnement développeur, qui n'est pas pris en charge pour ce paramètre. 6. Pour **Microsoft Foundry**, confirmez que l'abonnement spécifique qui contient la ressource Foundry manquante a le rôle d'utilisateur des services cognitifs assigné à l'application Cato. L'assignation de rôles ne s'applique pas à l'échelle du locataire et doit être répétée par abonnement. 7. Pour **Gemini Enterprise Agent Platform**, confirmez les attentes : seules les sessions d'agent et les événements de session sont affichés ; l'utilisation des outils, de l'intégration et du service externe à l'intérieur d'une session n'est pas collectée par conception. 8. Si l'intervalle de rafraîchissement pertinent s'est écoulé et que les paramètres de traçage/rôle/session spécifiques à la plateforme sont tous confirmés corrects, escaladez vers le support Cato avec le type d'intégration, l'abonnement/environnement/projet spécifique affecté, et les données attendues contre les données réelles observées. ## Lever des cas vers le support Cato Avant de créer un cas avec [Cato Support](/v1/docs/opening-a-support-ticket), assurez-vous que toutes les étapes de dépannage pertinentes décrites dans ce livre de stratégie ont été complétées. Si le problème n'est pas résolu, escaladez vers Cato Support avec les informations suivantes : - **Description du problème** — Une description claire et concise du symptôme observé et du comportement attendu - **Composant affecté** — Nom et type de garde (Proxy, API, ou Passerelle AI), intégration de Passerelle AI (Portkey, LiteLLM, ou Kong), ou intégration d'agent géré (Amazon Bedrock, Amazon Quick, Microsoft Foundry, Copilot Studio, ou Gemini Enterprise Agent Platform) - **Détails de l'environnement** — Pour les gardes : détails de l'application et fichiers de configuration (réduire les clés API). Pour les intégrations d'agent géré : confirmer que les prérequis documentés sont respectés et fournir toute erreur de configuration observée. - **Détails de connexion/politique** — Noms de règles de la politique de déploiement, profil du moteur, direction et action ; ou l'étape de configuration de l'intégration spécifique récemment achevée et son résultat. - **Étapes de dépannage complétées** — Un résumé des étapes déjà entreprises à partir de ce livre de jeu et le résultat de chacune. - **Preuves à l'appui** — Liens vers les événements de sécurité IA, captures d'écran de la règle ou de la configuration d'intégration, statut de la pile CloudFormation ou messages d'erreur de connexion de test, ainsi que les horodatages exacts (UTC et fuseau horaire du client). Plus le contexte et les preuves sont fournis à l'avance, plus le Support Cato sera en mesure d'enquêter et de résoudre rapidement le problème.