Definir el comportamiento de la organización

Aprenda a definir el comportamiento de las organizaciones en las aplicaciones para la función Organizaciones de Auth0.

Al configurar su aplicación en Auth0, puede especificar qué tipos de usuarios debe admitir. Algunas aplicaciones permiten que las personas inicien sesión con cuentas personales, mientras que otras están pensadas para miembros de organizaciones. Algunas deben admitir ambos casos. Esto se conoce como comportamiento de organización y puede configurarse para cada aplicación que conecte a Auth0.

Por ejemplo, su aplicación podría tener:

• Una landing page de marketing genérica con un botón de Iniciar sesión que lleve a sus usuarios al flujo de inicio de sesión de Auth0 sin una Organización.
• Una URL independiente para cada uno de sus clientes B2B (por ejemplo, los usuarios de Acme van a acme.yourcompany.com) que redirija a los usuarios a Auth0 con una Organización, para que vean el botón de Login de SSO de Acme.

Puede definir el comportamiento de organización para admitir cualquiera de estos escenarios. Además, puede configurar el comportamiento de organización de modo que, si su aplicación requiere que se proporcione una Organización pero su usuario llega por error a Auth0 sin una organización, vea una pantalla en la que pueda introducir el nombre de su organización.

Puede definir el comportamiento de organización mediante el Auth0 Dashboard o la Management API.

​

Auth0 Dashboard

Para definir el comportamiento de la organización desde Auth0 Dashboard:

1. Vaya a Auth0 Dashboard > Applications y seleccione la aplicación para la que desea configurar las organizaciones.
2. Cambie a la vista Login Experience y configure los ajustes correspondientes:

Campo	Descripción	Asignación de API
Tipo de usuarios	Determina qué categoría de usuarios puede iniciar sesión en su aplicación. Las opciones incluyen: Usuarios individuales: Los usuarios pueden registrarse con una cuenta personal e iniciar sesión directamente en su aplicación. Los usuarios individuales no pueden iniciar sesión con una Organización. Usuarios empresariales: Los usuarios deben ser miembros de una Organización para poder iniciar sesión. Cuando se selecciona esta opción, debe proporcionar una Organización al redirigir a los usuarios al endpoint /authorize o configurar su Login Flow para solicitar la Organización. Ambos: Los usuarios pueden iniciar sesión como miembros de una Organización o registrarse con una cuenta personal.	Tipo de usuarios se asigna a organization_usage Opciones: Usuarios individuales se asigna a deny Usuarios empresariales se asigna a require Ambos se asigna a allow
Login Flow	Determina la pantalla de inicio de sesión inicial que se presenta a los usuarios cuando acceden a su aplicación. Solo puede configurar este campo si Tipo de usuarios está establecido en Usuarios empresariales o Ambos. Las opciones incluyen: Solicitar credenciales: Primero se pide a los usuarios que proporcionen sus credenciales de inicio de sesión. Después de iniciar sesión, pueden seleccionar su Organización. Solicitar Organización: Primero se pide a los usuarios que seleccionen su Organización. Después, pueden proporcionar sus credenciales para iniciar sesión. Sin solicitud: Auth0 no determina qué pantalla de inicio de sesión se muestra a los usuarios. En su lugar, su aplicación es responsable de enviar a Auth0 los parámetros necesarios para mostrar la pantalla adecuada.	Login Flow se asigna a organization_require_behavior Opciones: Solicitar credenciales se asigna a post_login_prompt Solicitar Organización se asigna a pre_login_prompt Sin solicitud se asigna a no_prompt
Detección de organización	Define el método utilizado para identificar la organización del usuario antes de la autenticación. Solo está disponible con el Login Flow Solicitar Organización. Las opciones incluyen: Solicitar correo electrónico de la organización: Primero se pide a los usuarios que proporcionen la dirección de correo electrónico asociada a su Organización. Solicitar nombre de la organización: Primero se pide a los usuarios que proporcionen el nombre de su Organización. Solicitar correo electrónico y nombre de la organización: Primero se pide a los usuarios que proporcionen el nombre de su Organización o el correo electrónico asociado a su Organización.	Solicitar correos electrónicos: se asigna a email. Solicitar Organización: se asigna a organization_name. Solicitar correo electrónico y nombre de la organización: se asigna a email y organization_name.

3. Seleccione Guardar cambios.

​

Management API

Haga una llamada PATCH al endpoint Update a Client. Asegúrese de sustituir los valores de marcador de posición client_id, mgmt_api_access_token, organization_usage y organization_require_behavior por su ID de cliente, el Token de acceso de la Management API, la opción de uso de la organización y la opción de comportamiento de la organización, respectivamente.

Valor	Descripción
CLIENT_ID	ID de la aplicación a la que desea agregar comportamiento de organización.
MGMT_API_ACCESS_TOKEN	Tokens de acceso para la Management API con el scope update:clients.
ORGANIZATION_USAGE	Determina si su aplicación puede admitir que los usuarios inicien sesión en una organización. Las opciones incluyen: deny: (Predeterminado) Los usuarios no pueden iniciar sesión mediante una organización. allow: Los usuarios pueden iniciar sesión con o sin una Organización. Cuando se selecciona esta opción, debe proporcionar una organización al redirigir a los usuarios al endpoint /authorize. require: Los usuarios deben iniciar sesión mediante una organización. Cuando se selecciona esta opción, debe proporcionar una organización al redirigir a los usuarios al endpoint /authorize o establecer organization_require_behavior en pre_login_prompt para permitir que los usuarios elijan una organización antes de iniciar sesión.
ORGANIZATION_REQUIRE_BEHAVIOR	Determina el Login Flow que se presenta a los usuarios que acceden a su aplicación. Solo se aplica cuando organization_usage se establece en require o allow. Las opciones incluyen: no_prompt: (Predeterminado) No se muestra ninguna pantalla. Se rechazan las solicitudes sin un parámetro de organización válido. pre_login_prompt: Se solicita a los usuarios que seleccionen una Organización antes de poder iniciar sesión. Solo puede usar esta opción si organization_usage se establece en require. post_login_prompt: Se solicita a los usuarios que inicien sesión con sus credenciales. Después de iniciar sesión, se les solicita que seleccionen su Organización.
ORGANIZATION_DISCOVERY_METHODS	Determina el método para identificar la organización de un usuario antes de la autenticación. Solo se aplica cuando organization_require_behavior es pre_login_prompt y organization_usage se establece en require o allow. email: (Predeterminado) Se solicita a los usuarios que introduzcan la dirección de correo electrónico asociada a su Organización. organization_name: Se solicita a los usuarios que introduzcan el nombre asociado a su Organización. Nombre de la organización y email: Se solicita a los usuarios la dirección de correo electrónico o el nombre asociado a su Organización.

​

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	Message	Causa
200		Cliente actualizado correctamente.
400	invalid_uri	URI de solicitud no válida. El mensaje variará según la causa.	La ruta no es válida.
400	invalid_body	Cuerpo de la solicitud no válido. El mensaje variará según la causa.	La carga útil de la solicitud no es válida.
401		Token inválido.
401		El cliente no es global.
401		Se recibió una firma no válida para la validación del JSON Web Token.
403	insufficient_scope	scope insuficiente; se esperaba alguno de los siguientes: update:clients.	Se intentó leer o escribir un campo que no está permitido con los alcances del Bearer Token proporcionado.
403	insufficient_scope	Algunos campos no se pueden actualizar con los permisos otorgados por los alcances del Bearer Token. El mensaje variará según los campos y los alcances.	Se intentó leer o escribir un campo que no está permitido con los alcances del Bearer Token proporcionado.
403	operation_not_supported	La cuenta no tiene permiso para realizar esta operación.	La cuenta no tiene permiso para realizar esta operación.
404	inexistent_client	Cliente no encontrado.	Recurso inexistente. La aplicación especificada no existe.
429		Demasiadas solicitudes. Revise los encabezados X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset.