Cette page a été traduite par l'API Cloud Translation.

AWS S3

Version de l'intégration : 4.0

Cas d'utilisation

Gérer les buckets
Télécharger des fichiers depuis des buckets
Importer des fichiers dans des ensembles

Configurer l'intégration AWS S3 dans Google Security Operations

Pour obtenir des instructions détaillées sur la configuration d'une intégration dans Google SecOps, consultez Configurer des intégrations.

Paramètres d'intégration

Utilisez les paramètres suivants pour configurer l'intégration :

Nom à afficher du paramètre	Type	Valeur par défaut	Obligatoire	Description
Nom de l'instance	Chaîne	N/A	Non	Nom de l'instance pour laquelle vous souhaitez configurer l'intégration.
Description	Chaîne	N/A	Non	Description de l'instance.
AWS Access Key ID (ID de clé d'accès AWS)	Chaîne	N/A	Oui	ID de clé d'accès AWS à utiliser dans l'intégration.
Clé secrète AWS	Mot de passe	N/A	Oui	Clé secrète AWS à utiliser dans l'intégration.
Région AWS par défaut	Chaîne	N/A	Oui	Région AWS par défaut à utiliser dans l'intégration, par exemple "us-west-2".
Exécuter à distance	Case à cocher	Décochée	Non	Cochez le champ pour exécuter l'intégration configurée à distance. Une fois la case cochée, l'option permettant de sélectionner l'utilisateur distant (agent) s'affiche.

Actions

Ping

Description

Testez la connectivité à AWS S3 avec les paramètres fournis sur la page de configuration de l'intégration dans l'onglet "Google Security Operations Marketplace".

Cas d'utilisation

Testez la connectivité.

Exécuter sur

Cette action ne s'applique pas aux 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	Valeur / 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 : "Connexion au serveur AWS S3 réussie avec les paramètres de connexion fournis !" L'action doit échouer et arrêter l'exécution d'un playbook : Si l'opération échoue : "Échec de la connexion au serveur AWS S3 ! Error is {0}".format(exception.stacktrace)	Général

Type de résultat

Valeur / 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 :

"Connexion au serveur AWS S3 réussie avec les paramètres de connexion fournis !"

L'action doit échouer et arrêter l'exécution d'un playbook :

Si l'opération échoue :

"Échec de la connexion au serveur AWS S3 ! Error is {0}".format(exception.stacktrace)

Général

Lister les buckets

Description

Récupérez une liste de buckets depuis AWS S3.

Exécuter sur

Cette action ne s'applique pas aux 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

{
    "Buckets": [
        {
            "CreationDate": %Y-%m-%dT%H:%M:%S,
            "Name": "testsiemplify"
        }
    ],
    "Owner": {
        "DisplayName": "lab_aws",
        "ID": "935dc3fed0e1d2c5b12242cf9927370824f2438681a2d3c0523f254dbde41aba"
    },

Mur des cas

Type de résultat	Valeur / Description	Type
Message de sortie*	L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : Si le code d'état est égal à 200 (is_success = true) : "La liste des buckets disponibles dans AWS S3 a été créée avec succès." Si un autre code d'état (is_success=false) s'affiche : "L'action n'a pas pu lister les buckets disponibles dans AWS S3. L'action doit échouer et arrêter l'exécution d'un playbook : Si une erreur fatale se produit (par exemple, des identifiants incorrects, une absence de connexion au serveur, etc.) : "Erreur lors de l'exécution de l'action "Lister les buckets". Raison : {0}''.format(error.Stacktrace)	Général

Type de résultat

Valeur / Description

Type

Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si le code d'état est égal à 200 (is_success = true) : "La liste des buckets disponibles dans AWS S3 a été créée avec succès."

Si un autre code d'état (is_success=false) s'affiche : "L'action n'a pas pu lister les buckets disponibles dans AWS S3.

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale se produit (par exemple, des identifiants incorrects, une absence de connexion au serveur, etc.) : "Erreur lors de l'exécution de l'action "Lister les buckets". Raison : {0}''.format(error.Stacktrace)

Général

Obtenir la stratégie de bucket

Description

Récupérez les informations sur la stratégie de bucket depuis AWS S3.

Paramètres

Nom à afficher du paramètre	Type	Valeur par défaut	Obligatoire	Description
Nom du bucket	Chaîne	N/A	Oui	Spécifiez le nom du bucket à partir duquel récupérer les informations sur la stratégie.

Exécuter sur

Cette action ne s'applique pas aux 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

{
    "Policy": {
        "Version": "2012-10-17",
        "Statement": [
            {
                "Sid": "AddPerm",
                "Effect": "Allow",
                "Principal": "*",
                "Action": "s3:GetObject",
                "Resource": "arn:aws:s3:::testsiemplify/*"
            }
        ]
    }

Mur des cas

Type de résultat	Valeur / Description	Type
Message de sortie*	L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : Si le code d'état est égal à 200 (is_success = true) "Informations sur la règle du bucket "{0}" dans AWS S3 récupérées avec succès".format(bucket_name) Si le code d'état est différent (is_success=false) : "L'action n'a pas pu renvoyer d'informations sur le règlement du bucket '{0}' dans AWS S3".format(bucket_name) L'action doit échouer et arrêter l'exécution d'un playbook : Si une erreur fatale se produit (par exemple, des identifiants incorrects, une absence de connexion au serveur, etc.) : "Erreur lors de l'exécution de l'action "Obtenir la règle du bucket". Raison : {0}''.format(error.Stacktrace)	Général

Type de résultat

Valeur / Description

Type

Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si le code d'état est égal à 200 (is_success = true) "Informations sur la règle du bucket "{0}" dans AWS S3 récupérées avec succès".format(bucket_name)

Si le code d'état est différent (is_success=false) : "L'action n'a pas pu renvoyer d'informations sur le règlement du bucket '{0}' dans AWS S3".format(bucket_name)

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale se produit (par exemple, des identifiants incorrects, une absence de connexion au serveur, etc.) : "Erreur lors de l'exécution de l'action "Obtenir la règle du bucket". Raison : {0}''.format(error.Stacktrace)

Général

Définir une stratégie de bucket

Description

Définissez une règle dans le bucket à partir d'AWS S3.

Paramètres

Nom à afficher du paramètre	Type	Valeur par défaut	Obligatoire	Description
Nom du bucket	Chaîne	N/A	Oui	Spécifiez le nom du bucket pour lequel vous souhaitez mettre à jour la règle.
Objet JSON de la règle	Chaîne	N/A	Oui	Spécifiez l'objet JSON de la règle que vous souhaitez définir pour le bucket. Vous trouverez des exemples ici : https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html.

Exécuter sur

Cette action ne s'applique pas aux 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

bucket_policy = {
    'Version': '2012-10-17',
    'Statement': [{
        'Sid': 'AddPerm',
        'Effect': 'Allow',
        'Principal': '*',
        'Action': ['s3:GetObject'],
        'Resource': f'arn:aws:s3:::{bucket_name}/*'
    }]
}

Mur des cas

Type de résultat	Valeur / Description	Type
Message de sortie*	L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : Si le code d'état est égal à 204 (is_success = true) "La règle du bucket "{0}" dans AWS S3 a été mise à jour".format(bucket_name) Si le code d'état est différent (is_success=false) : "L'action n'a pas pu mettre à jour la règle du bucket '{0}' dans AWS S3".format(bucket_name) L'action doit échouer et arrêter l'exécution d'un playbook : Si une erreur fatale se produit (par exemple, des identifiants incorrects, une absence de connexion au serveur, etc.) : "Erreur lors de l'exécution de l'action "Définir la règle du bucket". Raison : {0}''.format(error.Stacktrace)

Type de résultat

Valeur / Description

Type

Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si le code d'état est égal à 204 (is_success = true) "La règle du bucket "{0}" dans AWS S3 a été mise à jour".format(bucket_name)

Si le code d'état est différent (is_success=false) : "L'action n'a pas pu mettre à jour la règle du bucket '{0}' dans AWS S3".format(bucket_name)

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale se produit (par exemple, des identifiants incorrects, une absence de connexion au serveur, etc.) : "Erreur lors de l'exécution de l'action "Définir la règle du bucket". Raison : {0}''.format(error.Stacktrace)

Lister les objets d'un bucket

Description

Permet à l'utilisateur de désactiver un compte utilisateur. Le corps de la requête contient l'utilisateur à désactiver. La propriété "Compte activé" du compte doit être définie sur "false".

Paramètres

Nom à afficher du paramètre	Type	Valeur par défaut	Obligatoire	Description
Nom du bucket	Chaîne	N/A	Oui	Spécifiez le nom du bucket à partir duquel récupérer les objets.
Nombre maximal d'objets à renvoyer	Integer	N/A	Non	Spécifiez le nombre d'objets à renvoyer.

Exécuter sur

Cette action ne s'applique pas aux 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

"Contents": [
        {
            "Key": "text.txt",
            "LastModified": %Y-%m-%dT%H:%M:%S,
            "ETag": "d41d8cd98f00b204e9800998ecf8427e",
            "Size": 0,
            "StorageClass": "STANDARD",
            "Owner": {
                "DisplayName": "lab_aws",
                "ID": "935dc3fed0e1d2c5b12242cf9927370824f2438681a2d3c0523f254dbde41aba"
            }
        },
        {
            "Key": "text_1.txt",
            "LastModified": %Y-%m-%dT%H:%M:%S,
            "ETag": "d41d8cd98f00b204e9800998ecf8427e",
            "Size": 0,
            "StorageClass": "STANDARD",
            "Owner": {
                "DisplayName": "lab_aws",
                "ID": "935dc3fed0e1d2c5b12242cf9927370824f2438681a2d3c0523f254dbde41aba"
            }
        }
    ]

Mur des cas

Type de résultat	Valeur / Description	Type
Message de sortie*	L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : Si le code d'état est égal à 200 (is_success = true) "Objets du bucket "{0}" renvoyés avec succès dans AWS S3".format(bucket_name) Si le code d'état est différent (is_success=false) : "L'action n'a pas pu renvoyer d'objets du bucket '{0}' dans AWS S3".format(bucket_name) L'action doit échouer et arrêter l'exécution d'un playbook : Si une erreur fatale se produit (par exemple, des identifiants incorrects, une absence de connexion au serveur, etc.) : "Erreur lors de l'exécution de l'action "Lister les objets du bucket". Raison : {0}''.format(error.Stacktrace)	Général
Tableau du mur des cas	Nom de la table : objets du bucket "{0}" Colonnes : Clé (mappée en tant que clé) Dernière modification (mappée en tant que "LastModified") Taille (octets) (mappée en tant que "Taille") Propriétaire (mappé en tant que Owner/DisplayName) Classe de stockage (mappée en tant que "Classe de stockage")	Général

Type de résultat

Valeur / Description

Type

Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si le code d'état est égal à 200 (is_success = true) "Objets du bucket "{0}" renvoyés avec succès dans AWS S3".format(bucket_name)

Si le code d'état est différent (is_success=false) : "L'action n'a pas pu renvoyer d'objets du bucket '{0}' dans AWS S3".format(bucket_name)

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale se produit (par exemple, des identifiants incorrects, une absence de connexion au serveur, etc.) : "Erreur lors de l'exécution de l'action "Lister les objets du bucket". Raison : {0}''.format(error.Stacktrace)

Général

Tableau du mur des cas

Nom de la table : objets du bucket "{0}"

Colonnes :

Clé (mappée en tant que clé)
Dernière modification (mappée en tant que "LastModified")
Taille (octets) (mappée en tant que "Taille")
Propriétaire (mappé en tant que Owner/DisplayName)
Classe de stockage (mappée en tant que "Classe de stockage")

Général

Télécharger un fichier à partir d'un bucket

Description

Téléchargez un fichier à partir d'un bucket dans AWS S3.

Paramètres

Nom à afficher du paramètre	Type	Valeur par défaut	Obligatoire	Description
Chemin d'accès au fichier du bucket	Chaîne	s3://{bucket_name}/{file_name}	Oui	Spécifiez le chemin d'accès au fichier dans le bucket. Exemple : s3://siemplify/syslog/log.txt
Chemin de téléchargement	Chaîne	N/A	Oui	Spécifiez le chemin d'accès où télécharger le fichier.

Exécuter sur

Cette action ne s'applique pas aux 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

{
"bucket_file_path": "s3://testsiemplify/test/123.txt"
"download_path": "/usr/bin/share/download.txt"
}

Mur des cas

Type de résultat	Valeur / Description	Type
Message de sortie*	L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : Si le code d'état est égal à 200 (is_success = true) "Téléchargement réussi de '{0}' depuis AWS S3".format(bucket_file_path) Si un autre code d'état (is_success=false) est renvoyé : "L'action n'a pas pu télécharger '{0}' depuis AWS S3. Motif : un fichier portant ce chemin de téléchargement existe déjà." L'action doit échouer et arrêter l'exécution d'un playbook : Si une erreur fatale se produit (par exemple, des identifiants incorrects, une absence de connexion au serveur, des erreurs de SDK ou autre) : "Erreur lors de l'exécution de l'action "Télécharger un fichier depuis un bucket". Raison : {0}''.format(error.Stacktrace)	Général

Type de résultat

Valeur / Description

Type

Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si le code d'état est égal à 200 (is_success = true) "Téléchargement réussi de '{0}' depuis AWS S3".format(bucket_file_path)

Si un autre code d'état (is_success=false) est renvoyé : "L'action n'a pas pu télécharger '{0}' depuis AWS S3. Motif : un fichier portant ce chemin de téléchargement existe déjà."

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale se produit (par exemple, des identifiants incorrects, une absence de connexion au serveur, des erreurs de SDK ou autre) : "Erreur lors de l'exécution de l'action "Télécharger un fichier depuis un bucket". Raison : {0}''.format(error.Stacktrace)

Général

Importer un fichier dans un bucket

Description

Importez le fichier dans un bucket AWS S3.

Paramètres

Nom à afficher du paramètre	Type	Valeur par défaut	Obligatoire	Description
Chemin d'accès au fichier	Chaîne	N/A	Oui	Spécifiez le chemin d'accès au fichier à importer.
Chemin d'accès au bucket pour l'importation	Chaîne	s3://{bucket_name}/{file_name}	Oui	Spécifiez le chemin d'accès dans le bucket où le chemin d'accès doit être importé. Exemple : s3://siemplify/syslog/log.txt

Exécuter sur

Cette action ne s'applique pas aux 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

{
"bucket_upload_path": "s3://testsiemplify/test/123.txt"
"file_path": "/usr/bin/share/download.txt"
}

Mur des cas

Type de résultat	Valeur / Description	Type
Message de sortie*	L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : Si le code d'état est égal à 200 (is_success = true) "Fichier '{0}' importé dans le bucket AWS S3 {1}".format(file_path, bucket name aka first string after s3://) Si le fichier n'existe pas (is_success = false) "L'action n'a pas pu importer '{0}' vers AWS S3. Motif : le fichier avec ce chemin d'importation n'existe pas." L'action doit échouer et arrêter l'exécution d'un playbook : Si une erreur fatale se produit (par exemple, des identifiants incorrects, une absence de connexion au serveur, des erreurs de SDK, etc.) : "Erreur lors de l'exécution de l'action "Importer un fichier dans un bucket". Raison : {0}''.format(error.Stacktrace)	Général

Type de résultat

Valeur / Description

Type

Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si le code d'état est égal à 200 (is_success = true) "Fichier '{0}' importé dans le bucket AWS S3 {1}".format(file_path, bucket name aka first string after s3://)

Si le fichier n'existe pas (is_success = false) "L'action n'a pas pu importer '{0}' vers AWS S3. Motif : le fichier avec ce chemin d'importation n'existe pas."

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale se produit (par exemple, des identifiants incorrects, une absence de connexion au serveur, des erreurs de SDK, etc.) : "Erreur lors de l'exécution de l'action "Importer un fichier dans un bucket". Raison : {0}''.format(error.Stacktrace)

Général

Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.