Creación de fraudProtectionProviders

Espacio de nombres: microsoft.graph

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

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	No admitida.	No admitida.

Importante

Para el acceso delegado mediante cuentas profesionales o educativas, se debe asignar al administrador un rol de Microsoft Entra compatible o un rol personalizado que conceda los permisos necesarios para esta operación. Esta operación admite los siguientes roles integrados, que proporcionan solo los privilegios mínimos necesarios:

administrador de flujo de usuario de Id. externa
Administrador de la aplicación
Administrador de seguridad

Solicitud HTTP

POST /identity/riskPrevention/fraudProtectionProviders

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 fraudProtectionProvider .

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

Propiedad	Tipo	Descripción
displayName	Cadena	Nombre para mostrar de esta configuración del proveedor de protección contra fraudes. Compatible con todos los proveedores. Obligatorio. Se hereda de fraudProtectionProvider.
privateKey	Cadena	La clave privada disponible en el portal de Arkose. Póngase en contacto con el administrador de éxito del cliente de Arkose para obtener ayuda con sus claves. Solo se admite para Arkose. Obligatorio.
publicKey	Cadena	Clave pública disponible en el portal de Arkose. Póngase en contacto con el administrador de éxito del cliente de Arkose para obtener ayuda con sus claves. Solo se admite para Arkose. Obligatorio.
verifySubDomain	Cadena	Se usa para invocar el servicio Arkose desde el servidor de autenticación de Microsoft. Solicite a Arkose Customer Success Manager o use el valor predeterminado `verify-api` . Solo se admite para Arkose. Obligatorio.
clientSubDomain	Cadena	Se usa para invocar el servicio Arkose desde la aplicación cliente. Solicite a Arkose Customer Success Manager o use el valor predeterminado `client-api` . Solo se admite para Arkose. Obligatorio.
appId	Cadena	Identificador único de una aplicación individual. Puede recuperarlo desde la consola de administración de HUMAN Security o solicitarlo a Human Security Customer Success Manager. Solo se admite para seguridad humana. Obligatorio.
serverToken	Cadena	Identificador único que se usa para autenticar las llamadas API entre la integración del lado servidor y la plataforma HUMAN. Puede recuperarlo desde la consola de administración de HUMAN Security o solicitarlo a Human Security Customer Success Manager. Solo se admite para seguridad humana. Obligatorio.

Respuesta

Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto fraudProtectionProvider en el cuerpo de la respuesta. La propiedad @odata.type especifica el tipo del objeto creado.

Ejemplos

Ejemplo 1: Creación de un nuevo objeto arkoseFraudProtectionProvider

Solicitud

En el ejemplo siguiente se muestra una solicitud para crear un nuevo objeto FraudProtectionProvider de Arkose.

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

{
   "@odata.type": "#microsoft.graph.arkoseFraudProtectionProvider",
    "displayName": "Arkose Sign-Up Protection",
    "publicKey": "A1EE42E0-C88B-47FE-A176-5E9FB8F116FB",
    "privateKey": "19BBE628-7DEF-4E28-AB25-BF129C760B7E",
    "clientSubDomain": "client-api",
    "verifySubDomain": "verify-api"
}


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

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new ArkoseFraudProtectionProvider
{
	OdataType = "#microsoft.graph.arkoseFraudProtectionProvider",
	DisplayName = "Arkose Sign-Up Protection",
	PublicKey = "A1EE42E0-C88B-47FE-A176-5E9FB8F116FB",
	PrivateKey = "19BBE628-7DEF-4E28-AB25-BF129C760B7E",
	ClientSubDomain = "client-api",
	VerifySubDomain = "verify-api",
};

// To initialize your graphClient, see https://mms.heiai.top/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Identity.RiskPrevention.FraudProtectionProviders.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.NewFraudProtectionProvider()
displayName := "Arkose Sign-Up Protection"
requestBody.SetDisplayName(&displayName) 
publicKey := "A1EE42E0-C88B-47FE-A176-5E9FB8F116FB"
requestBody.SetPublicKey(&publicKey) 
privateKey := "19BBE628-7DEF-4E28-AB25-BF129C760B7E"
requestBody.SetPrivateKey(&privateKey) 
clientSubDomain := "client-api"
requestBody.SetClientSubDomain(&clientSubDomain) 
verifySubDomain := "verify-api"
requestBody.SetVerifySubDomain(&verifySubDomain) 

// To initialize your graphClient, see https://mms.heiai.top/en-us/graph/sdks/create-client?from=snippets&tabs=go
fraudProtectionProviders, err := graphClient.Identity().RiskPrevention().FraudProtectionProviders().Post(context.Background(), requestBody, nil)


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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

ArkoseFraudProtectionProvider fraudProtectionProvider = new ArkoseFraudProtectionProvider();
fraudProtectionProvider.setOdataType("#microsoft.graph.arkoseFraudProtectionProvider");
fraudProtectionProvider.setDisplayName("Arkose Sign-Up Protection");
fraudProtectionProvider.setPublicKey("A1EE42E0-C88B-47FE-A176-5E9FB8F116FB");
fraudProtectionProvider.setPrivateKey("19BBE628-7DEF-4E28-AB25-BF129C760B7E");
fraudProtectionProvider.setClientSubDomain("client-api");
fraudProtectionProvider.setVerifySubDomain("verify-api");
FraudProtectionProvider result = graphClient.identity().riskPrevention().fraudProtectionProviders().post(fraudProtectionProvider);


const options = {
	authProvider,
};

const client = Client.init(options);

const fraudProtectionProvider = {
   '@odata.type': '#microsoft.graph.arkoseFraudProtectionProvider',
    displayName: 'Arkose Sign-Up Protection',
    publicKey: 'A1EE42E0-C88B-47FE-A176-5E9FB8F116FB',
    privateKey: '19BBE628-7DEF-4E28-AB25-BF129C760B7E',
    clientSubDomain: 'client-api',
    verifySubDomain: 'verify-api'
};

await client.api('/identity/riskPrevention/fraudProtectionProviders')
	.post(fraudProtectionProvider);


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


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

$requestBody = new ArkoseFraudProtectionProvider();
$requestBody->setOdataType('#microsoft.graph.arkoseFraudProtectionProvider');
$requestBody->setDisplayName('Arkose Sign-Up Protection');
$requestBody->setPublicKey('A1EE42E0-C88B-47FE-A176-5E9FB8F116FB');
$requestBody->setPrivateKey('19BBE628-7DEF-4E28-AB25-BF129C760B7E');
$requestBody->setClientSubDomain('client-api');
$requestBody->setVerifySubDomain('verify-api');

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


Import-Module Microsoft.Graph.Identity.SignIns

$params = @{
	"@odata.type" = "#microsoft.graph.arkoseFraudProtectionProvider"
	displayName = "Arkose Sign-Up Protection"
	publicKey = "A1EE42E0-C88B-47FE-A176-5E9FB8F116FB"
	privateKey = "19BBE628-7DEF-4E28-AB25-BF129C760B7E"
	clientSubDomain = "client-api"
	verifySubDomain = "verify-api"
}

New-MgIdentityRiskPreventionFraudProtectionProvider -BodyParameter $params


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.arkose_fraud_protection_provider import ArkoseFraudProtectionProvider
# To initialize your graph_client, see https://mms.heiai.top/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = ArkoseFraudProtectionProvider(
	odata_type = "#microsoft.graph.arkoseFraudProtectionProvider",
	display_name = "Arkose Sign-Up Protection",
	public_key = "A1EE42E0-C88B-47FE-A176-5E9FB8F116FB",
	private_key = "19BBE628-7DEF-4E28-AB25-BF129C760B7E",
	client_sub_domain = "client-api",
	verify_sub_domain = "verify-api",
)

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

Respuesta

En el ejemplo siguiente se muestra la respuesta con el objeto FraudProtectionProvider de Arkose.

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

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identity/riskPrevention/fraudProtectionProviders/$entity",
    "@odata.type": "#microsoft.graph.arkoseFraudProtectionProvider",
    "id": "d474f94f-0fcf-4224-a165-c1c5bad1600f",
    "displayName": "Arkose Sign-Up Protection",
    "publicKey": "A1EE42E0-C88B-47FE-A176-5E9FB8F116FB",
    "clientSubDomain": "client-api",
    "verifySubDomain": "verify-api"
}

Ejemplo 2: Creación de un nuevo objeto humanSecurityFraudProtectionProvider

Solicitud

En el ejemplo siguiente se muestra una solicitud para crear un nuevo objeto HUMAN Security fraudProtectionProvider.

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

{
   "@odata.type": "#microsoft.graph.humanSecurityFraudProtectionProvider",
    "displayName": "HUMAN Security Sign-Up Protection",
    "appId": "XXyy1XXXy",
    "serverToken": "xxYYxxXXX1"
}


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

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new HumanSecurityFraudProtectionProvider
{
	OdataType = "#microsoft.graph.humanSecurityFraudProtectionProvider",
	DisplayName = "HUMAN Security Sign-Up Protection",
	AppId = "XXyy1XXXy",
	ServerToken = "xxYYxxXXX1",
};

// To initialize your graphClient, see https://mms.heiai.top/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Identity.RiskPrevention.FraudProtectionProviders.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.NewFraudProtectionProvider()
displayName := "HUMAN Security Sign-Up Protection"
requestBody.SetDisplayName(&displayName) 
appId := "XXyy1XXXy"
requestBody.SetAppId(&appId) 
serverToken := "xxYYxxXXX1"
requestBody.SetServerToken(&serverToken) 

// To initialize your graphClient, see https://mms.heiai.top/en-us/graph/sdks/create-client?from=snippets&tabs=go
fraudProtectionProviders, err := graphClient.Identity().RiskPrevention().FraudProtectionProviders().Post(context.Background(), requestBody, nil)


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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

HumanSecurityFraudProtectionProvider fraudProtectionProvider = new HumanSecurityFraudProtectionProvider();
fraudProtectionProvider.setOdataType("#microsoft.graph.humanSecurityFraudProtectionProvider");
fraudProtectionProvider.setDisplayName("HUMAN Security Sign-Up Protection");
fraudProtectionProvider.setAppId("XXyy1XXXy");
fraudProtectionProvider.setServerToken("xxYYxxXXX1");
FraudProtectionProvider result = graphClient.identity().riskPrevention().fraudProtectionProviders().post(fraudProtectionProvider);


const options = {
	authProvider,
};

const client = Client.init(options);

const fraudProtectionProvider = {
   '@odata.type': '#microsoft.graph.humanSecurityFraudProtectionProvider',
    displayName: 'HUMAN Security Sign-Up Protection',
    appId: 'XXyy1XXXy',
    serverToken: 'xxYYxxXXX1'
};

await client.api('/identity/riskPrevention/fraudProtectionProviders')
	.post(fraudProtectionProvider);


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


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

$requestBody = new HumanSecurityFraudProtectionProvider();
$requestBody->setOdataType('#microsoft.graph.humanSecurityFraudProtectionProvider');
$requestBody->setDisplayName('HUMAN Security Sign-Up Protection');
$requestBody->setAppId('XXyy1XXXy');
$requestBody->setServerToken('xxYYxxXXX1');

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


Import-Module Microsoft.Graph.Identity.SignIns

$params = @{
	"@odata.type" = "#microsoft.graph.humanSecurityFraudProtectionProvider"
	displayName = "HUMAN Security Sign-Up Protection"
	appId = "XXyy1XXXy"
	serverToken = "xxYYxxXXX1"
}

New-MgIdentityRiskPreventionFraudProtectionProvider -BodyParameter $params


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.human_security_fraud_protection_provider import HumanSecurityFraudProtectionProvider
# To initialize your graph_client, see https://mms.heiai.top/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = HumanSecurityFraudProtectionProvider(
	odata_type = "#microsoft.graph.humanSecurityFraudProtectionProvider",
	display_name = "HUMAN Security Sign-Up Protection",
	app_id = "XXyy1XXXy",
	server_token = "xxYYxxXXX1",
)

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

Respuesta

En el ejemplo siguiente se muestra la respuesta con el objeto fraudProtectionProvider de seguridad humana.

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

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identity/riskPrevention/fraudProtectionProviders/$entity",
    "@odata.type": "#microsoft.graph.humanSecurityFraudProtectionProvider",
    "id": "6b09e36f-7e92-4448-842a-3959bcbc4f9f",
    "displayName": "HUMAN security Sign-Up provider",
    "appId": "XXyy1XXXy"
}

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-11-19

Creación de fraudProtectionProviders

Permissions

Solicitud HTTP

Encabezados de solicitud

Cuerpo de la solicitud

Respuesta

Ejemplos

Ejemplo 1: Creación de un nuevo objeto arkoseFraudProtectionProvider

Solicitud

Respuesta

Ejemplo 2: Creación de un nuevo objeto humanSecurityFraudProtectionProvider

Solicitud

Respuesta

Comentarios

Recursos adicionales