Mettre à jour un rôle utilisateur - Documentation technique Netskope

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 ).

This endpoint updates user roles and privileges.

Point final de la demande

https://<tenant-URL>/api/v1/role?op=update

Valid parameters are:

Clé	Type	Value	Description
`token`	string	Ex: `f32a973eddd7bc1602fc0dc0a`	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	`update`	Il s'agit d'une obligation. Opération effectuée.
`role_name`	string	Ex: `admin \| user \| analyst`	Il s'agit d'une obligation. Spécifie le rôle à mettre à jour.
`new_role_name`	string	Ex: `security analyst`	Required. Specifies new role name.
`role_description`	string	Ex: `User with view only privileges`	Il s'agit d'une obligation. Décrit le rôle et les compétences.
`privelege`	array	`{ name: 'administrators', value: 'edit'},` `{ name: 'threat', value: 'view'},` `{ name: 'reports', value: 'none'},` `{ name: 'policies', value: 'apply'}`	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},` `{ name: 'userip', value: false},` `{ name: 'source', value: true},` `{ name: 'file', value: false}`	Optional. Allows obfuscating file names and values.

Exemple de demande de mise à jour du rôle d'un utilisateur

POST 'https://<tenant-URL>/api/v1/role?token=token&op=update' 
--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": "account_id eq '215406114230'",
  "file_download": true,
  "obfuscate": [
    {
      "name": "user",
      "value": false
    },
    {
      "name": "app",
      "value": true
    }
  ]
}'