このエンドポイントを使用すると、隔離されたファイルに対してさまざまな操作を実行できます。
リクエストエンドポイント
https://<tenant-URL>/api/v1/quarantine
Valid parameters are:
| 鍵 | Value | デスクリプション |
|---|---|---|
token | string | 必須。Netskope UI の REST API ページ ( Settings > Tools > Rest API v1 ) から取得したトークンが必要です。エンドポイント URL ではなく、リクエストの本文にトークンを配置することをお勧めします。 |
op | get-files | download-url | take-action |
|
quarantine_profile_id | 隔離プロファイルのID。 |
|
starttime | Unixエポックタイム（最も近いピリオドに四捨五入） |
|
endtime | Unixエポックタイム（最も近いピリオドに四捨五入） |
|
file_id | ファイルを識別するために必要なファイルID。 |
|
action | block | allow |
|
ファイルのダウンロードはウェブサービスを介して行われないため、実際にファイルをダウンロードするためのREST APIは存在しません。 これは（NGINXを経由したリダイレクトによって）APIコネクタサービスに直接接続されます。
隔離されたファイルをダウンロードする際の典型的なシナリオを以下に示します。
- 隔離されたファイルのリストを取得します
op = get-files(例:https://<tenant-URL>/api/v1/quarantine?token=xxx&op=get-files)。- ここで渡されるトークンは、テナントのREST APIトークンです。各ファイルに対するレスポンスには、ダウンロード可能な各ファイルのquarantine_profile_idとfile_idが含まれます。
- ファイルごとにダウンロード URL を取得します op = download-url
- 渡されるパラメータは、1aで返されるquarantine_profile_idとfile_idです。(例:
https://<tenant-URL>/api/v1/quarantine?token=xxx&op= download-url&quarantine_profile_id=<yyy>&file_id=<zzz>)これは HTTP リダイレクト応答 (応答コード 302) を返し、リダイレクト先はhttps://<tenant-URL>/quarantine/download?token=<Temp Token>&quarantine_profile_id=<yyy>&file_id=<zzz>のようになります。リダイレクト ヘッダーで返されるトークンは一時的なトークン (テナント REST API トークンではない) であることに注意してください。このトークンは約30秒間有効です。APIコネクタサービスはトークンを検証し、要求されたファイルを返します。
- 渡されるパラメータは、1aで返されるquarantine_profile_idとfile_idです。(例:
- ファイルをダウンロードして確認した後、アクション（許可またはブロック）を実行します。 op = アクションを実行します。 （のように
https://<tenant-URL>/api/v1/quarantine?token=xxx&op=take-action&action=<allow|block>&quarantine_profile_id=<yyy>&file_id=<zzz>)ここで渡されるトークンは、テナントのREST APIトークンであることに注意してください。