Foire aux questions de l'API Wildfire (FAQ)
39380
Created On 09/26/18 19:12 PM - Last Modified 04/19/24 19:28 PM
Symptom
Cet article sert de maison pour les questions fréquemment posées sur l’API WildFire.Pour plus de questions techniques, visitez la page de documentation technique de Palo Alto Networks pour WildFire.
Environment
- Wildfire
- Api
Resolution
1. Quelles sont les limites quotidiennes de requête/téléchargement de l’API WildFire ?
Pour les clients NGFW, chaque client abonné à l’abonnement WildFire reçoit une clé API avec les limites quotidiennes suivantes*.
- Téléchargements/soumissions : 150
- Requêtes: 1050
* Les limites de l’API WildFire attachées à l’abonnement WildFire sont sujettes à changement.
2. Mes limites de clés API WildFire sont insuffisantes, puis-je les augmenter ?
Vous pouvez acheter un abonnement distinct à l’API WildFire autonome et choisir le volume requis de soumissions et de requêtes quotidiennes dans des volumes de 2 500 soumissions et 17 500 requêtes. Cet abonnement WildFire autonome ne nécessite pas l’achat d’un NGFW. Contactez votre compte ou votre équipe d’ingénierie commerciale pour plus d’informations.
3. Que se passe-t-il lorsque vous atteignez la limite de téléchargement quotidienne ?
Lorsque la limite d’API pour les téléchargements/requêtes quotidiens est atteinte, les futurs téléchargements/requêtes sont bloqués respectivement. L’API WildFire répondra aux demandes avec le message d’erreur « Quota dépassé ».
4. Les limites inutilisées sont-elles reportées au lendemain?
Non. Les limites sont réinitialisées tous les jours à 0:00 UTC.
5. Existe-t-il une notification par e-mail lorsqu’une limite de téléchargement/requête de clé API est sur le point d’être atteinte ?
Non, pour le moment, une telle fonctionnalité n’est pas prise en charge par WildFire.
6. Lors de l’intégration de la clé API WildFire avec une intégration tierce (telle que Carbon Black de VMware), ces téléchargements sont-ils pris en compte dans la limite quotidienne de téléchargement ?
Oui, toutes les interactions provenant d’intégrations externes 3rd sont comptabilisées dans ces limites, y compris Proofpoint.
7. Lors de l’intégration de la clé API WildFire avec Proofpoint, ces téléchargements sont-ils pris en compte dans la limite quotidienne de téléchargement ?
À compter du 1er février 2023, les téléchargements Proofpoint sont comptabilisés dans la limite quotidienne.
8. La communication NGFW (Next-Generation Firewall) de Palo Alto Networks (téléchargements/requêtes) avec WildFire est-elle prise en compte dans l’utilisation de la clé de l’API WildFire ?
Non, la communication entre la NGFW et WildFire n’est pas comptabilisée dans les limites quotidiennes de clé de l’API WildFire.
9. Comment les téléchargements manuels sont-ils pris en compte ?
Chaque téléchargement manuel vers le portail WildFire compte dans la limite de téléchargement de clé de l’API WildFire.
10. Que signifie « limite de téléchargement manuel:5 » dans le portail WildFire ?
Les utilisateurs du portail d’assistance clientèle de Palo Alto Networks sans licence WildFire valide sont limités à 5 téléchargements manuels sur le portail WildFire par jour.
11. Comment la limite quotidienne est-elle consommée?
La limite quotidienne est consommée lorsque les demandes sont effectuées à l’aide de l’API WildFire. La limite est comptée par demande, ce qui signifie que si la même demande est effectuée plusieurs fois à l’aide de l’API, le nombre de demandes sera consommé et déduit de la limite. Cela se produit même s'il n'y a pas de réponse valide pour la demande. Par exemple, une clé API est consommée même si une requête est effectuée pour un hachage inconnu du cloud WildFire. De la même manière, si vous tentez de télécharger un fichier non pris en charge dans le cloud, le fichier ne sera pas téléchargé mais le nombre de clés API sera consommé.
12. Comment la clé API WildFire est-elle générée ?
La clé API WildFire est générée par le compte de l’entreprise (pas par NGFW ni par abonnement WildFire). Initialement, une seule clé API WildFire est créée par compte client.
Lorsqu’un abonnement WildFire est activé pour la première fois, la clé API est générée immédiatement et automatiquement. Si un NGFW est transféré d’un compte à un autre et si le NGFW l a un abonnement WildFire, la clé API WildFire ne sera PAS générée automatiquement. Dans ce cas, les clients peuvent contacter le support Palo Alto Networks et demander à générer une nouvelle clé API WildFire.
13. Comment la date d’expiration de la clé API WildFire est-elle mise à jour ?
Lorsqu’il existe plusieurs NGFW avec des abonnements WildFire dans un compte client, la dernière date d’expiration parmi tous les abonnements WildFire est utilisée et reflétée comme date d’expiration de la clé API WildFire. Lorsque l’abonnement WildFire est renouvelé, la date d’expiration de la clé API WildFire est mise à jour en conséquence sur la clé existante.
Si un NGFW ll est transféré d’un compte à un autre, la date d’expiration de la clé API WildFire ne sera PAS mise à jour. Dans ce cas, les clients peuvent contacter le support Palo Alto Networks et demander la mise à jour de la date d’expiration de la clé API WildFire.
14. Pourquoi ma clé API Cortex XDR n’est-elle pas visible dans le portail WildFire ?
Il s’agit d’un comportement WildFire attendu et par défaut. La clé API WildFire pour Cortex XDR n’est pas visible dans la vue Compte > Portail WildFire.
15. Je peux obtenir le rapport d’analyse Wildfire de l’échantillon que je ne possède pas avec ma clé API Wildfire. Mais je ne peux pas télécharger les données pcap de l'échantillon et l'échantillon lui-même avec la clé API Wildfire. Est-ce attendu ?
Oui, c’est prévu. Il s’agit d’un comportement actuel, c’est-à-dire que nous autorisons tout client à utiliser une clé API WildFire valide pour afficher et télécharger le rapport. Pour le téléchargement d’échantillons et le téléchargement de pcap, nous vérifions en effet si le client est le propriétaire de l’échantillon ou non; mais pour le téléchargement du rapport, nous n’avons pas ce contrôle de propriété.
2. Mes limites de clés API WildFire sont insuffisantes, puis-je les augmenter ?
Vous pouvez acheter un abonnement distinct à l’API WildFire autonome et choisir le volume requis de soumissions et de requêtes quotidiennes dans des volumes de 2 500 soumissions et 17 500 requêtes. Cet abonnement WildFire autonome ne nécessite pas l’achat d’un NGFW. Contactez votre compte ou votre équipe d’ingénierie commerciale pour plus d’informations.
3. Que se passe-t-il lorsque vous atteignez la limite de téléchargement quotidienne ?
Lorsque la limite d’API pour les téléchargements/requêtes quotidiens est atteinte, les futurs téléchargements/requêtes sont bloqués respectivement. L’API WildFire répondra aux demandes avec le message d’erreur « Quota dépassé ».
4. Les limites inutilisées sont-elles reportées au lendemain?
Non. Les limites sont réinitialisées tous les jours à 0:00 UTC.
5. Existe-t-il une notification par e-mail lorsqu’une limite de téléchargement/requête de clé API est sur le point d’être atteinte ?
Non, pour le moment, une telle fonctionnalité n’est pas prise en charge par WildFire.
6. Lors de l’intégration de la clé API WildFire avec une intégration tierce (telle que Carbon Black de VMware), ces téléchargements sont-ils pris en compte dans la limite quotidienne de téléchargement ?
Oui, toutes les interactions provenant d’intégrations externes 3rd sont comptabilisées dans ces limites, y compris Proofpoint.
7. Lors de l’intégration de la clé API WildFire avec Proofpoint, ces téléchargements sont-ils pris en compte dans la limite quotidienne de téléchargement ?
À compter du 1er février 2023, les téléchargements Proofpoint sont comptabilisés dans la limite quotidienne.
8. La communication NGFW (Next-Generation Firewall) de Palo Alto Networks (téléchargements/requêtes) avec WildFire est-elle prise en compte dans l’utilisation de la clé de l’API WildFire ?
Non, la communication entre la NGFW et WildFire n’est pas comptabilisée dans les limites quotidiennes de clé de l’API WildFire.
9. Comment les téléchargements manuels sont-ils pris en compte ?
Chaque téléchargement manuel vers le portail WildFire compte dans la limite de téléchargement de clé de l’API WildFire.
10. Que signifie « limite de téléchargement manuel:5 » dans le portail WildFire ?
Les utilisateurs du portail d’assistance clientèle de Palo Alto Networks sans licence WildFire valide sont limités à 5 téléchargements manuels sur le portail WildFire par jour.
11. Comment la limite quotidienne est-elle consommée?
La limite quotidienne est consommée lorsque les demandes sont effectuées à l’aide de l’API WildFire. La limite est comptée par demande, ce qui signifie que si la même demande est effectuée plusieurs fois à l’aide de l’API, le nombre de demandes sera consommé et déduit de la limite. Cela se produit même s'il n'y a pas de réponse valide pour la demande. Par exemple, une clé API est consommée même si une requête est effectuée pour un hachage inconnu du cloud WildFire. De la même manière, si vous tentez de télécharger un fichier non pris en charge dans le cloud, le fichier ne sera pas téléchargé mais le nombre de clés API sera consommé.
12. Comment la clé API WildFire est-elle générée ?
La clé API WildFire est générée par le compte de l’entreprise (pas par NGFW ni par abonnement WildFire). Initialement, une seule clé API WildFire est créée par compte client.
Lorsqu’un abonnement WildFire est activé pour la première fois, la clé API est générée immédiatement et automatiquement. Si un NGFW est transféré d’un compte à un autre et si le NGFW l a un abonnement WildFire, la clé API WildFire ne sera PAS générée automatiquement. Dans ce cas, les clients peuvent contacter le support Palo Alto Networks et demander à générer une nouvelle clé API WildFire.
13. Comment la date d’expiration de la clé API WildFire est-elle mise à jour ?
Lorsqu’il existe plusieurs NGFW avec des abonnements WildFire dans un compte client, la dernière date d’expiration parmi tous les abonnements WildFire est utilisée et reflétée comme date d’expiration de la clé API WildFire. Lorsque l’abonnement WildFire est renouvelé, la date d’expiration de la clé API WildFire est mise à jour en conséquence sur la clé existante.
Si un NGFW ll est transféré d’un compte à un autre, la date d’expiration de la clé API WildFire ne sera PAS mise à jour. Dans ce cas, les clients peuvent contacter le support Palo Alto Networks et demander la mise à jour de la date d’expiration de la clé API WildFire.
14. Pourquoi ma clé API Cortex XDR n’est-elle pas visible dans le portail WildFire ?
Il s’agit d’un comportement WildFire attendu et par défaut. La clé API WildFire pour Cortex XDR n’est pas visible dans la vue Compte > Portail WildFire.
15. Je peux obtenir le rapport d’analyse Wildfire de l’échantillon que je ne possède pas avec ma clé API Wildfire. Mais je ne peux pas télécharger les données pcap de l'échantillon et l'échantillon lui-même avec la clé API Wildfire. Est-ce attendu ?
Oui, c’est prévu. Il s’agit d’un comportement actuel, c’est-à-dire que nous autorisons tout client à utiliser une clé API WildFire valide pour afficher et télécharger le rapport. Pour le téléchargement d’échantillons et le téléchargement de pcap, nous vérifions en effet si le client est le propriétaire de l’échantillon ou non; mais pour le téléchargement du rapport, nous n’avons pas ce contrôle de propriété.