Créer des identités

Liez deux comptes utilisateur pour établir une relation principale-secondaire. Si la liaison réussit, le point de terminaison renvoie le nouveau tableau des identités du compte principal.

Remarque : il existe deux façons d’appeler le point de terminaison :

• Avec le JWT du compte principal authentifié dans l’en-tête Authorization, qui possède le scope update:current_user_identities :

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

  Dans ce cas, seul le paramètre link_with est requis dans le corps, qui contient aussi le JWT obtenu lors de l’authentification du compte secondaire.

• Avec un jeton généré par l’API V2 contenant le 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"
  }
  

  Dans ce cas, vous devez envoyer provider et user_id dans le corps. Vous pouvez également envoyer le paramètre connection_id, qui permet d’identifier une connexion de base de données particulière pour le fournisseur « 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>"
  }
]

Autorisations

bearerAuthoAuth2ClientCredentials

Authorization · string · header · requis

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

Paramètres de chemin

id · string · requis

ID du compte utilisateur principal auquel lier un deuxième compte utilisateur.

Corps

application/jsonapplication/x-www-form-urlencoded

connection_id · string

Le connection_id du compte utilisateur secondaire en cours de liaison lorsqu’il existe plus d’un fournisseur de base de données auth0.

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

link_with · string · défaut: {SECONDARY_ACCOUNT_JWT}

JWT du compte secondaire en cours de liaison. Si vous envoyez ce paramètre, provider, user_id et connection_id ne doivent pas être envoyés.

provider · enum<string>

Le fournisseur d’identité du compte utilisateur secondaire en cours de liaison.

Options 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 · défaut: abc

user_id du compte utilisateur secondaire à lier.

Minimum string length: 1

Réponse

201

application/json

Identité ajoutée avec succès.

connection · string · défaut: twitter · requis

Nom de la connexion de cette identité.

provider · string · défaut: twitter · requis

Type de fournisseur d’identité.

user_id · string integer · défaut: abc · requis

user_id de cette identité.

Minimum string length: 1

access_token · string

Jeton d’accès du fournisseur d’identité (IdP) renvoyé si le scope read:user_idp_tokens est défini.

access_token_secret · string

Secret du jeton d’accès du fournisseur d’identité (IdP) renvoyé uniquement si le scope read:user_idp_tokens est défini.

isSocial · boolean

Indique si le fournisseur d’identité est un fournisseur social (true) ou non (false).

profileData · object

Show child attributes

refresh_token · string

Jeton d’actualisation du fournisseur d’identité (IdP) renvoyé uniquement si le scope read:user_idp_tokens est défini.