Intégrer AppSheet à Google SecOps
Ce document explique comment intégrer AppSheet à Google Security Operations (Google SecOps).
Cas d'utilisation
Effectuer des actions CRUD
Paramètres d'intégration
Utilisez les paramètres suivants pour configurer l'intégration :
| Nom du paramètre | Type | Valeur par défaut | Est obligatoire | Description |
|---|---|---|---|---|
| Racine de l'API | Chaîne | https://api.appsheet.com | Oui | Racine de l'API de l'instance AppSheet. |
| ID de l'application | Chaîne | N/A | Oui | ID de l'application AppSheet. |
| Jeton d'accès | Mot de passe | N/A | Oui | Jeton d'accès de l'application AppSheet. |
| Vérifier le protocole SSL | Case à cocher | Cochée | Oui | Si cette option est sélectionnée, l'intégration valide le certificat SSL lors de la connexion au serveur AppSheet. |
Pour savoir comment configurer une intégration dans Google SecOps, consultez Configurer des intégrations.
Vous pourrez apporter des modifications ultérieurement si nécessaire. Après avoir configuré une instance d'intégration, vous pouvez l'utiliser dans des playbooks. Pour en savoir plus sur la configuration et la prise en charge de plusieurs instances, consultez Prendre en charge plusieurs instances.
Actions
Pour en savoir plus sur les actions, consultez Répondre aux actions en attente depuis votre bureau et Exécuter une action manuelle dans votre demande.
Ajouter un enregistrement
Ajouter un enregistrement à une table dans AppSheet
Paramètres
| Nom du paramètre | Type | Valeur par défaut | Est obligatoire | Description |
|---|---|---|---|---|
| Nom de la table | Chaîne | N/A | Oui | Spécifiez le nom de la table à laquelle vous souhaitez ajouter un enregistrement. |
| Objet JSON d'enregistrement | JSON | Oui | Spécifiez l'objet JSON de l'enregistrement à ajouter. |
Exécution
Cette action ne s'exécute pas sur les entités.
Résultats de l'action
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success=False |
Mur des cas
| Type de résultat | Description | Type |
|---|---|---|
| Message de sortie* | L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : Si des données sont disponibles (is_success = true) : "Successfully added new record in table "{table}" in AppSheet. L'action doit échouer et arrêter l'exécution d'un playbook : Si une erreur fatale est signalée (par exemple, des identifiants incorrects, l'absence de connexion au serveur, etc.) : "Error executing action "Add Record". Reason: {0}''.format(error.Stacktrace) Si aucune donnée n'est renvoyée : "Error executing action "Add Record". Motif : la charge utile fournie n'est pas valide. Veuillez vérifier l'orthographe du nom de la table et la structure de l'objet JSON de l'enregistrement.' Si "Message" dans la réponse : "Error executing action "Add Record". Reason: {0}''.format(Message) Objet JSON non valide : erreur lors de l'exécution de l'action "Ajouter un enregistrement". Motif : l'objet JSON fourni n'est pas valide. Veuillez vérifier la structure. |
Général |
Supprimer l'enregistrement
Supprimer un enregistrement d'une table dans AppSheet
Paramètres
| Nom du paramètre | Type | Valeur par défaut | Est obligatoire | Description |
|---|---|---|---|---|
| Nom de la table | Chaîne | N/A | Oui | Spécifiez le nom de la table dans laquelle vous souhaitez supprimer un enregistrement. |
| Objet JSON d'enregistrement | JSON | Oui | Spécifiez l'objet JSON de l'enregistrement à supprimer. Il vous suffit de fournir la clé d'identification unique de l'enregistrement. |
Exécution
Cette action ne s'exécute pas sur les entités.
Résultats de l'action
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success=False |
Mur des cas
| Type de résultat | Description | Type |
|---|---|---|
| Message de sortie* | L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : Si des données sont disponibles (is_success = true) : "Successfully deleted record in table "{table}" in AppSheet. Si le code d'état est 200, mais que rowNumber est nul (is_success=true) : l'enregistrement fourni n'existait pas dans la table "{table}" d'AppSheet. L'action doit échouer et arrêter l'exécution d'un playbook : Si une erreur fatale est signalée (par exemple, des identifiants incorrects, l'absence de connexion au serveur, etc.) : "Error executing action "Delete Record". Reason: {0}''.format(error.Stacktrace) Si aucune donnée n'est renvoyée dans la réponse : "Error executing action "Delete Record". Motif : la charge utile fournie n'est pas valide. Veuillez vérifier l'orthographe du nom de la table et la structure de l'objet JSON de l'enregistrement.' Si "Message" dans la réponse : "Error executing action "Delete Record". Reason: {0}''.format(Message) Erreur lors de l'exécution de l'action "Supprimer l'enregistrement". Motif : l'objet JSON fourni n'est pas valide. Veuillez vérifier la structure. |
Général |
Lister les tables
Répertoriez les tables disponibles dans une application AppSheet.
Paramètres
| Nom du paramètre | Type | Valeur par défaut | Est obligatoire | Description |
|---|---|---|---|---|
| Logique de filtrage | LDD | Égal à Valeurs possibles :
|
Non | Spécifiez la logique de filtre à appliquer. |
| Valeur du filtre | Chaîne | N/A | Non | Spécifiez la valeur à utiliser dans le filtre. Si l'option "Égal" est sélectionnée, l'action essaiera de trouver la correspondance exacte parmi les éléments. Si l'option "Contient" est sélectionnée, l'action essaiera de trouver les éléments contenant cette sous-chaîne. Si rien n'est fourni dans ce paramètre, le filtre ne sera pas appliqué. |
| Nombre maximal de tables à renvoyer | Integer | 50 | Non | Spécifiez le nombre de tables à renvoyer. Valeur par défaut : 50. |
Exécution
Cette action ne s'exécute pas sur les entités.
Résultats de l'action
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success=False |
Résultat JSON
{
"Tables": [
{
"name": "Hash identificiation",
"id": "Hash identificiation"
}
]
}
Mur des cas
| Type de résultat | Description | Type |
|---|---|---|
| Message de sortie* | L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : Si des résultats sont trouvés (is_success = true) : "Successfully found tables for the provided criteria in AppSheet. Si aucun résultat n'est trouvé (is_success = true) : "Aucune table n'a été trouvée pour les critères fournis dans AppSheet. L'action doit échouer et arrêter l'exécution d'un playbook : Si une erreur fatale est signalée (par exemple, des identifiants incorrects, l'absence de connexion au serveur, etc.) : "Error executing action "List Tables". Reason: {0}''.format(error.Stacktrace) |
Général |
| Tableau du mur des cas | Nom : Tables disponibles Colonnes :
|
Général |
Ping
Testez la connectivité à AppSheet.
Paramètres
Aucune.
Exécution
Cette action ne s'exécute pas sur les entités.
Résultats de l'action
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success=False |
Mur des cas
| Type de résultat | Description | Type |
|---|---|---|
| Message de sortie* | L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : Si l'opération réussit : "Successfully connected to the AppSheet server with the provided connection parameters!" (Connexion au serveur AppSheet établie avec les paramètres de connexion fournis) L'action doit échouer et arrêter l'exécution d'un playbook : En cas d'échec : "Failed to connect to the AppSheet server! Error is {0}".format(exception.stacktrace) |
Général |
Rechercher des dossiers
Rechercher des enregistrements dans une table dans AppSheet.
Paramètres
| Nom du paramètre | Type | Valeur par défaut | Est obligatoire | Description |
|---|---|---|---|---|
| Nom de la table | Chaîne | N/A | Oui | Spécifiez le nom de la table pour laquelle vous souhaitez récupérer des détails. |
| Requête de sélecteur | Chaîne | N/A | Non | Spécifiez la requête de sélecteur, qui sera utilisée pour limiter les résultats. Si rien n'est fourni, l'action renvoie tous les enregistrements. |
Exécution
Cette action ne s'exécute pas sur les entités.
Résultats de l'action
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success=False |
Mur des cas
| Type de résultat | Description | Type |
|---|---|---|
| Message de sortie* | L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : Si des données sont disponibles (is_success = true) : "Successfully retrieved records based on the provided criteria from table "{table}" in AppSheet. Si aucune donnée n'est disponible (is_success=false) : aucun enregistrement n'a été trouvé en fonction des critères fournis dans la table "{table}" d'AppSheet. L'action doit échouer et arrêter l'exécution d'un playbook : Si une erreur fatale est signalée (par exemple, des identifiants incorrects, l'absence de connexion au serveur, etc.) : "Error executing action "Search Records". Reason: {0}''.format(error.Stacktrace) Si "Message" dans la réponse : "Error executing action "Search Records". Reason: {0}''.format(Message) |
Général |
| Tableau du mur des cas | Nom : Records | Général |
Mettre à jour l'enregistrement
Mettre à jour un enregistrement dans une table dans AppSheet
Paramètres
| Nom du paramètre | Type | Valeur par défaut | Est obligatoire | Description |
|---|---|---|---|---|
| Nom de la table | Chaîne | N/A | Oui | Spécifiez le nom de la table dans laquelle vous souhaitez mettre à jour un enregistrement. |
| Objet JSON d'enregistrement | JSON | Oui | Spécifiez l'objet JSON de l'enregistrement à mettre à jour. Vous devez fournir la clé d'identifiant unique et les champs que vous souhaitez mettre à jour. |
Exécution
Cette action ne s'exécute pas sur les entités.
Résultats de l'action
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success=False |
Mur des cas
| Type de résultat | Description | Type |
|---|---|---|
| Message de sortie* | L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : Si des données sont disponibles (is_success = true) : "Enregistrement mis à jour dans la table "{table}" dans AppSheet. L'action doit échouer et arrêter l'exécution d'un playbook : En cas d'erreur fatale (identifiants incorrects, absence de connexion au serveur, etc.) : "Error executing action "Update Record". Reason: {0}''.format(error.Stacktrace) Si aucune donnée n'est renvoyée : "Error executing action "Update Record". Motif : la charge utile fournie n'est pas valide. Veuillez vérifier l'orthographe du nom de la table et la structure de l'objet JSON de l'enregistrement.' Si "Message" dans la réponse : "Error executing action "Update Record". Reason: {0}''.format(Message) Erreur lors de l'exécution de l'action "Mettre à jour l'enregistrement". Motif : l'objet JSON fourni n'est pas valide. Veuillez vérifier la structure. |
Général |
Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.