Criar webApplicationFirewallProvider

Namespace: microsoft.graph

Crie um novo objeto webApplicationFirewallProvider . Pode criar um dos seguintes subtipos derivados de webApplicationFirewallProvider.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global	US Government L4	US Government L5 (DOD)	China operada pela 21Vianet
✅	❌	❌	❌

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão	Permissões com menos privilégios	Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante)	RiskPreventionProviders.ReadWrite.All	Indisponível.
Delegado (conta pessoal da Microsoft)	Sem suporte.	Sem suporte.
Application	RiskPreventionProviders.ReadWrite.All	Indisponível.

Importante

Em cenários delegados com contas escolares ou profissionais, tem de ser atribuída ao administrador uma função de Microsoft Entra suportada ou uma função personalizada com uma permissão de função suportada. As seguintes funções com menos privilégios são suportadas para esta operação:

Administrador do Fluxo de Utilizador ID externa
Administrador de Aplicativos
Administrador de Segurança

Solicitação HTTP

POST /identity/riskPrevention/webApplicationFirewallProviders

Cabeçalhos de solicitação

Nome	Descrição
Autorização	{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type	application/json. Obrigatório.

Corpo da solicitação

No corpo do pedido, forneça uma representação JSON do objeto webApplicationFirewallProvider .

Pode especificar as seguintes propriedades ao criar um webApplicationFirewallProvider. Tem de especificar a propriedade @odata.type para especificar o tipo de webApplicationFirewallProvider a criar; por exemplo, @odata.type": "microsoft.graph.AkamaiWebApplicationFirewallProvider".

Propriedade	Tipo	Descrição
displayName	Cadeia de caracteres	O nome a apresentar desta configuração do fornecedor de WAF. Suportado para todos os fornecedores. Obrigatório. Herdado de webApplicationFirewallProvider.
accessToken	Cadeia de caracteres	Token de acesso da API Akamai utilizado para autenticar na conta Akamai. Contacte o Gestor de Sucesso do Cliente da Akamai para obter assistência com o accessToken. Suportado apenas para Akamai. Obrigatório.
clientSecret	Cadeia de caracteres	Segredo do cliente da API Akamai utilizado em conjunto com o token de cliente e o token de acesso para autenticação. Contacte o Gestor de Sucesso do Cliente da Akamai para obter assistência com estas informações. Suportado apenas para Akamai. Obrigatório.
clientToken	Cadeia de caracteres	Token de cliente da API Akamai utilizado para autenticação na conta Akamai. Contacte o Gestor de Sucesso do Cliente da Akamai para obter assistência com estas informações. Suportado apenas para Akamai. Obrigatório.
hostPrefix	Cadeia de caracteres	Prefixo utilizado para identificar o anfitrião ou domínio nas operações de configuração do Akamai. Este valor pode ser necessário para determinadas chamadas à API ou cenários de configuração. Suportado apenas para Akamai. Obrigatório.
apiToken	Cadeia de caracteres	Token ou credencial da API do Cloudflare utilizado pelos serviços Da Microsoft para autenticar na conta do Cloudflare. Contacte o Gestor de Sucesso do Cliente do Cloudflare para obter assistência com o seu apitoken. Suportado apenas para Cloudflare. Obrigatório.
zoneId	Cadeia de caracteres	ID de Zona do Cloudflare predefinido associado a esta configuração do fornecedor. Este ID identifica a zona DNS no Cloudflare que é normalmente utilizada para operações de verificação e configuração para o fornecedor. Suportado apenas para Cloudflare. Obrigatório.

Resposta

Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto webApplicationFirewallProvider no corpo da resposta.

Exemplos

Exemplo 1: criar um novo objeto AkamaiWebApplicationFirewallProvider

Solicitação

O exemplo a seguir mostra uma solicitação.

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)

Resposta

O exemplo a seguir mostra a resposta.

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

Exemplo 2: Criar um novo objeto cloudFlareWebApplicationFirewallProvider

Solicitação

O exemplo seguinte mostra um pedido para criar um novo objeto WAF do 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)

Resposta

O exemplo seguinte mostra a resposta com o objeto WAF do 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"
}

Comentários

Esta página foi útil?

Last updated on 2025-11-19

Compartilhar via

Criar webApplicationFirewallProvider

Permissões

Solicitação HTTP

Cabeçalhos de solicitação

Corpo da solicitação

Resposta

Exemplos

Exemplo 1: criar um novo objeto AkamaiWebApplicationFirewallProvider

Solicitação

Resposta

Exemplo 2: Criar um novo objeto cloudFlareWebApplicationFirewallProvider

Solicitação

Resposta

Comentários

Recursos adicionais