webApplicationFirewallProvider: verify

Namespace: microsoft.graph

Initiate a verification operation for a webApplicationFirewallProvider object. This API triggers provider-specific verification logic and returns a webApplicationFirewallVerificationModel object describing the verification result.

This API is available in the following national cloud deployments.

Global service	US Government L4	US Government L5 (DOD)	China operated by 21Vianet
✅	❌	❌	❌

Permissions

Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.

Permission type	Least privileged permissions	Higher privileged permissions
Delegated (work or school account)	RiskPreventionProviders.ReadWrite.All	Not available.
Delegated (personal Microsoft account)	Not supported.	Not supported.
Application	RiskPreventionProviders.ReadWrite.All	Not available.

Important

In delegated scenarios with work or school accounts, the admin must be assigned a supported Microsoft Entra role or a custom role with a supported role permission. The following least privileged roles are supported for this operation:

External ID User Flow Administrator
Application Administrator
Security Administrator

HTTP request

POST /identity/riskPrevention/webApplicationFirewallProviders/{webApplicationFirewallProviderId}/verify

Optional query parameters

This method supports the $expand OData query parameter.

Request headers

Name	Description
Authorization	Bearer {token}. Required. Learn more about authentication and authorization.
Content-Type	application/json. Required.

Request body

In the request body, supply a JSON representation of the parameters.

The following table lists the parameters that are required when you call this action.

Parameter	Type	Description
hostName	String	The domain name or host to be verified by the web application firewall provider. Required.

Response

If successful, this method returns a 200 OK response code and a webApplicationFirewallVerificationModel object in the response body.

Examples

Example 1: Verify a specific webApplicationFirewallProvider object

The following example shows how to verify a webApplicationFirewallProvider using the hostName only.

Request

The following example shows a request.

POST https://graph.microsoft.com/v1.0/identity/riskPrevention/webApplicationFirewallProviders/{webApplicationFirewallProviderId}/verify
Content-Type: application/json

{
  "hostName": "www.contoso.com"
}


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Identity.RiskPrevention.WebApplicationFirewallProviders.Item.Verify;

var requestBody = new VerifyPostRequestBody
{
	HostName = "www.contoso.com",
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Identity.RiskPrevention.WebApplicationFirewallProviders["{webApplicationFirewallProvider-id}"].Verify.PostAsync(requestBody);



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphidentity "github.com/microsoftgraph/msgraph-sdk-go/identity"
	  //other-imports
)

requestBody := graphidentity.NewVerifyPostRequestBody()
hostName := "www.contoso.com"
requestBody.SetHostName(&hostName) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
verify, err := graphClient.Identity().RiskPrevention().WebApplicationFirewallProviders().ByWebApplicationFirewallProviderId("webApplicationFirewallProvider-id").Verify().Post(context.Background(), requestBody, nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

com.microsoft.graph.identity.riskprevention.webapplicationfirewallproviders.item.verify.VerifyPostRequestBody verifyPostRequestBody = new com.microsoft.graph.identity.riskprevention.webapplicationfirewallproviders.item.verify.VerifyPostRequestBody();
verifyPostRequestBody.setHostName("www.contoso.com");
var result = graphClient.identity().riskPrevention().webApplicationFirewallProviders().byWebApplicationFirewallProviderId("{webApplicationFirewallProvider-id}").verify().post(verifyPostRequestBody);


const options = {
	authProvider,
};

const client = Client.init(options);

const webApplicationFirewallVerificationModel = {
  hostName: 'www.contoso.com'
};

await client.api('/identity/riskPrevention/webApplicationFirewallProviders/{webApplicationFirewallProviderId}/verify')
	.post(webApplicationFirewallVerificationModel);


<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Identity\RiskPrevention\WebApplicationFirewallProviders\Item\Verify\VerifyPostRequestBody;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new VerifyPostRequestBody();
$requestBody->setHostName('www.contoso.com');

$result = $graphServiceClient->identity()->riskPrevention()->webApplicationFirewallProviders()->byWebApplicationFirewallProviderId('webApplicationFirewallProvider-id')->verify()->post($requestBody)->wait();


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.identity.riskprevention.webapplicationfirewallproviders.item.verify.verify_post_request_body import VerifyPostRequestBody
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = VerifyPostRequestBody(
	host_name = "www.contoso.com",
)

result = await graph_client.identity.risk_prevention.web_application_firewall_providers.by_web_application_firewall_provider_id('webApplicationFirewallProvider-id').verify.post(request_body)

Response

The following example shows the response.

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.webApplicationFirewallVerificationModel",
    "id": "00000000-0000-0000-0000-000000000000",
    "verifiedHost": "www.contoso.com",
    "providerType": "cloudflare",
    "verificationResult": {
        "status": "success",
        "verifiedOnDateTime": "2025-10-04T00:50:26.4909654Z",
        "errors": [],
        "warnings": []
    },
    "verifiedDetails": {
        "@odata.type": "#microsoft.graph.cloudFlareVerifiedDetailsModel",
        "zoneId": "11111111111111111111111111111111",
        "dnsConfiguration": {
            "name": "www.contoso.com",
            "isProxied": true,
            "recordType": "cname",
            "value": "contoso.azurefd.net",
            "isDomainVerified": true
        },
        "enabledRecommendedRulesets": [
            {
                "rulesetId": "22222222222222222222222222222222",
                "name": "CloudFlare Managed Ruleset",
                "phaseName": "http_request_firewall_managed"
            }
        ],
        "enabledCustomRules": [
            {
                "ruleId": "33333333333333333333333333333333",
                "name": "Block SQL Injection",
                "action": "block"
            },
            {
                "ruleId": "44444444444444444444444444444444",
                "name": "Block XSS",
                "action": "block"
            }
        ]
    }
}

Example 2: Verify a specific webApplicationFirewallProviders object along with the details of their associated provider.

Request

The following example shows a request.

POST https://graph.microsoft.com/v1.0/identity/riskPrevention/webApplicationFirewallProviders/{webApplicationFirewallProviderId}/verify?$expand=provider

{
    hostName: "www.contoso.com"
}

Snippet not available

Snippet not available

Snippet not available


const options = {
	authProvider,
};

const client = Client.init(options);

const webApplicationFirewallVerificationModel = {
    hostName: 'www.contoso.com'
};

await client.api('/identity/riskPrevention/webApplicationFirewallProviders/{webApplicationFirewallProviderId}/verify')
	.post(webApplicationFirewallVerificationModel);

Snippet not available

Snippet not available

Response

The following example shows the response.

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.webApplicationFirewallVerificationModel",
    "id": "00000000-0000-0000-0000-000000000000",
    "verifiedHost": "www.contoso.com",
    "providerType": "cloudflare",
    "verificationResult": {
        "status": "success",
        "verifiedOnDateTime": "2025-10-04T00:50:26.4909654Z",
        "errors": [],
        "warnings": []
    },
    "verifiedDetails": {
        "@odata.type": "#microsoft.graph.cloudFlareVerifiedDetailsModel",
        "zoneId": "11111111111111111111111111111111",
        "dnsConfiguration": {
            "name": "www.contoso.com",
            "isProxied": true,
            "recordType": "cname",
            "value": "contoso.azurefd.net",
            "isDomainVerified": true
        },
        "enabledRecommendedRulesets": [
            {
                "rulesetId": "22222222222222222222222222222222",
                "name": "CloudFlare Managed Ruleset",
                "phaseName": "http_request_firewall_managed"
            }
        ],
        "enabledCustomRules": [
            {
                "ruleId": "33333333333333333333333333333333",
                "name": "Block SQL Injection",
                "action": "block"
            },
            {
                "ruleId": "44444444444444444444444444444444",
                "name": "Block XSS",
                "action": "block"
            }
        ]
    },
    "provider": {
        "@odata.type": "#microsoft.graph.cloudFlareWebApplicationFirewallProvider",
        "id": "55555555-5555-5555-5555-555555555555",
        "displayName": "CloudFlare Provider Example",
        "zoneId": "11111111111111111111111111111111"
    }
}

Feedback

Was this page helpful?

Last updated on 2025-12-03

Share via

webApplicationFirewallProvider: verify

Permissions

HTTP request

Optional query parameters

Request headers

Request body

Response

Examples

Example 1: Verify a specific webApplicationFirewallProvider object

Request

Response

Example 2: Verify a specific webApplicationFirewallProviders object along with the details of their associated provider.

Request

Response

Feedback

Additional resources