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 :

  • Égal à
  • Contient
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 :

  • ID
  • Nom
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.