Creación de webApplicationFirewallProvider

Espacio de nombres: microsoft.graph

Cree un nuevo objeto webApplicationFirewallProvider . Puede crear uno de los subtipos siguientes que se derivan de webApplicationFirewallProvider.

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.ReadWrite.All	No disponible.
Delegado (cuenta personal de Microsoft)	No admitida.	No admitida.
Aplicación	RiskPreventionProviders.ReadWrite.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
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 la autenticación y la 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	Nombre para mostrar de esta configuración de proveedor de WAF. Compatible con todos los proveedores. Obligatorio. Se hereda de webApplicationFirewallProvider.
accessToken	Cadena	Token de acceso de api de Akamai que se usa para autenticarse en la cuenta de Akamai. Póngase en contacto con el Administrador de éxito de clientes de Akamai para obtener ayuda con su accessToken. Solo se admite para Akamai. Obligatorio.
clientSecret	Cadena	Secreto de cliente de api de Akamai que se usa junto con el token de cliente y el token de acceso para la autenticación. Póngase en contacto con el Administrador de éxito de clientes de Akamai para obtener ayuda con esta información. Solo se admite para Akamai. Obligatorio.
clientToken	Cadena	Token de cliente de API de Akamai que se usa para la autenticación en la cuenta de Akamai. Póngase en contacto con el Administrador de éxito de clientes de Akamai para obtener ayuda con esta información. Solo se admite para Akamai. Obligatorio.
hostPrefix	Cadena	Prefijo usado para identificar el host o dominio en las operaciones de configuración de Akamai. Este valor puede ser necesario para determinadas llamadas API o escenarios de configuración. Solo se admite para Akamai. Obligatorio.
apiToken	Cadena	Token o credencial de LA API de Cloudflare que usan los servicios de Microsoft para autenticarse en la cuenta de Cloudflare. Póngase en contacto con el Administrador de éxito del cliente de Cloudflare para obtener ayuda con el apitoken. Solo se admite para Cloudflare. Obligatorio.
zoneId	Cadena	Id. de zona de Cloudflare predeterminado asociado a esta configuración del proveedor. Este identificador identifica la zona DNS en Cloudflare que se usa normalmente para las operaciones de verificación y configuración del proveedor. Solo se admite para Cloudflare. Obligatorio.

Respuesta

Si se ejecuta correctamente, 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"
}


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

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new AkamaiWebApplicationFirewallProvider
{
	OdataType = "#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",
};

// 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.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"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewWebApplicationFirewallProvider()
displayName := "Akamai Provider Example"
requestBody.SetDisplayName(&displayName) 
hostPrefix := "akab-exampleprefix"
requestBody.SetHostPrefix(&hostPrefix) 
clientSecret := "akamai_example_secret_123"
requestBody.SetClientSecret(&clientSecret) 
clientToken := "akamai_example_token_456"
requestBody.SetClientToken(&clientToken) 
accessToken := "akamai_example_token_789"
requestBody.SetAccessToken(&accessToken) 

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


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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

AkamaiWebApplicationFirewallProvider webApplicationFirewallProvider = new AkamaiWebApplicationFirewallProvider();
webApplicationFirewallProvider.setOdataType("#microsoft.graph.akamaiWebApplicationFirewallProvider");
webApplicationFirewallProvider.setDisplayName("Akamai Provider Example");
webApplicationFirewallProvider.setHostPrefix("akab-exampleprefix");
webApplicationFirewallProvider.setClientSecret("akamai_example_secret_123");
webApplicationFirewallProvider.setClientToken("akamai_example_token_456");
webApplicationFirewallProvider.setAccessToken("akamai_example_token_789");
WebApplicationFirewallProvider result = graphClient.identity().riskPrevention().webApplicationFirewallProviders().post(webApplicationFirewallProvider);


const options = {
	authProvider,
};

const client = Client.init(options);

const webApplicationFirewallProvider = {
    '@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'
};

await client.api('/identity/riskPrevention/webApplicationFirewallProviders')
	.post(webApplicationFirewallProvider);


<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\AkamaiWebApplicationFirewallProvider;


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

$requestBody = new AkamaiWebApplicationFirewallProvider();
$requestBody->setOdataType('#microsoft.graph.akamaiWebApplicationFirewallProvider');
$requestBody->setDisplayName('Akamai Provider Example');
$requestBody->setHostPrefix('akab-exampleprefix');
$requestBody->setClientSecret('akamai_example_secret_123');
$requestBody->setClientToken('akamai_example_token_456');
$requestBody->setAccessToken('akamai_example_token_789');

$result = $graphServiceClient->identity()->riskPrevention()->webApplicationFirewallProviders()->post($requestBody)->wait();


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.akamai_web_application_firewall_provider import AkamaiWebApplicationFirewallProvider
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = AkamaiWebApplicationFirewallProvider(
	odata_type = "#microsoft.graph.akamaiWebApplicationFirewallProvider",
	display_name = "Akamai Provider Example",
	host_prefix = "akab-exampleprefix",
	client_secret = "akamai_example_secret_123",
	client_token = "akamai_example_token_456",
	access_token = "akamai_example_token_789",
)

result = await graph_client.identity.risk_prevention.web_application_firewall_providers.post(request_body)

Respuesta

En el ejemplo siguiente se muestra la respuesta.

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: Creación de un nuevo objeto cloudFlareWebApplicationFirewallProvider

Solicitud

En el ejemplo siguiente 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"
}


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

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new CloudFlareWebApplicationFirewallProvider
{
	OdataType = "#microsoft.graph.cloudFlareWebApplicationFirewallProvider",
	DisplayName = "Cloudflare Provider Example",
	ZoneId = "11111111111111111111111111111111",
	ApiToken = "cf_example_token_123",
};

// 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.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"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewWebApplicationFirewallProvider()
displayName := "Cloudflare Provider Example"
requestBody.SetDisplayName(&displayName) 
zoneId := "11111111111111111111111111111111"
requestBody.SetZoneId(&zoneId) 
apiToken := "cf_example_token_123"
requestBody.SetApiToken(&apiToken) 

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


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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

CloudFlareWebApplicationFirewallProvider webApplicationFirewallProvider = new CloudFlareWebApplicationFirewallProvider();
webApplicationFirewallProvider.setOdataType("#microsoft.graph.cloudFlareWebApplicationFirewallProvider");
webApplicationFirewallProvider.setDisplayName("Cloudflare Provider Example");
webApplicationFirewallProvider.setZoneId("11111111111111111111111111111111");
webApplicationFirewallProvider.setApiToken("cf_example_token_123");
WebApplicationFirewallProvider result = graphClient.identity().riskPrevention().webApplicationFirewallProviders().post(webApplicationFirewallProvider);


const options = {
	authProvider,
};

const client = Client.init(options);

const webApplicationFirewallProvider = {
    '@odata.type': '#microsoft.graph.cloudFlareWebApplicationFirewallProvider',
    displayName: 'Cloudflare Provider Example',
    zoneId: '11111111111111111111111111111111',
    apiToken: 'cf_example_token_123'
};

await client.api('/identity/riskPrevention/webApplicationFirewallProviders')
	.post(webApplicationFirewallProvider);


<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\CloudFlareWebApplicationFirewallProvider;


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

$requestBody = new CloudFlareWebApplicationFirewallProvider();
$requestBody->setOdataType('#microsoft.graph.cloudFlareWebApplicationFirewallProvider');
$requestBody->setDisplayName('Cloudflare Provider Example');
$requestBody->setZoneId('11111111111111111111111111111111');
$requestBody->setApiToken('cf_example_token_123');

$result = $graphServiceClient->identity()->riskPrevention()->webApplicationFirewallProviders()->post($requestBody)->wait();


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.cloud_flare_web_application_firewall_provider import CloudFlareWebApplicationFirewallProvider
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = CloudFlareWebApplicationFirewallProvider(
	odata_type = "#microsoft.graph.cloudFlareWebApplicationFirewallProvider",
	display_name = "Cloudflare Provider Example",
	zone_id = "11111111111111111111111111111111",
	api_token = "cf_example_token_123",
)

result = await graph_client.identity.risk_prevention.web_application_firewall_providers.post(request_body)

Respuesta

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

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"
}

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-12-04

Compartir a través de

Creación de webApplicationFirewallProvider

Permissions

Solicitud HTTP

Encabezados de solicitud

Cuerpo de la solicitud

Respuesta

Ejemplos

Ejemplo 1: Creación de un nuevo objeto AkamaiWebApplicationFirewallProvider

Solicitud

Respuesta

Ejemplo 2: Creación de un nuevo objeto cloudFlareWebApplicationFirewallProvider

Solicitud

Respuesta

Comentarios

Recursos adicionales