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
| 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"
}
// 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);
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"
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)
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);
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);
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);
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);
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\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();
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.
Import-Module Microsoft.Graph.Identity.SignIns
$params = @{
"@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"
}
New-MgIdentityRiskPreventionWebApplicationFirewallProvider -BodyParameter $params
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.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)
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 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"
}
// 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);
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"
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)
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);
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);
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);
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);
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\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();
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.
Import-Module Microsoft.Graph.Identity.SignIns
$params = @{
"@odata.type" = "#microsoft.graph.cloudFlareWebApplicationFirewallProvider"
displayName = "Cloudflare Provider Example"
zoneId = "11111111111111111111111111111111"
apiToken = "cf_example_token_123"
}
New-MgIdentityRiskPreventionWebApplicationFirewallProvider -BodyParameter $params
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.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)
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 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"
}