Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Obtenga una lista de los objetos webApplicationFirewallVerificationModel y sus propiedades.
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 | No disponible. |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | RiskPreventionProviders.Read.All | No disponible. |
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
Parámetros de consulta opcionales
Este método admite algunos de los parámetros de consulta de OData, incluidos $filter y $expand para incluir recursos relacionados. Para obtener información general, vea Parámetros de consulta OData.
Encabezados de solicitud
| Nombre | Descripción |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
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 una colección de objetos webApplicationFirewallVerificationModel en el cuerpo de la respuesta.
Ejemplos
Ejemplo 1: Recuperar todas las webApplicationFirewallVerifications.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
GET https://graph.microsoft.com/v1.0/identity/riskPrevention/webApplicationFirewallVerifications
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#identity/riskPrevention/webApplicationFirewallVerifications(provider())",
"value": [
{
"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: Recupere todas las webApplicationFirewallVerifications 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?$expand=provider
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#identity/riskPrevention/webApplicationFirewallVerifications(provider())",
"value": [
{
"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.context": "https://graph.microsoft.com/v1.0/$metadata#identity/riskPrevention/webApplicationFirewallVerifications('00000000-0000-0000-0000-000000000000')/webApplicationFirewallProviders",
"provider": {
"@odata.type": "#microsoft.graph.cloudFlareWebApplicationFirewallProvider",
"id": "55555555-5555-5555-5555-555555555555",
"displayName": "CloudFlare Provider Example",
"zoneId": "11111111111111111111111111111111"
}
}
]
}