Enviar invitaciones de membresía a una organización

Aprenda a enviar invitaciones de membresía a una organización mediante Auth0 Dashboard o Management API.

Puede enviar invitaciones de membresía de organización a los usuarios mediante Auth0 Dashboard o Management API.

​

Auth0 Dashboard

Para invitar a miembros desde Auth0 Dashboard:

1. Vaya a Auth0 Dashboard > Organizaciones y seleccione la organización para la que desea configurar la membresía.

2. Seleccione la vista Invitaciones y, a continuación, Invitar a miembros.

3. Seleccione la aplicación a la que desea invitar al miembro, introduzca la dirección de correo electrónico del usuario que desea invitar a la organización y seleccione Enviar invitación(es).

   Opcionalmente, puede especificar la conexión con la que quiere que los usuarios acepten la invitación y los roles que desea asignar al miembro de la organización cuando la acepte.

Si habilita múltiples dominios personalizados, tiene la opción de seleccionar Dominio en la sección Enviar invitación(es) para elegir el dominio de notificación de su inquilino.

​

Management API

Si expones la función de invitación desde un panel de administración que personalizaste para tu aplicación, usa una aplicación confidencial para validar que el usuario autenticado pertenezca a una organización antes de invitar a nuevos miembros, o restringe la invitación de nuevos miembros a usuarios con un rol específico asignado.

Para invitar miembros mediante la Management API: Haz una llamada POST al endpoint Create Organization Invitations. Asegúrate de sustituir los valores de marcador de posición ORG_ID, MGMT_API_ACCESS_TOKEN, NAME_OF_USER, EMAIL_ADDRESS, CLIENT_ID, CONNECTION_ID, EXP_TIME, ROLE_ID y SEND_INVITATION_EMAIL_OPTION por el id de tu organización, el Token de acceso de la Management API, el nombre del usuario invitado, la dirección de correo electrónico del usuario invitado, el ID de cliente, el id de la conexión, el tiempo de expiración y los id de rol, respectivamente.

{
  "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 habilita múltiples dominios personalizados, debe incluir el encabezado HTTP auth0-custom-domain. Para obtener más información, consulte múltiples dominios personalizados.

Encuentre su dominio de Auth0

Su dominio de Auth0 está compuesto por el nombre de su inquilino, su subdominio regional (a menos que su inquilino esté en la región de EE. UU. y se haya creado antes de junio de 2020) y .auth0.com. Por ejemplo, si el nombre de su inquilino fuera travel0, el nombre de su dominio de Auth0 sería travel0.us.auth0.com. (Si su inquilino estuviera en EE. UU. y se hubiera creado antes de junio de 2020, entonces el nombre de su dominio sería https://travel0.auth0.com).

Si usa dominios personalizados, debe ser el nombre de su dominio personalizado.

Value	Description
ORG_ID	ID de la organización a la que desea asignar la membresía.
MGMT_API_ACCESS_TOKEN	Token de acceso para la Management API con el scope create:organization_invitations.
NAME_OF_USER	Nombre del usuario al que desea enviar la invitación. Máximo de 300 caracteres.
EMAIL_ADDRESS	Dirección de correo electrónico a la que debe enviarse la invitación.
CLIENT_ID	ID de la aplicación en la que debe autenticarse el usuario invitado.
CONNECTION_ID	ID de la conexión mediante la que debe autenticarse el miembro invitado.
EXP_TIME	Número de segundos antes de que caduque la invitación. Si no se especifica o se establece en 0, el valor predeterminado es 604800 segundos (7 días). Máximo de 2592000 segundos (30 días).
ROLE_ID	ID del rol o de los roles que desea asignar al usuario invitado para la organización especificada. Máximo de 50 roles por miembro.
SEND_INVITATION_EMAIL_OPTION	Indica si Auth0 debe enviar el correo electrónico. Los valores son true o false. Cuando se establece en false, Auth0 generará una URL de invitación que podrá entregar a los usuarios mediante su propio servicio de correo electrónico.

​

Códigos de estado de la respuesta

Los posibles códigos de estado de la respuesta son los siguientes:

Código de estado	Código de error	Mensaje	Causa
200		La invitación se creó correctamente.
400	invalid_body	El client_id especificado no existe.	La carga útil de la solicitud no es válida.
400	invalid_body	La conexión especificada no existe.	La carga útil de la solicitud no es válida.
400	invalid_body	Las conexiones sin contraseña no son compatibles.	La carga útil de la solicitud no es válida.
400	invalid_body	Se requiere una ruta de inicio de sesión predeterminada para generar la URL de invitación. Para obtener más información, consulta Configurar rutas de inicio de sesión predeterminadas.	La carga útil de la solicitud no es válida.
400	invalid_body	Uno o más de los roles especificados no existen: role1, role2’.	La carga útil de la solicitud no es válida.
400	invalid_body	El cuerpo de la solicitud no es válido. El mensaje variará según la causa.	La carga útil de la solicitud no es válida.
400	invalid_query_string	La cadena de consulta de la solicitud no es válida. El mensaje variará según la causa.	La cadena de consulta no es válida.
401		Token no válido.
401		Se recibió una firma no válida para la validación del JSON Web Token.
401		El cliente no es global.
403	insufficient_scope	Alcance insuficiente; se esperaba cualquiera de los siguientes: create:organization_invitations.	Se intentó leer o escribir un campo que no está permitido con los alcances del Bearer Token proporcionado.
404		No se encontró ninguna organización con ese id.
429		Demasiadas solicitudes. Revisa los encabezados X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset.