Crear identidades

Vincule dos cuentas de usuario para establecer una relación principal-secundaria. Si la vinculación se realiza correctamente, el endpoint devuelve el nuevo arreglo de identidades de la cuenta principal.

Nota: Hay dos formas de invocar el endpoint:

• Con el JWT autenticado de la cuenta principal en el encabezado Authorization, que tiene el scope update:current_user_identities:

  POST /api/v2/users/PRIMARY_ACCOUNT_USER_ID/identities
  Authorization: "Bearer PRIMARY_ACCOUNT_JWT"
  {
    "link_with": "SECONDARY_ACCOUNT_JWT"
  }
  

  En este caso, solo se requiere el parámetro link_with en el cuerpo, que también contiene el JWT obtenido durante la autenticación de la cuenta secundaria.

• Con un token generado por la API V2 que contiene el scope update:users:

  POST /api/v2/users/PRIMARY_ACCOUNT_USER_ID/identities
  Authorization: "Bearer YOUR_API_V2_TOKEN"
  {
    "provider": "SECONDARY_ACCOUNT_PROVIDER",
    "connection_id": "SECONDARY_ACCOUNT_CONNECTION_ID(OPTIONAL)",
    "user_id": "SECONDARY_ACCOUNT_USER_ID"
  }
  

  En este caso, debe enviar provider y user_id en el cuerpo. Opcionalmente, también puede enviar el parámetro connection_id, que sirve para identificar una conexión de base de datos concreta para el proveedor ‘auth0’.

POST https://{tenantDomain}/api/v2/users/{id}/identities

Go

Go

package example

import (
    context "context"

    client "github.com/auth0/go-auth0/management/management/client"
    option "github.com/auth0/go-auth0/management/management/option"
    users "github.com/auth0/go-auth0/management/management/users"
)

func do() {
    client := client.NewClient(
        option.WithToken(
            "<token>",
        ),
    )
    request := &users.LinkUserIdentityRequestContent{}
    client.Users.Identities.Link(
        context.TODO(),
        "id",
        request,
    )
}

201

[
  {
    "connection": "twitter",
    "provider": "twitter",
    "user_id": "abc",
    "access_token": "<string>",
    "access_token_secret": "<string>",
    "isSocial": true,
    "profileData": {
      "email": "<string>",
      "email_verified": true,
      "family_name": "<string>",
      "given_name": "<string>",
      "name": "<string>",
      "phone_number": "<string>",
      "phone_verified": true,
      "username": "johndoe"
    },
    "refresh_token": "<string>"
  }
]

Autorizaciones

bearerAuthoAuth2ClientCredentials

Authorization · string · header · requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parámetros de ruta

id · string · requerido

ID de la cuenta de usuario principal a la que se vinculará una segunda cuenta de usuario.

Cuerpo

application/jsonapplication/x-www-form-urlencoded

connection_id · string

connection_id de la cuenta de usuario secundaria que se está vinculando cuando existe más de un proveedor de base de datos auth0.

Pattern: ^con_[A-Za-z0-9]{16}$

link_with · string · predeterminado: {SECONDARY_ACCOUNT_JWT}

JWT de la cuenta secundaria que se está vinculando. Si se envía este parámetro, no se deben enviar provider, user_id ni connection_id.

provider · enum<string>

Proveedor de identidad de la cuenta de usuario secundaria que se está vinculando.

Opciones disponibles: ad, adfs, amazon, apple, dropbox, bitbucket, auth0-oidc, auth0, baidu, bitly, box, custom, daccount, dwolla, email, evernote-sandbox, evernote, exact, facebook, fitbit, github, google-apps, google-oauth2, instagram, ip, line, linkedin, oauth1, oauth2, office365, oidc, okta, paypal, paypal-sandbox, pingfederate, planningcenter, salesforce-community, salesforce-sandbox, salesforce, samlp, sharepoint, shopify, shop, sms, soundcloud, thirtysevensignals, twitter, untappd, vkontakte, waad, weibo, windowslive, wordpress, yahoo, yandex

user_id · string integer · predeterminado: abc

user_id de la cuenta de usuario secundaria que se está vinculando.

Minimum string length: 1

Respuesta

201

application/json

Identidad agregada correctamente.

connection · string · predeterminado: twitter · requerido

Nombre de la conexión de esta identidad.

provider · string · predeterminado: twitter · requerido

Tipo de proveedor de identidad.

user_id · string integer · predeterminado: abc · requerido

user_id de esta identidad.

Minimum string length: 1

access_token · string

Token de acceso del IdP devuelto si se define el scope read:user_idp_tokens.

access_token_secret · string

Secret del token de acceso del IdP, devuelto solo si se define el scope read:user_idp_tokens.

isSocial · boolean

Indica si el proveedor de identidad es un proveedor social (true) o no (false).

profileData · object

Show child attributes

refresh_token · string

Token de actualización del IdP devuelto solo si se define el scope read:user_idp_tokens.