> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Envoyer des appartenance invitations pour Organisations
> Découvrez comment envoyer des appartenance invitations pour Organisations à l’aide de l’Auth0 Dashboard ou de la Management API.
export const ReleaseStageNotice = ({feature, stage, plans, contact, terms}) => {
const stageTextMap = {
"beta": "bêta",
"ea": "Accès anticipé"
};
const stageText = stageTextMap[stage] || "une phase de lancement du produit";
const prsLink = "/docs/troubleshoot/product-lifecycle/product-release-stages";
const linkify = (text, url) => {
return {text};
};
const includeDetails = (plans, contact, terms) => {
const hasDetails = terms || plans || contact;
if (!hasDetails) return null;
return
{plans && <>Cette fonctionnalité est offerte avec les forfaits {linkify(`${plans}`, "https://auth0.com/pricing")}. }
{contact && "Pour y participer, communiquez avec " + contact + ". "}
{terms && <>En utilisant cette fonctionnalité, vous acceptez les conditions applicables de l’essai gratuit énoncées dans le {linkify("Master Subscription Agreement", "https://www.okta.com/legal")} d’Okta.}
;
};
return
La fonctionnalité {feature} est en {linkify(stageText, prsLink)}.
{includeDetails(plans, contact, terms)}
;
};
Vous pouvez envoyer des appartenance invitations d’[Organisation](/docs/fr-ca/manage-users/organizations/organizations-overview) à des utilisateurs à l’aide de l’Auth0 Dashboard ou de la Management API.
## Auth0 Dashboard
Pour inviter des membres à partir d’Auth0 Dashboard :
1. Accédez à [Auth0 Dashboard > Organizations](https://manage.auth0.com/#/organizations), puis sélectionnez l’organisation pour laquelle vous souhaitez configurer l’appartenance.
2. Sélectionnez la vue **Invitations**, puis **Invite Members**.
3. Sélectionnez l’application à laquelle vous souhaitez inviter le membre, entrez l’adresse courriel de l’utilisateur que vous souhaitez inviter à l’organisation, puis sélectionnez **Send Invite(s)**.
Au besoin, vous pouvez préciser la connexion que les utilisateurs devront utiliser pour accepter l’invitation, ainsi que les rôles que vous souhaitez attribuer au membre de l’organisation lorsqu’il l’acceptera. Pour préattribuer un rôle d’organisation, sélectionnez dans le sélecteur de rôles un rôle associé à cette organisation.
Si vous activez [Multiple Custom Domains](/docs/fr-ca/customize/custom-domains/multiple-custom-domains), vous pouvez sélectionner **Domain** dans la section **Send Invite(s)** afin de choisir le domaine de notification de votre tenant.
## Management API
Si vous exposez la fonctionnalité d’invitation à partir d’un tableau de bord d’administration que vous avez personnalisé pour votre application, utilisez une [application confidentielle](/docs/fr-ca/get-started/applications/confidential-and-public-applications) pour valider que l’utilisateur authentifié appartient à une organisation avant d’inviter de nouveaux membres; sinon, vous pouvez empêcher les utilisateurs d’inviter de nouveaux membres à moins qu’un rôle précis leur ait été attribué.
Pour inviter des membres au moyen de la Management API :
Faites une requête `POST` au point de terminaison Create Organization Invitations. Assurez-vous de remplacer les valeurs de l’espace réservé `ORG_ID`, `MGMT_API_ACCESS_TOKEN`, `NAME_OF_USER`, `EMAIL_ADDRESS`, `CLIENT_ID`, `CONNECTION_ID`, `EXP_TIME`, `ROLE_ID` et `SEND_INVITATION_EMAIL_OPTION` par l’ID de votre organisation, le jeton d’accès de la Management API, le nom de l’utilisateur invité, l’adresse courriel de l’utilisateur invité, l’ID client, l’ID de connexion, le délai d’expiration et les ID de rôle, respectivement.
```json lines theme={null}
{
"method": "POST",
"url": "https://{yourDomain}/api/v2/organizations/ORG_ID/invitations",
"headers": [
{ "name": "Content-Type", "value": "application/json" },
{ "name": "Authorization", "value": "Bearer MGMT_API_ACCESS_TOKEN" },
{ "name": "Cache-Control", "value": "no-cache" }
],
"postData": {
"mimeType": "application/json",
"text" : "{ \"inviter\": { \"name\": \"NAME_OF_USER\"}, \"invitee\": { \"email\": \"EMAIL_ADDRESS\" }, \"client_id\": \"CLIENT_ID\", \"connection_id\": \"CONNECTION_ID\", \"ttl_sec\": \"EXP_TIME\", \"roles\": [ \"ROLE_ID\", \"ROLE_ID\", \"ROLE_ID\" ], \"send_invitation_email\": \"SEND_EMAIL_INVITATION_OPTION\" }"
}
}
```
Si vous activez [Multiple Custom Domains](/docs/fr-ca/customize/custom-domains/multiple-custom-domains), vous devez inclure l’en-tête HTTP `auth0-custom-domain`. Pour en savoir plus, consultez [Multiple Custom Domains](/docs/fr-ca/customize/custom-domains/multiple-custom-domains#customize-email-handling-using-the-management-api).
**Trouvez votre domaine Auth0**
Votre domaine Auth0 est composé du nom de votre tenant, de votre sous-domaine régional (à moins que votre tenant se trouve dans la région des États-Unis et ait été créé avant juin 2020), puis de `.auth0.com`. Par exemple, si le nom de votre tenant était `travel0`, votre domaine Auth0 serait `travel0.us.auth0.com`. (Si votre tenant se trouvait aux États-Unis et avait été créé avant juin 2020, votre nom de domaine serait alors `https://travel0.auth0.com`.)
Si vous utilisez des domaines personnalisés, il doit s’agir de votre nom de domaine personnalisé.
| Valeur | Description |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ORG_ID` | ID de l’Organisation pour laquelle vous voulez attribuer l’appartenance. |
| `MGMT_API_ACCESS_TOKEN` | [Access Token for the Management API](/docs/fr-ca/secure/tokens/access-tokens/management-api-access-tokens) avec la scope `create:organization_invitations`. |
| `NAME_OF_USER` | Nom de l’utilisateur à qui vous voulez envoyer l’invitation. Maximum de 300 caractères. |
| `EMAIL_ADDRESS` | Adresse courriel à laquelle l’invitation doit être envoyée. |
| `CLIENT_ID` | ID de l’application à laquelle l’utilisateur invité doit s’authentifier. |
| `CONNECTION_ID` | ID de la connexion par laquelle le membre invité doit s’authentifier. |
| `EXP_TIME` | Nombre de secondes avant l’expiration de l’invitation. S’il n’est pas précisé ou s’il est défini à 0, la valeur par défaut est de 604800 secondes (7 jours). Maximum de 2592000 secondes (30 jours). |
| `ROLE_ID` | ID du ou des rôles que vous voulez attribuer à l’utilisateur invité pour l’Organisation indiquée. Transmettez l’ID d’un rôle d’Organisation pour préattribuer un rôle limité à l’Organisation. Le tableau `roles` est facultatif; si vous l’omettez, l’invité rejoint l’Organisation sans aucun rôle attribué. Maximum de 50 rôles par membre. |
| `SEND_INVITATION_EMAIL_OPTION` | Indique si Auth0 doit envoyer le courriel. Les valeurs sont `true` ou `false`. Lorsqu’elle est définie à `false`, Auth0 génère une URL d’invitation que vous pouvez transmettre aux utilisateurs au moyen de votre propre service de courriel. |
### Codes d’état de la réponse
Les codes d’état de réponse possibles sont les suivants :
| Code d’état | Code d’erreur | Message | Cause |
| ----------- | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| `200` | | Invitation créée avec succès. | |
| `400` | `invalid_body` | Le `client_id` spécifié n’existe pas. | La charge utile de la requête n’est pas valide. |
| `400` | `invalid_body` | La connexion spécifiée n’existe pas. | La charge utile de la requête n’est pas valide. |
| `400` | `invalid_body` | Les connexions Passwordless ne sont pas prises en charge. | La charge utile de la requête n’est pas valide. |
| `400` | `invalid_body` | Une route de connexion par défaut est requise pour générer l’URL d’invitation. Pour en savoir plus, consultez [Configurer les routes de connexion par défaut](/docs/fr-ca/authenticate/login/auth0-universal-login/configure-default-login-routes). | La charge utile de la requête n’est pas valide. |
| `400` | `invalid_body` | Un ou plusieurs des rôles spécifiés n’existent pas : role1, role2'. | La charge utile de la requête n’est pas valide. |
| `400` | `invalid_body` | Corps de requête invalide. Le message varie selon la cause. | La charge utile de la requête n’est pas valide. |
| `400` | `invalid_query_string` | Chaîne de requête invalide. Le message varie selon la cause. | La chaîne de requête n’est pas valide. |
| `401` | | Token invalide. | |
| `401` | | Signature invalide reçue pour la validation du JSON Web Token. | |
| `401` | | Le client n’est pas global. | |
| `403` | `insufficient_scope` | Scope insuffisant; l’un des scopes suivants était attendu : `create:organization_invitations`. | Tentative de lecture ou d’écriture d’un champ non autorisé avec les scopes du bearer token fourni. |
| `404` | | Aucune organisation trouvée pour cet ID. | |
| `429` | | Trop de requêtes. Vérifiez les headers X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset. | |