Crear webApplicationFirewallProvider

Espacio de nombres: microsoft.graph

Cree un nuevo objeto webApplicationFirewallProvider . Puede crear uno de los siguientes subtipos derivados de webApplicationFirewallProvider.

Disponibilidad de API

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ❌ ❌ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos 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.ReadWrite.All No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación No admitida. No admitida.

Importante

Para el acceso delegado con cuentas profesionales o educativas, el administrador debe tener asignado un rol compatible con Microsoft Entra o un rol personalizado que conceda los permisos necesarios para esta operación. Esta operación admite los siguientes roles integrados, que proporcionan solo el privilegio mínimo necesario:

  • Administrador de flujo de usuario de identificador externo
  • Administrador de la aplicación
  • Administrador de seguridad

Solicitud HTTP

POST /identity/riskPrevention/webApplicationFirewallProviders

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON del objeto webApplicationFirewallProvider .

Puede especificar las siguientes propiedades al crear un webApplicationFirewallProvider. Debe especificar la propiedad @odata.type para especificar el tipo de webApplicationFirewallProvider que se va a crear; Por ejemplo, @odata.type": "microsoft.graph.AkamaiWebApplicationFirewallProvider".

Propiedad Tipo Descripción
displayName Cadena El nombre para mostrar de esta configuración de proveedor de WAF. Compatible con todos los proveedores. Obligatorio. Heredado de webApplicationFirewallProvider.
accessToken Cadena Token de acceso de la API de Akamai utilizado para autenticarse en la cuenta de Akamai. Póngase en contacto con su gestor de éxito del cliente de Akamai para que le ayude con su accessToken. Solo es compatible con Akamai. Obligatorio.
clientSecret Cadena Secreto de cliente de la API de Akamai utilizado junto con el token de cliente y el token de acceso para la autenticación. Póngase en contacto con su gestor de éxito del cliente de Akamai para obtener ayuda con esta información. Solo es compatible con Akamai. Obligatorio.
clientToken Cadena Token de cliente de la API de Akamai utilizado para la autenticación en la cuenta de Akamai. Póngase en contacto con su gestor de éxito del cliente de Akamai para obtener ayuda con esta información. Solo es compatible con Akamai. Obligatorio.
hostPrefix Cadena Prefijo utilizado para identificar el host o dominio en las operaciones de configuración de Akamai. Este valor puede ser necesario para determinadas llamadas a la API o escenarios de configuración. Solo es compatible con Akamai. Obligatorio.
apiToken Cadena Token o credencial de API de Cloudflare que usan los servicios Microsoft para autenticarse en la cuenta de Cloudflare. Póngase en contacto con su administrador de éxito del cliente de Cloudflare para obtener ayuda con su apitoken. Solo compatible con Cloudflare. Obligatorio.
zoneId Cadena Id. de zona de Cloudflare predeterminado asociado con esta configuración de proveedor. Este identificador identifica la zona DNS en Cloudflare que se utiliza habitualmente para las operaciones de verificación y configuración para el proveedor. Solo compatible con Cloudflare. Obligatorio.

Respuesta

Si tiene éxito, este método devuelve un 201 Created código de respuesta y un objeto webApplicationFirewallProvider en el cuerpo de la respuesta.

Ejemplos

Ejemplo 1: Creación de un nuevo objeto AkamaiWebApplicationFirewallProvider

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

{
    "@odata.type": "#microsoft.graph.akamaiWebApplicationFirewallProvider",
    "displayName": "Akamai Provider Example",
    "hostPrefix": "akab-exampleprefix",
    "clientSecret": "akamai_example_secret_123",
    "clientToken": "akamai_example_token_456",
    "accessToken": "akamai_example_token_789"
}

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 201 Created
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identity/riskPrevention/webApplicationFirewallProviders/$entity",
    "@odata.type": "#microsoft.graph.akamaiWebApplicationFirewallProvider",
    "id": "00000000-0000-0000-0000-000000000002",
    "displayName": "Akamai Provider Example",
    "hostPrefix": "akab-exampleprefix"
}

Ejemplo 2: Crear un nuevo objeto cloudFlareWebApplicationFirewallProvider

Solicitud

En el siguiente ejemplo se muestra una solicitud para crear un nuevo objeto WAF de Cloudflare.

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

{
    "@odata.type": "#microsoft.graph.cloudFlareWebApplicationFirewallProvider",
    "displayName": "Cloudflare Provider Example",
    "zoneId": "11111111111111111111111111111111",
    "apiToken": "cf_example_token_123"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta con el objeto WAF de Cloudflare.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 201 Created
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identity/riskPrevention/webApplicationFirewallProviders/$entity",
    "@odata.type": "#microsoft.graph.cloudFlareWebApplicationFirewallProvider",
    "id": "00000000-0000-0000-0000-000000000001",
    "displayName": "Cloudflare Provider Example",
    "zoneId": "11111111111111111111111111111111"
}