Utiliser l'IDE
Ce document explique le mode Production de l'environnement de développement intégré (IDE). L'IDE est un framework permettant d'afficher, de modifier et de tester du code. Vous pouvez afficher le code des intégrations commerciales et créer des intégrations personnalisées à partir de zéro ou en dupliquant le code des intégrations commerciales.
L'IDE vous permet de gérer, d'importer et d'exporter des intégrations personnalisées.
Ouvrir l'IDE
Pour ouvrir l'IDE, procédez comme suit :
- Pour ouvrir l'IDE, accédez à Automatisation > IDE dans le menu principal. La page IDE s'ouvre.
Sur la page IDE, vous pouvez accéder aux options suivantes :
| Option | Description |
|---|---|
| Types d'intégrations | Choisissez entre Intégrations ou Types (connecteurs, actions, jobs, gestionnaires). |
| Exporter Importer | Exporter un ou plusieurs éléments d'une intégration. Les éléments dépendants sont inclus lors de l'exportation d'éléments individuels, mais pas lors de l'exportation d'un package complet. Le fichier exporté est une archive ZIP contenant un fichier JSON. Lors de l'importation, vous pouvez ajouter des éléments individuels à une intégration existante ou importer un package complet. Pour l'ancien format d'exportation/importation (V1 - plan de données désactivé), le package doit inclure un fichier integrations.def et les dossiers suivants : ActionsDefinitions, ActionsScripts, Dependencies et Managers. Pour le nouveau format d'exportation/importation (V2 - plan de données activé), le dossier du package doit inclure un fichier metadata.json et peut inclure les dossiers actions, connectors, jobs et dependencies. Notez que l'exportation d'une intégration depuis un environnement où le plan de données est activé et son importation dans un environnement où le plan de données n'est pas activé ne sont pas prises en charge. L'inverse (exporter depuis un environnement où le plan de données n'est pas activé vers un environnement où il l'est) est possible. |
| Cliquez sur le bouton Masquer les éléments inactifs/Tout afficher pour afficher ou masquer les éléments désactivés (actions, connecteurs). | |
| Ajoutez une intégration, un connecteur, une action, un job ou un gestionnaire personnalisés. |
Ajouter un connecteur
Pour ajouter un connecteur, procédez comme suit :
- Cliquez sur Créer un élément et sélectionnez Connecteur.
- Saisissez un nom et l'intégration requise.
- Cliquez sur Créer.
- Ajoutez les détails de l'intégration.
- Ajoutez les paramètres requis.
- Cliquez sur le bouton Connecteur pour activer le connecteur.
- Lorsque vous avez terminé, cliquez sur Enregistrer ou appuyez sur
Ctrl + S.
Les options suivantes sont disponibles dans l'onglet Détails :
| Option | Description |
|---|---|
| Supprimer | Disponible uniquement pour les éléments des intégrations personnalisées. |
| Play | Exécute la méthode de test du script. Les résultats s'affichent dans l'onglet Tests, et la sortie de débogage s'affiche dans la section Sortie de débogage. |
| file_json Gérer l'exemple JSON | Dans la boîte de dialogue d'importation/exportation de l'exemple JSON, assurez-vous que l'option Inclure le résultat JSON est activée. Vous pouvez ensuite importer ou exporter des exemples de résultats JSON pour les actions. |
| Détail | Saisissez les entrées fournies par l'utilisateur et d'autres paramètres, tels que le nom de l'intégration. |
| Contrôle des versions | Contrôle des versions : sélectionnez une action, une tâche ou un connecteur, puis cliquez pour afficher les options suivantes : Enregistrer en tant que nouvelle version : enregistrez l'objet en tant que nouvelle version avec des commentaires facultatifs. Afficher l'historique des versions : affichez et restaurez les versions précédentes. Disponible uniquement si au moins une version a été enregistrée. Cliquez sur "Restaurer" pour rétablir l'une des versions précédentes à tout moment. Cette option n'est disponible que si vous avez déjà cliqué sur Enregistrer en tant que nouvelle version pour une action, un job, un connecteur ou un gestionnaire. |
| élément en double | Dupliquer un élément (job, action, connecteur, gestionnaire). Une fois l'enregistrement effectué, la copie apparaît dans la liste sans l'icône Cadenas . |
Créer une intégration personnalisée
- Cliquez sur Créer un élément, puis sélectionnez Intégration.
- Saisissez un nom, puis cliquez sur Créer.
-
Sélectionnez l'intégration créée dans la liste et fournissez les informations suivantes :
- Description : apparaît dans Content Hub et est visible par tous les utilisateurs de Google Security Operations.
- Icône SVG : importez une icône SVG qui s'affiche avec l'intégration.
- Image : importez une image Content Hub pour les utilisateurs de Google SecOps.
- Bibliothèques : ajoutez des bibliothèques Python à l'aide de pip.
- Dépendances de script : importez des fichiers.WHL, .PY, .TAR ou.GZ. Ces scripts ajoutent des fonctionnalités à votre intégration.
- Paramètre : ajoutez des champs configurables avec des types définis, des valeurs par défaut et un état obligatoire.
- Lorsque vous avez terminé, cliquez sur Enregistrer.
Créer un job
Pour créer un job, procédez comme suit :
- Cliquez sur Create New Item (Créer un élément), puis sélectionnez Job (Tâche).
- Saisissez un nom et l'intégration requise.
- Cliquez sur Créer.
- Facultatif : ajoutez des paramètres pour l'entrée utilisateur ou de script.
- Cliquez sur Enregistrer ou appuyez sur
Ctrl + S. - Cliquez sur arrow_right Play Item (Lire l'élément) pour exécuter le script.
- Accédez à Automatisation > Planificateur de jobs.
- Cliquez sur addCréer un job, puis sélectionnez le job que vous venez de créer.
- Dans Response >Jobs Scheduler (Réponse > Planificateur de jobs), choisissez l'heure d'exécution du job (script) que vous avez créé.
Créer une action à utiliser dans un playbook
Pour créer une action pour un playbook, procédez comme suit :
- Cliquez sur Créer un élément, puis sélectionnez Action.
- Saisissez un nom et l'intégration requise > cliquez sur Créer.
- Modifiez le code si nécessaire.
- Activez l'option Inclure le résultat JSON si l'action doit renvoyer un résultat JSON dans un playbook.
- Facultatif : ajoutez des paramètres à afficher sous forme de champs de saisie.
- Activez l'action, puis cliquez sur Enregistrer.
- Dans Configuration de l'interrogation, vous pouvez définir un délai avant expiration et une valeur de retour par défaut si l'action expire. Vous pouvez également définir une valeur par défaut à renvoyer si l'action ne se termine pas dans le délai défini.
L'action est désormais disponible dans Playbook > Actions.
Créer un gestionnaire personnalisé
Pour créer un gestionnaire personnalisé, procédez comme suit :
- Cliquez sur Créer un élément, puis sélectionnez Administrateur. Saisissez un nom et l'intégration requise.
- Cliquez sur Créer.
- Modifiez le code si nécessaire.
- Cliquez sur Enregistrer.
Sécurité du code personnalisé de l'IDE
Pour garantir un environnement d'exécution de code sécurisé, tout le code Python personnalisé dans l'IDE s'exécute dans un environnement de bac à sable. Cet environnement est isolé du serveur principal et fonctionne avec un utilisateur disposant de droits limités. L'accès au système d'exploitation sous-jacent est strictement limité à une liste d'autorisation de commandes et de répertoires non administratifs requis pour les tâches d'intégration et d'automatisation standards. Cette approche de bac à sable permet d'assurer une sécurité robuste tout en offrant la flexibilité nécessaire pour exécuter un large éventail de code Python.Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.