Espacio de nombres: microsoft.graph
Lea las propiedades y relaciones del objeto webApplicationFirewallVerificationModel .
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global |
Gobierno de EE. UU. L4 |
Us Government L5 (DOD) |
China operada por 21Vianet |
| ✅ |
❌ |
❌ |
❌ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
| Tipo de permiso |
Permisos con privilegios mínimos |
Permisos con privilegios más altos |
| Delegado (cuenta profesional o educativa) |
RiskPreventionProviders.Read.All |
RiskPreventionProviders.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) |
No admitida. |
No admitida. |
| Aplicación |
RiskPreventionProviders.Read.All |
RiskPreventionProviders.ReadWrite.All |
Importante
En escenarios delegados con cuentas profesionales o educativas, al administrador se le debe asignar un rol de Microsoft Entra compatible o un rol personalizado con un permiso de rol admitido. Se admiten los siguientes roles con privilegios mínimos para esta operación:
- administrador de flujo de usuario de Id. externa
- Administrador de la aplicación
- Lector de directorios
- Lector de seguridad
- Administrador de seguridad
Solicitud HTTP
GET /identity/riskPrevention/webApplicationFirewallVerifications/{webApplicationFirewallVerificationModelId}
Parámetros de consulta opcionales
Este método admite el parámetro de $expandconsulta OData.
Cuerpo de la solicitud
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto webApplicationFirewallVerificationModel en el cuerpo de la respuesta.
Ejemplos
Ejemplo 1: Recuperar un objeto webApplicationFirewallVerifications específico.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
GET https://graph.microsoft.com/v1.0/identity/riskPrevention/webApplicationFirewallVerifications/{webApplicationFirewallVerificationModelId}
// Code snippets are only available for the latest version. Current version is 5.x
// 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.WebApplicationFirewallVerifications["{webApplicationFirewallVerificationModel-id}"].GetAsync();
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
// 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"
//other-imports
)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
webApplicationFirewallVerifications, err := graphClient.Identity().RiskPrevention().WebApplicationFirewallVerifications().ByWebApplicationFirewallVerificationModelId("webApplicationFirewallVerificationModel-id").Get(context.Background(), nil)
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
WebApplicationFirewallVerificationModel result = graphClient.identity().riskPrevention().webApplicationFirewallVerifications().byWebApplicationFirewallVerificationModelId("{webApplicationFirewallVerificationModel-id}").get();
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
const options = {
authProvider,
};
const client = Client.init(options);
let webApplicationFirewallVerificationModel = await client.api('/identity/riskPrevention/webApplicationFirewallVerifications/{webApplicationFirewallVerificationModelId}')
.get();
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
<?php
use Microsoft\Graph\GraphServiceClient;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$result = $graphServiceClient->identity()->riskPrevention()->webApplicationFirewallVerifications()->byWebApplicationFirewallVerificationModelId('webApplicationFirewallVerificationModel-id')->get()->wait();
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
result = await graph_client.identity.risk_prevention.web_application_firewall_verifications.by_web_application_firewall_verification_model_id('webApplicationFirewallVerificationModel-id').get()
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
Respuesta
En el ejemplo siguiente se muestra la respuesta.
Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.
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"
}
]
}
}
Ejemplo 2: Recuperación de un objeto webApplicationFirewallVerifications específico junto con los detalles de su proveedor asociado
Solicitud
En el ejemplo siguiente se muestra la solicitud.
GET https://graph.microsoft.com/v1.0/identity/riskPrevention/webApplicationFirewallVerifications/{webApplicationFirewallVerificationModelId}?$expand=provider
// Code snippets are only available for the latest version. Current version is 5.x
// 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.WebApplicationFirewallVerifications["{webApplicationFirewallVerificationModel-id}"].GetAsync((requestConfiguration) =>
{
requestConfiguration.QueryParameters.Expand = new string []{ "provider" };
});
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
// 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
)
requestParameters := &graphidentity.RiskPreventionWebApplicationFirewallVerificationsItemRequestBuilderGetQueryParameters{
Expand: [] string {"provider"},
}
configuration := &graphidentity.RiskPreventionWebApplicationFirewallVerificationsItemRequestBuilderGetRequestConfiguration{
QueryParameters: requestParameters,
}
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
webApplicationFirewallVerifications, err := graphClient.Identity().RiskPrevention().WebApplicationFirewallVerifications().ByWebApplicationFirewallVerificationModelId("webApplicationFirewallVerificationModel-id").Get(context.Background(), configuration)
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
WebApplicationFirewallVerificationModel result = graphClient.identity().riskPrevention().webApplicationFirewallVerifications().byWebApplicationFirewallVerificationModelId("{webApplicationFirewallVerificationModel-id}").get(requestConfiguration -> {
requestConfiguration.queryParameters.expand = new String []{"provider"};
});
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
const options = {
authProvider,
};
const client = Client.init(options);
let webApplicationFirewallVerificationModel = await client.api('/identity/riskPrevention/webApplicationFirewallVerifications/{webApplicationFirewallVerificationModelId}')
.expand('provider')
.get();
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Identity\RiskPrevention\WebApplicationFirewallVerifications\Item\WebApplicationFirewallVerificationModelItemRequestBuilderGetRequestConfiguration;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestConfiguration = new WebApplicationFirewallVerificationModelItemRequestBuilderGetRequestConfiguration();
$queryParameters = WebApplicationFirewallVerificationModelItemRequestBuilderGetRequestConfiguration::createQueryParameters();
$queryParameters->expand = ["provider"];
$requestConfiguration->queryParameters = $queryParameters;
$result = $graphServiceClient->identity()->riskPrevention()->webApplicationFirewallVerifications()->byWebApplicationFirewallVerificationModelId('webApplicationFirewallVerificationModel-id')->get($requestConfiguration)->wait();
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.identity.risk_prevention.web_application_firewall_verifications.item.web_application_firewall_verification_model_item_request_builder import WebApplicationFirewallVerificationModelItemRequestBuilder
from kiota_abstractions.base_request_configuration import RequestConfiguration
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
query_params = WebApplicationFirewallVerificationModelItemRequestBuilder.WebApplicationFirewallVerificationModelItemRequestBuilderGetQueryParameters(
expand = ["provider"],
)
request_configuration = RequestConfiguration(
query_parameters = query_params,
)
result = await graph_client.identity.risk_prevention.web_application_firewall_verifications.by_web_application_firewall_verification_model_id('webApplicationFirewallVerificationModel-id').get(request_configuration = request_configuration)
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
Respuesta
En el ejemplo siguiente se muestra la respuesta.
Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.
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"
}
}