Creación de b2cIdentityUserFlow

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Cree un nuevo objeto b2cIdentityUserFlow .

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) IdentityUserFlow.ReadWrite.All No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación IdentityUserFlow.ReadWrite.All No disponible.

Importante

En escenarios delegados con cuentas profesionales o educativas, al usuario que ha iniciado sesión se le debe asignar un rol de Microsoft Entra compatible o un rol personalizado con un permiso de rol admitido. Id. externa administrador de Flujo de usuario es el rol con privilegios mínimos admitido para esta operación.

Solicitud HTTP

POST /identity/b2cUserFlows

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 de b2cIdentityUserFlow.

Propiedad Tipo Descripción
id Cadena Obligatorio. El nombre del flujo de usuario. El nombre se antepondrá B2C_1_ a después de la creación si el prefijo no se agregó al nombre durante la solicitud.
userFlowType Cadena Obligatorio. Tipo de flujo de usuario que va a crear. Los valores compatibles con userFlowType son:
  • signUp
  • signIn
  • signUpOrSignIn
  • passwordReset
  • profileUpdate
  • resourceOwner
userFlowTypeVersion Float Obligatorio. La versión del flujo de usuario.
isLanguageCustomizationEnabled Booleano Opcional. Determina si la personalización de idioma está habilitada dentro del flujo de usuario de Azure AD B2C. La personalización de idioma no está habilitada de forma predeterminada para los flujos de usuario de Azure AD B2C.
defaultLanguageTag Cadena Opcional. Especifica el idioma predeterminado de b2cIdentityUserFlow que se usa cuando no se especifica ninguna ui_locale etiqueta en la solicitud. Este campo es compatible con RFC 5646
identityProviders Colección identityProvider Opcional. Los proveedores de identidades que desea incluir en el flujo de usuario.

Respuesta

Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un encabezado Location con un URI al objeto b2cIdentityUserFlow creado para esta solicitud, con el B2C_1_ prefijo agregado al nombre. Si no se ejecuta correctamente, se devuelve un 4xx error con detalles específicos.

Ejemplos

Ejemplo 1: Creación de un flujo de usuario con los valores predeterminados

Solicitud

Este es un ejemplo de la solicitud.

POST https://graph.microsoft.com/beta/identity/b2cUserFlows
Content-type: application/json

{
    "id": "Customer",
    "userFlowType": "signUpOrSignIn",
    "userFlowTypeVersion": 3
}

Respuesta

Este es un ejemplo de la respuesta:

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

HTTP/1.1 201 Created
Location: https://graph.microsoft.com/beta/identity/b2cUserFlows('B2C_1_Customer')
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#identity/b2cUserFlows/$entity",
    "id": "B2C_1_Customer",
    "userFlowType": "signUpOrSignIn",
    "userFlowTypeVersion": 3,
    "isLanguageCustomizationEnabled": false,
    "defaultLanguageTag": "en",
    "authenticationMethods": "emailWithPassword",
    "tokenClaimsConfiguration": {
        "isIssuerEntityUserFlow": false
    },
    "apiConnectorConfiguration": {}
}

Ejemplo 2: Creación de un flujo de usuario con los valores predeterminados y un proveedor de identidades

Solicitud

Este es un ejemplo de la solicitud.

POST https://graph.microsoft.com/beta/identity/b2cUserFlows
Location: https://graph.microsoft.com/beta/identity/b2cUserFlows('B2C_1_Customer')
Content-type: application/json

{
    "id": "Customer",
    "userFlowType": "signUpOrSignIn",
    "userFlowTypeVersion": 3,
    "identityProviders": [
        {
            "id": "Facebook-OAuth"
        }
    ]
}

Respuesta

Este es un ejemplo de 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/beta/$metadata#identity/b2cUserFlows/$entity",
    "id": "B2C_1_Customer",
    "userFlowType": "signUpOrSignIn",
    "userFlowTypeVersion": 3,
    "isLanguageCustomizationEnabled": false,
    "defaultLanguageTag": "en",
    "authenticationMethods": "0",
    "tokenClaimsConfiguration": {
        "isIssuerEntityUserFlow": false
    },
    "apiConnectorConfiguration": {}
}

Ejemplo 3: Creación de un flujo de usuario con los valores predeterminados y la configuración de los conectores de API

Solicitud

Este es un ejemplo de la solicitud.

POST https://graph.microsoft.com/beta/identity/b2cUserFlows
Content-type: application/json

{
    "id": "UserFlowWithAPIConnector",
    "userFlowType": "signUpOrSignIn",
    "userFlowTypeVersion": 1,
    "apiConnectorConfiguration":{
        "postFederationSignup":{
            "@odata.id": "{apiConnectorId}"
        },
        "postAttributeCollection":{
            "@odata.id": "{apiConnectorId}"
        }
    }
}

Respuesta

Este es un ejemplo de la respuesta:

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

Nota: La apiConnectorConfiguration propiedad siempre devuelve un valor ''{}. Para ver el valor completo con las propiedades de navegación, use esta API.

HTTP/1.1 201 Created
Location: https://graph.microsoft.com/beta/identity/b2cUserFlows/B2C_1_Partner
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#identity/b2cUserFlows/$entity",
    "id": "B2C_1_UserFlowWithAPIConnector",
    "userFlowType": "signUpOrSignIn",
    "userFlowTypeVersion": 1,
    "apiConnectorConfiguration": {}
}