Gérer les fichiers de quarantaine - Documentation technique Netskope

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`	`get-files`: Permet d'obtenir la liste des fichiers en quarantaine. `download-url`: Permet d'obtenir l'URL à utiliser pour le téléchargement d'un fichier. La réponse sera une redirection HTTP (code de réponse 302). `take-action`: Action à entreprendre pour un SEUL fichier en quarantaine.
`quarantine_profile_id`	ID d'un profil de quarantaine.	Ceci est nécessaire pour `op=download-url`. Également nécessaire pour `op=take-action`.
`starttime`	Heure de l'époque Unix (arrondie à la période la plus proche)	Utiliser pour `op=get-files`. Obtenez les fichiers modifiés pour la dernière fois au cours d'une période donnée. Ces paramètres sont facultatifs. Si elle n'est pas fournie, `starttime` est supposée être 0 et `endtime` est supposée être l'heure actuelle.
`endtime`	Heure de l'époque Unix (arrondie à la période la plus proche)	Utiliser pour `op=get-files`. Obtenez les fichiers modifiés pour la dernière fois au cours d'une période donnée. Ces paramètres sont facultatifs. Si elle n'est pas fournie, `starttime` est supposée être 0 et `endtime` est supposée être l'heure actuelle.
`file_id`	ID d'un fichier, nécessaire pour identifier un fichier.	Nécessaire pour `op=download-url`. Nécessaire pour `op=take-action`.
`action`	`block \| allow`	Action à effectuer sur un fichier en quarantaine. `action = block` signifie que le fichier en quarantaine sera supprimé. `action = allow` signifie que le fichier mis en quarantaine sera restauré.

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 (comme https://<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 comme https://<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é.
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.