Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Espace de noms: microsoft.graph
Mettez à jour les propriétés d’un objet webApplicationFirewallProvider .
Cette API est disponible dans les déploiements de cloud national suivants.
| Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Autorisations
Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
| Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
|---|---|---|
| Déléguée (compte professionnel ou scolaire) | RiskPreventionProviders.ReadWrite.All | Non disponible. |
| Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
| Application | RiskPreventionProviders.ReadWrite.All | Non disponible. |
Importante
Dans les scénarios délégués avec des comptes professionnels ou scolaires, l’administrateur doit se voir attribuer un rôle Microsoft Entra pris en charge ou un rôle personnalisé avec une autorisation de rôle prise en charge. Les rôles les moins privilégiés suivants sont pris en charge pour cette opération :
- administrateur de flux utilisateur ID externe
- Administrateur de l'application
- Administrateur de sécurité
Requête HTTP
PATCH /identity/riskPrevention/webApplicationFirewallProviders/{webApplicationFirewallProviderId}
En-têtes de demande
| Nom | Description |
|---|---|
| Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
| Content-Type | application/json. Obligatoire. |
Corps de la demande
Dans le corps de la demande, fournissez uniquement les valeurs des propriétés à mettre à jour. Les propriétés existantes qui ne sont pas incluses dans le corps de la demande conservent leurs valeurs précédentes ou sont recalculées en fonction des modifications apportées à d’autres valeurs de propriété.
Le tableau suivant spécifie les propriétés qui peuvent être mises à jour.
Vous devez spécifier la propriété @odata.type pour spécifier le type d’objet webApplicationFirewallProvider à mettre à jour. Par exemple, « @odata.type » : « #microsoft.graph.akamaiWebApplicationFirewallProvider ».
| Propriété | Type | Description |
|---|---|---|
| displayName | String | Nom complet convivial de la configuration du fournisseur Web Application Firewall. |
| accessToken | String | Jeton d’accès de l’API Akamai utilisé pour l’authentification auprès du compte Akamai. Contactez votre Customer Success Manager Akamai pour obtenir de l’aide sur votre accessToken. Pris en charge pour Akamai uniquement. |
| clientSecret | String | Clé secrète client de l’API Akamai utilisée conjointement avec le jeton client et le jeton d’accès pour l’authentification. Contactez votre Customer Success Manager Akamai pour obtenir de l’aide sur ces informations. Pris en charge pour Akamai uniquement. |
| clientToken | String | Jeton client de l’API Akamai utilisé pour l’authentification auprès du compte Akamai. Contactez votre Customer Success Manager Akamai pour obtenir de l’aide sur ces informations. Pris en charge pour Akamai uniquement. |
| hostPrefix | String | Préfixe utilisé pour identifier l’hôte ou le domaine dans les opérations de configuration Akamai. Cette valeur peut être requise pour certains appels d’API ou scénarios de configuration. Pris en charge pour Akamai uniquement. |
| apiToken | String | Jeton ou informations d’identification de l’API Cloudflare utilisés par les services Microsoft pour s’authentifier auprès du compte Cloudflare. Pour obtenir de l’aide sur votre apitoken, contactez votre responsable de réussite client Cloudflare. Pris en charge pour Cloudflare uniquement. |
| zoneId | String | ID de zone Cloudflare par défaut associé à cette configuration de fournisseur. Cet ID identifie la zone DNS dans Cloudflare qui est couramment utilisée pour les opérations de vérification et de configuration du fournisseur. Pris en charge pour Cloudflare uniquement. |
Réponse
Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet webApplicationFirewallProvider mis à jour dans le corps de la réponse.
Exemples
Demande
L’exemple suivant illustre une demande.
PATCH https://graph.microsoft.com/v1.0/identity/riskPrevention/webApplicationFirewallProviders/{webApplicationFirewallProviderId}
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.cloudFlareWebApplicationFirewallProvider",
"displayName": "String"
}
Réponse
L’exemple suivant illustre la réponse.
Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.cloudFlareWebApplicationFirewallProvider",
"id": "4d8ac75a-e882-18c6-8ad4-2ab20c742e52",
"displayName": "String"
}