認可

Netskopeカードを初めてフローに追加すると、Okta Workflowsから接続の構成を求められます。この接続はNetskopeアカウントにリンクしてアカウント情報を保存するため、将来のNetskopeフローで接続を再利用できます。

注:

Okta Workflowsコンソールの接続（Connections）ページでは、一意の接続を複数作成し、管理できます。

開始する前に

Netskopeアカウントへの接続を作成するには、次の要素が必要です。

REST API v2サービス（REST API v2 Services）機能を有効にするREST APIリクエストを送信する前に、Netskope REST APIサービス機能を有効にします。
- 管理者としてNetskopeにサインインします。
- 設定（Settings） > ツール（Tools） > Rest API v2に移動します。
- REST API Status：ステータスを表示し、テナントのREST APIトークンを有効または無効にできます。鉛筆アイコンをクリックし、REST API v2トークンを編集して有効にします。
- 保存（Save）をクリックします。
トークンを作成します。
- REST API v2ページで新規トークン（New Token）をクリックします。
- トークン名とトークンの有効期限を入力し、エンドポイントの追加（Add Endpoint）をクリックしてトークンで使用するAPIエンドポイントを選択します。
- 追加された各エンドポイントの権限を指定します。読み取り権限にはGETが含まれ、読み取りおよび書き込み権限にはGET、PUT、POST、PATCH、およびDELETEが含まれます。
  
  カスタムAPIアクション（Custom API Action）カードには、各APIエンドポイントに対する特定のスコープが必要です。
- 次のスコープを付与します。
  - /api/v2/scim/Users Read + Write
  - /api/v2/scim/Groups Read + Write
- 保存（Save）をクリックします。
- トークンの作成が成功したかどうかを示す確認ページが開きます。成功したら、トークンのコピー（［Copy Token）］をクリックして、後でAPIリクエストで使用できるように保存します。
- OKをクリックします。
  
  注意:
  セキュリティ上の理由から、APIトークン（API Token）はこの確認ページに表示される1回限りの値です。
  
  このページから移動すると、システムからAPIトークンを取得することはできません。
  
  APIトークンを紛失した場合は、新しい値を取得するためにそのAPIトークンをリセットする必要があります。
Netskope URLのサブドメインをコピーします。

手順

Okta WorkflowsでNetskope接続を作成する手順は次のとおりです。

Workflowsコンソールで接続（Connections）タブを開くか、Netskopeカードを開きます。
新規接続（New Connection）をクリックします。
接続の名前（Name）を入力します。これは、チームで共有するために複数の接続の作成を計画している場合に便利です。
接続の説明（Description）を入力します。これは、接続についてより多くの情報がある場合に有用です。
テナント（Tenant ）フィールドにNetskope URLのサブドメインを入力します。
APIトークン（API Token）フィールドにREST APIのAPIトークンIDを入力します。
作成（Create）をクリックします。

APIトークンの再発行

有効期限切れのAPIトークンを手動で再発行するには、次の手順を実行します。

REST API v2ページで、APIトークンの横にある3点リーダーアイコンをクリックし、再発行（Reissue）を選択します。
再発行（Reissue）をクリックして確定します。
トークンの再発行が成功したかどうかを示す確認ページが開きます。成功したら、トークンのコピー（［Copy Token）］をクリックして、後でAPIリクエストで使用できるように保存します。
REST API v2ページで、APIトークンの横にある3点リーダーアイコンをクリックし、有効期限の変更（Change Expiration）を選択します。
新しいトークンの有効期限を選択し、保存（Save）をクリックします。
操作が成功したかどうかを示す確認ページが開きます。