Introducción a los usuarios · BreezeAuth Docs

Un usuario es una persona que forma parte de tu organización: un empleado, un contratista, un socio. Cada usuario puede iniciar sesión con BreezeAuth y abrir las aplicaciones a las que tu organización le da acceso.

Los usuarios se gestionan en Usuarios › Usuarios humanos en la consola de administración. Las integraciones y automatizaciones no usan las cuentas de las personas: tienen sus propias identidades, que aparecen en la pestaña Usuarios de servicio, al lado. Consulta Usuarios de servicio.

Qué guarda BreezeAuth de cada usuario

Información	Ejemplos
Información básica	Nombre, apellido y dirección de correo. El correo es lo que la persona usa para iniciar sesión.
Información profesional	Cargo, departamento, ID de empleado, centro de costes, unidad organizativa, ubicación de la oficina.
Contacto	Teléfono y teléfono del trabajo.
Documentos y dirección	CPF (número de contribuyente brasileño) y dirección postal.
Rol administrativo	Lo que la persona puede hacer en la consola de administración, si puede hacer algo. Consulta Roles administrativos.
Estado	Si la persona puede usar BreezeAuth en tu organización en este momento. Consulta Estados.
Tipo de cuenta	Gestionada o Invitada, según el dominio del correo. Consulta Tipos de cuenta.

Solo el nombre y el correo son obligatorios. Los demás campos del perfil son opcionales, y muchos se pueden enviar a tus aplicaciones cuando las personas inician sesión, así que merece la pena rellenarlos.

Conceptos clave

Usuario: El lugar de una persona en tu organización: su perfil, su rol administrativo y su estado. Cada organización guarda su propio registro de la persona, así que la misma persona puede pertenecer a varias organizaciones, con un rol y un perfil distintos en cada una.
Cuenta: El acceso de la persona a BreezeAuth: su dirección de correo, su contraseña, sus passkeys y su autenticación multifactor (MFA). Una cuenta puede estar vinculada a usuarios de varias organizaciones.
Tipo de cuenta: Si la cuenta está Gestionada por tu organización o pertenece a una persona Invitada. Determina cuánto control tiene tu organización sobre la cuenta.
Rol administrativo: Lo que el usuario puede hacer en la consola de administración, como Administrador o Auditor. La mayoría de las personas no tiene rol administrativo: solo inician sesión en sus aplicaciones.
Estado: Si el usuario tiene acceso en este momento: Activo, Inactivo, a la espera de una invitación o a la espera de tu revisión.

Tipos de cuenta

El tipo de cuenta de cada usuario se define automáticamente a partir del dominio de su correo. No lo eliges tú.

Tipo de cuenta	Quién	Cómo se une	Tu organización controla
Gestionada	Las personas con un correo de uno de tus dominios verificados	Se crea directamente, con una contraseña inicial, y puede entrar al momento	La propia cuenta: políticas, MFA, sesiones, correo, eliminación
Invitada	Todas las demás, como socios, proveedores o personas con un correo personal	Recibe una invitación y debe aceptarla	Solo su lugar en tu organización: perfil, rol, estado

Esta diferencia importa sobre todo cuando editas, desactivas o eliminas a alguien. Cada página de esta sección lo señala cuando se aplica. La comparación completa está en Usuarios gestionados e invitados.

Consejo: si tu empresa todavía no ha verificado su dominio, todos los usuarios que añadas serán invitados. Verifica primero tu dominio para gestionar las cuentas de tus compañeros. Consulta Verificación de dominios.

Estados

Estado	Qué significa	Puede iniciar sesión en tus aplicaciones
Activo	El usuario forma parte de la organización.	Sí, en las que tiene asignadas
Inactivo	Un administrador desactivó el usuario. Su perfil, sus grupos y sus asignaciones se conservan, así que puedes reactivarlo después.	No
Pendiente	Se invitó a una persona y todavía no ha aceptado la invitación.	No
Invitación rechazada	La persona invitada rechazó la invitación.	No
Revisión pendiente	El dominio del correo de la persona se verificó después de crear su cuenta, y un administrador debe confirmarla. Consulta Revisar las cuentas pendientes.	No

Solo los usuarios activos con un rol administrativo pueden usar la consola de administración.

La vida de un usuario

AñadidoUn administrador crea un usuario gestionado, o invita a un usuario invitado, en Usuarios › Nuevo usuario.
ActivoLos usuarios gestionados quedan activos al momento. Los invitados, cuando aceptan la invitación.
Con accesoEl usuario se añade a grupos y recibe aplicaciones, directamente o a través de los grupos.
Desactivado o eliminadoCuando la persona se va, desactívala para conservar su registro, o elimínala.

Las instrucciones paso a paso están en Añadir y gestionar usuarios.

Para desarrolladores: en la API de BreezeAuth, los usuarios se llaman memberships: el vínculo entre la cuenta de una persona y una organización. Por ejemplo, los usuarios se leen y se modifican en /organizations/{organizationsUuid}/memberships, su identificador es membershipsUuid, y los eventos de webhook sobre ellos se llaman membership.created, membership.updated y membership.deleted. En la consola de administración y en el resto de esta documentación, son simplemente usuarios.

Próximos pasos

Conoce las diferencias entre usuarios gestionados e invitados.
Añade y gestiona usuarios en la consola de administración.
Descubre cómo funcionan las invitaciones.
Elige el rol administrativo adecuado para quienes ayudan a gestionar BreezeAuth.
Protege a tus usuarios gestionados con las herramientas de seguridad de la cuenta.