Ce point d'accès permet d'effectuer différentes opérations sur les fichiers mis en quarantaine.
Point final de la demande
https://<tenant-URL>/api/v1/quarantine
Valid parameters are:
| Clé | Value | Description |
|---|---|---|
token | string | 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 | get-files | download-url | take-action |
|
quarantine_profile_id | ID d'un profil de quarantaine. |
|
starttime | Heure de l'époque Unix (arrondie à la période la plus proche) |
|
endtime | Heure de l'époque Unix (arrondie à la période la plus proche) |
|
file_id | ID d'un fichier, nécessaire pour identifier un fichier. |
|
action | block | allow |
|
Il n'existe pas d'API REST pour télécharger un fichier, car le téléchargement d'un fichier ne se fait pas par l'intermédiaire d'un service web. Il va directement au service API Connector (via une redirection par NGINX).
Un scénario typique de téléchargement de fichiers mis en quarantaine est décrit ci-dessous :
- Obtenez la liste des fichiers en quarantaine en utilisant
op = get-files(commehttps://<tenant-URL>/api/v1/quarantine?token=xxx&op=get-files).- Dans la réponse pour chaque fichier, il y aura un quarantine_profile_id et un file_id pour chaque fichier qui peut être téléchargé.
- Pour chaque fichier, obtenez une URL de téléchargement en utilisant op = download-url
- Les paramètres à transmettre sont le quarantine_profile_id et le file_id renvoyés en 1a. (comme
https://<tenant-URL>/api/v1/quarantine?token=xxx&op= download-url&quarantine_profile_id=<yyy>&file_id=<zzz>)) Cela renvoie une réponse de redirection HTTP (code de réponse 302) et l'emplacement de redirection sera commehttps://<tenant-URL>/quarantine/download?token=<Temp Token>&quarantine_profile_id=<yyy>&file_id=<zzz>Notez que le jeton renvoyé dans l'en-tête de redirection est un jeton temporaire (pas le jeton de l'API REST du locataire). Le service API Connector validera le jeton et répondra avec le fichier demandé.
- Les paramètres à transmettre sont le quarantine_profile_id et le file_id renvoyés en 1a. (comme
- Après avoir téléchargé le fichier et l'avoir examiné, prenez une action (autoriser ou bloquer) en utilisant op = take-action. (comme
https://<tenant-URL>/api/v1/quarantine?token=xxx&op=take-action&action=<allow|block>&quarantine_profile_id=<yyy>&file_id=<zzz>)Notez que le jeton transmis ici est à nouveau le jeton de l'API REST du locataire.