Opérations de longue durée

L'API Submission est asynchrone et renvoie une opération de longue durée. Il est possible que l'opération ne soit pas terminée lorsque la méthode renvoie une réponse.

Obtenir l'état d'une opération

Pour interroger l'état d'une opération, procédez comme suit :

Appelez la méthode GET pour le type "Opérations".

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • project-number : numéro de votre projet Google Cloud.
  • operation-id : ID d'opération

Méthode HTTP et URL : 

GET https://webrisk.googleapis.com/v1/projects/project-number/operations/operation-id

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Exécutez la commande suivante : 

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://webrisk.googleapis.com/v1/projects/project-number/operations/operation-id"

PowerShell

Exécutez la commande suivante : 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://webrisk.googleapis.com/v1/projects/project-number/operations/operation-id" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

{
  "name": "projects/project-number/operations/operation-id",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.webrisk.v1.SubmitUriMetadata",
    "state": "RUNNING"
  }
  "done": false,
  ...
}

Comprendre l'état d'une opération

Le champ metadata.state de la réponse indique l'état actuel de l'envoi. Une fois l'opération terminée, le champ state de SubmitUriMetadata est mis à jour. Les états possibles sont les suivants :

  • SUCCEEDED : indique que l'URL envoyée a été ajoutée à la liste de blocage de la navigation sécurisée.
  • CLOSED : indique que l'URL envoyée n'a pas été ajoutée à la liste de blocage de la navigation sécurisée, car elle n'a pas été jugée comme enfreignant les règles de la navigation sécurisée.
  • RUNNING : indique que l'envoi est toujours en cours de traitement.

Comprendre les motifs de l'état CLOSED

Lorsque l'état de l'opération est CLOSED, SubmitUriMetadata peut inclure un champ closed_reason. Ce champ fournit un contexte supplémentaire sur la raison pour laquelle l'envoi a été fermé sans que l'URL soit ajoutée à une liste de blocage.

Les valeurs possibles pour closed_reason sont les suivantes :

  • CLOSED_REASON_UNSPECIFIED: le motif n'est pas spécifié.
  • NO_THREAT_DETECTED:
    • Description : l'URL envoyée a été analysée et n'a pas été jugée comme contenant du contenu malveillant. Cela indique que, selon notre analyse, l'URL ne répond pas aux critères d'ajout à la liste de blocage.
    • Action utilisateur recommandée : aucune autre action n'est généralement requise pour cette URL, car elle n'a pas été jugée comme une menace. Ne renvoyez pas l'URL à plusieurs reprises, sauf si le contenu change et que de nouvelles preuves d'activité malveillante apparaissent.
  • HOST_UNRESOLVABLE:
    • Description : nous n'avons pas pu terminer l'analyse, car le nom d'hôte de l'URL n'a pas pu être résolu par le DNS. Cela signifie souvent que le site Web est en panne, que le domaine n'existe plus ou qu'il y a eu un problème DNS temporaire. Nous ne pouvons pas ajouter d'URL inactives ou d'espace réservé à la liste de blocage.
    • Action utilisateur recommandée:
      • Vérifiez l'URL : assurez-vous que le nom d'hôte est correct, que le site Web est actif et qu'il est accessible au public.
      • Renvoyez l'URL : vous pouvez renvoyer l'URL ultérieurement si vous confirmez que le site est actif.
  • CONTENT_UNREACHABLE:
    • Description : l'analyse n'a pas pu être effectuée, car le contenu du site Web n'a pas pu être atteint. Cela peut se produire pour plusieurs raisons, par exemple :
      • La page Web n'existe plus (il s'agit d'une erreur "404 Not Found").
      • Le serveur du site Web a rencontré une erreur (il s'agit d'une erreur "5xx Server Error").
      • Le site Web peut afficher un contenu différent à notre système d'analyse qu'à un visiteur régulier (il s'agit d'une technique de dissimulation), ce qui empêche une évaluation complète.
    • Action utilisateur recommandée:
      • Vérifiez l'accessibilité : assurez-vous que le contenu malveillant est accessible. Notez que certains sites ne peuvent afficher du contenu malveillant que dans des conditions spécifiques (certaines zones géographiques, certains appareils ou certains navigateurs).
      • Fournissez plus de contexte : si l'URL est accessible dans des conditions spécifiques, renvoyez-la. Utilisez les champs ThreatDiscovery dans SubmitUriRequest pour fournir des informations supplémentaires, telles que la région et la plate-forme où la menace a été observée. Ces informations peuvent augmenter la probabilité d'une analyse réussie.