Important
Ce point d'accès à l'API REST v1 de Netskope sera supprimé le 15/10/2024. Pour plus de détails, reportez-vous au document End of Life (EOL) for Specific REST API v1 Endpoints (Fin de vie des points d'extrémité de l'API REST v1 ).
Ce point de terminaison permet de créer des rôles d'utilisateur dotés de privilèges définis.
Point final de la demande
https://<tenant-URL>/api/v1/role?op=create
Valid parameters are:
| Clé | Type | Value | Description |
|---|---|---|---|
token | string | Ex:
| Il s'agit d'une obligation. Le jeton obtenu sur la page de l'API REST dans l'interface utilisateur de Netskope ( Settings > Tools > Rest API v1) est nécessaire. Nous vous recommandons de placer le jeton dans le corps de la demande, et non dans l'URL du point final. |
op | string | create | Il s'agit d'une obligation. Opération effectuée. |
role_name | string | Ex:
| Il s'agit d'une obligation. Spécifie le rôle à créer. |
role_description | string | Ex:
| Il s'agit d'une obligation. Décrit le rôle et les compétences. |
privelege | array | { name: 'administrators', value: 'edit'},
| Il s'agit d'une obligation. Spécifie les domaines fonctionnels avec valeur de privilège. |
file_download | string | true |false La valeur par défaut est false. | Optional. Allows admins to download, preview and view files from API-enabled Protection and Incident Management |
obfuscate | array | { name: 'user', value: true},
| Optional. Allows obfuscating file names and values. |
Exemple : Création d'une demande de rôle utilisateur
POST 'https://<tenant-URL>/api/v1/role?op=create'
--header 'Content-Type: application/json'
--data-raw '{
"token": "f32a973eddd7bc1602fc0f48dc0a",
"role_name": "Netskope Role",
"role_desc": "Role Description",
"privilege": [
{
"name": "administrators",
"value": "view"
},
{
"name": "threat",
"value": "edit"
}
],
"scope_query": "user eq '13-38-20@prodauto.local'",
"file_download": true,
"obfuscate": [
{
"name": "user",
"value": true
},
{
"name": "userip",
"value": true
}
]
}'