Profils d’échange de jetons (POST)

Créez un nouveau profil d’échange de jetons dans votre locataire.

En utilisant cette fonctionnalité, vous acceptez les conditions applicables de l’essai gratuit figurant dans le Contrat-cadre d’abonnement d’Okta. Il vous incombe de valider de manière sécurisée le subject_token de l’utilisateur. Consultez le guide de l’utilisateur pour en savoir plus.

POST https://{tenantDomain}/api/v2/token-exchange-profiles

Go

Go

package example

import (
    context "context"

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

func do() {
    client := client.NewClient(
        option.WithToken(
            "<token>",
        ),
    )
    request := &management.CreateTokenExchangeProfileRequestContent{
        Name: "name",
        SubjectTokenType: "subject_token_type",
        ActionId: "action_id",
        Type: management.TokenExchangeProfileTypeEnum(
            "custom_authentication",
        ),
    }
    client.TokenExchangeProfiles.Create(
        context.TODO(),
        request,
    )
}

201

{
  "action_id": "<string>",
  "created_at": "2024-01-01T00:00:00.000Z",
  "id": "<string>",
  "name": "Token Exchange Profile 1",
  "subject_token_type": "<string>",
  "updated_at": "2024-01-01T00:00:00.000Z"
}

Autorisations

bearerAuthoAuth2ClientCredentials

Authorization · string · header · requis

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

Corps

application/jsonapplication/x-www-form-urlencoded

action_id · string · requis

L’ID de l’Action Custom Token Exchange à exécuter pour ce profil afin de valider le subject_token. L’Action doit utiliser le déclencheur custom-token-exchange.

Required string length: 1 - 36

name · string · défaut: Token Exchange Profile 1 · requis

Nom convivial de ce profil.

Required string length: 3 - 50

subject_token_type · string<url> · requis

Type de jeton de sujet pour ce profil. Lors de la réception d’une requête d’échange de jeton dans l’Authentication API, le profil d’échange de jeton correspondant ayant une valeur subject_token_type identique sera exécuté. Il doit s’agir d’un URI.

Required string length: 8 - 100

type · enum<string> · requis

Le type du profil, qui détermine comment le profil sera exécuté lors de la réception d’une requête d’échange de jeton.

Options disponibles: custom_authentication

Required string length: 1 - 21

Réponse

201

application/json

Profil d’échange de jetons créé avec succès.

action_id · string

L’ID de l’Action Custom Token Exchange à exécuter pour ce profil afin de valider le subject_token. L’Action doit utiliser le déclencheur custom-token-exchange.

Required string length: 1 - 36

created_at · string<date-time> · défaut: 2024-01-01T00:00:00.000Z

Date et heure de création de ce profil.

id · string<token-exchange-profile-id>

L’ID unique du profil d’échange de jeton.

name · string · défaut: Token Exchange Profile 1

Nom convivial de ce profil.

Required string length: 3 - 50

subject_token_type · string<url>

Type de jeton de sujet pour ce profil. Lors de la réception d’une requête d’échange de jeton dans l’Authentication API, le profil d’échange de jeton correspondant ayant une valeur subject_token_type identique sera exécuté. Il doit s’agir d’un URI.

Required string length: 8 - 100

type · enum<string>

Le type du profil, qui détermine comment le profil sera exécuté lors de la réception d’une requête d’échange de jeton.

Options disponibles: custom_authentication

Required string length: 1 - 21

updated_at · string<date-time> · défaut: 2024-01-01T00:00:00.000Z

Date et heure de mise à jour de ce profil.