ユーザーロールの作成 - Netskopeナレッジポータル

重要

このNetskope REST API v1 エンドポイントは、2024 年 10 月 15 日に廃止されます。詳細については、「特定の REST API v1 エンドポイントのサポート終了 (EOL)」を参照してください。

このエンドポイントは、定義された権限を持つユーザーロールを作成します。

リクエストエンドポイント

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

Valid parameters are:

鍵	タイプ	Value	デスクリプション
`token`	string	Ex: `f32a973eddd7bc1602fc0dc0a`	必須。Netskope UI の REST API ページ ( Settings > Tools > Rest API v1 ) から取得したトークンが必要です。エンドポイント URL ではなく、リクエストの本文にトークンを配置することをお勧めします。
`op`	string	`create`	必須。手術は完了しました。
`role_name`	string	Ex: `admin \| user \| analyst`	必須。作成するロールを指定します。
`role_description`	string	Ex: `User with view only privileges`	必須。役割と能力について説明します。
`privelege`	array	`{ name: 'administrators', value: 'edit'},` `{ name: 'threat', value: 'view'},` `{ name: 'reports', value: 'none'},` `{ name: 'policies', value: 'apply'}`	必須。特権値を持つ機能領域を指定します。
`file_download`	string	`true \|false` デフォルトは`false`です。	任意。管理者は、API 対応の保護およびインシデント管理からファイルをダウンロード、プレビュー、表示できます。
`obfuscate`	array	`{ name: 'user', value: true},` `{ name: 'userip', value: false},` `{ name: 'source', value: true},` `{ name: 'file', value: false}`	任意。ファイル名と値の難読化を可能にします。

例：ユーザーロール作成リクエスト

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
    }
  ]
}'