Gérer plusieurs comptes AWS - Documentation technique Netskope

Ce point d'accès vous permet de créer, mettre à jour, supprimer et télécharger plusieurs comptes AWS.

Request

POST https://<tenant-URL>/api/v1/public_cloud/account?token=<token>&<parameters>

Les paramètres valides de la charge utile sont les suivants :

Clé	Type	Value	Description
`op`	string	`create \| update \| delete \| download`	Il s'agit d'une obligation. Spécifie l'opération à effectuer.
`app`	string	`"aws"`	Requis. Lorsque `aws`, tous les champs obligatoires ci-dessous doivent être renseignés.
`accounts`	Tableau JSON d'objets	Pour créer : "accounts": [ { "account_id": "<account_id>", "account_name": "<account_name>", "admin_email": "<admin_email>"}, { "account_id": "<account_id>"account_name": "<account_name>", "admin_email": "<admin_email>" } ] Pour la mise à jour : "accounts": [ { "instance_name": "abcish", "admin_email": "admin@netskope.com", "use_for": [ "securityscan", "malware", "introspection" ], "securityscan_interval": "120" } ] Pour supprimer : "accounts": [ { "instance_name": "abcish" } ] Pour télécharger CFT : { "app":"aws" "type": "cft", "use_for": [ "introspection" ] } ] Pour télécharger la migration CFT : { "app":"aws", "type": "cft", "mode": "migrate", "instance_name": "abcish", "admin_email": "admin@netskope.com", "use_for": [ "securityscan", "introspection" ], "securityscan_interval": "60" }	Liste des comptes avec account_id et admin_email. Create permet d'ajouter plusieurs comptes à la fois. Un seul compte peut être mis à jour ou supprimé à la fois.
`instance_name`	string	`<instance_name>` Exemple : `"MYAWS_GOSKOPE"`	Il s'agit d'une obligation. Le nom de l'instance AWS dans l'interface utilisateur de Netskope.
`mode`	string	`migrate`	Uniquement pour télécharger le CFT de migration.
`admin_email`	string	`<emailaddress@company.com>` Exemple : `admin@neskope.com`	Courriel de l'administrateur pour la mise à jour et le téléchargement du CFT de migration.
`type`	string	`cft`	Type d'option de téléchargement. Actuellement, seule l'option `cft` est prise en charge.
`use_for`	array	`"introspection" \|` `"malware"` \| `"securityscan"` Exemple : `["malware","introspection"]`	Il s'agit d'une obligation. Ne doit pas être un tableau vide. Les éléments du tableau doivent être pris en charge par AWS. S'il contient `"malware"` ou `"introspection"`, il doit également être fourni. Note Pour utiliser `introspection`, `malware`, et `securityscan`, contactez d'abord le service d'assistance de Netskope pour que cette fonctionnalité soit activée.
`securityscan_interval`	integer	En quelques minutes. Exemple : `1440`	Lorsqu'il est utilisé pour `"securityscan"`, il doit s'agir d'une valeur autorisée par les intervalles disponibles. Si elle est omise, la valeur par défaut est la valeur par défaut définie en interne en fonction de l'application.

Exemple de demande de création

curl --location --request POST 'https://<tenant-URL>/api/v1/public_cloud/account?token=<token>&op=create' --header 'Content-Type: application/json' --data-raw '{
    "app":"aws",
    "accounts": [
        {
            "account_id": "077000210270",
            "account_name": "Test-1"
            "admin_email": "admin@netskope.com"
        },
        {
            "account_id": "077000210271",
            "account_name": "Test-2"
            "admin_email": "admin@netskope.com"
        }
    ],
    "use_for": [
        "securityscan",
        "malware",
        "introspection"
    ],
    "securityscan_interval": "60"
}'

Exemple de demande de mise à jour

curl --location --request POST 'https://<tenant-URL>/api/v1/public_cloud/account?token=<token>&op=update' --header 'Content-Type: application/json' --data-raw '{
    "app":"aws",
    "instance_name": "abcish",
    "admin_email": "admin@netskope.com"
    "use_for": [
        "securityscan",
        "malware",
        "introspection"
    ],
    "securityscan_interval": "120"
}'

Exemple de demande de suppression

curl --location --request POST 'https://<tenant-URL>/api/v1/public_cloud/account?token=<token>&op=delete' --header 'Content-Type: application/json' --data-raw '{
    "app":"aws",
    "account_id": "077000210270"
}'

Exemple de téléchargement d'une demande de CFT

curl --location --request POST 'https://<tenant-URL>/api/v1/public_cloud/account?token=<token>&op=download' --header 'Content-Type: application/json' --data-raw '{
    "app":"aws",
    "type": "cft",
    "use_for": [
        "introspection"
    ]
}'

Exemple de demande de téléchargement de la migration CFT pour les instances existantes

curl --location --request POST 'https://<tenant-URL>/api/v1/public_cloud/account?token=<token>&op=download' --header 'Content-Type: application/json' --data-raw '{
    "app":"aws",
    "type": "cft",
    "mode": "migrate",
    "instance_name": "abcish",
    "admin_email": "admin@netskope.com",
    "use_for": [
        "securityscan",
        "introspection"
    ],
    "securityscan_interval": "60"
}'