> ## Documentation Index
> Fetch the complete documentation index at: https://docs.athenahq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Inicio de sesión y acceso (configuración de seguridad)

> Permite a los administradores controlar quién puede incorporarse automáticamente por dominio de correo, a nivel de organización y sitio web, y configurar el inicio de sesión único (SSO) y el aprovisionamiento SCIM con su proveedor de identidad.

> [card] [Abrir en AthenaHQ](https://app.athenahq.ai/settings/security)
>
> `app.athenahq.ai/settings/security`

## Propósito

La configuración de Inicio de sesión y acceso permite a los administradores controlar cómo se incorporan y autentican los compañeros en su espacio de trabajo. Evita tener que invitar manualmente a cada miembro al permitir la incorporación automática por dominio, y ofrece controles de seguridad empresariales como el inicio de sesión único (SSO) y el aprovisionamiento de usuarios SCIM.

Puedes configurar el acceso por dominio a dos niveles: toda la organización (acceso al espacio de trabajo completo) o restringido a sitios web (acceso limitado a sitios web en seguimiento concretos). Si tienes un plan empresarial, aquí también puedes conectar tu propio proveedor de identidad SAML u OIDC (como Okta, Google Workspace o Microsoft Entra) y automatizar la creación y desactivación de cuentas.

## Qué hay en la página

### Acceso a la organización

Esta sección lista los dominios que conceden acceso a toda tu organización. Incluye **Añadir dominio** para configurar uno nuevo.

* **Lista de dominios**: muestra cada `@domain` configurado.
* **Insignia de verificación**: muestra una insignia verde **Verificado** si el dominio se ha verificado mediante DNS o coincidencia con correos de miembros. Si no está verificado, aparece la insignia ámbar **Verificar DNS**.
* **Rol predeterminado**: una insignia con el rol (por ejemplo, «Lector», «Administrador» o uno personalizado) asignado a quien se incorpore mediante este dominio.
* **Editar**: abre el diálogo «Editar @\[domain]».

### Acceso a sitios web

Esta sección lista los dominios configurados para conceder acceso solo a sitios web concretos en lugar de a toda la organización.

* **Lista de dominios**: agrupada por `@domain`.
* **Insignia de verificación**: muestra **Verificado** o **Verificar DNS** (funciona igual que la de nivel de organización).
* **Sitios web asociados**: una sublista con el logotipo y nombre de cada sitio al que pueden acceder los usuarios de este dominio.
* **Rol predeterminado**: una insignia con el rol asignado.
* **Editar**: permite ajustar el rol, añadir o quitar sitios web o eliminar el dominio por completo.

### Inicio de sesión único

Esta sección gestiona SSO y está disponible con el plan Enterprise. Si no está configurado, un formulario pide un dominio de correo de empresa. Si lo está, muestra:

* **Cabecera de estado**: el protocolo activo (SAML u OIDC) y una insignia **Activo**.
* **Menú de opciones (⋯)**: arriba a la derecha, con la opción de eliminar SSO. Para usuarios sin rol de administrador, muestra «Solo los administradores de la organización pueden eliminar el proveedor de SSO».
* **Rol predeterminado para nuevos usuarios**: muestra el rol asignado a nuevos usuarios que se incorporan por SSO. Incluye **Editar** con el texto de ayuda para no administradores: «Solo los administradores de la organización pueden cambiar el rol predeterminado de SSO, ya que se concede a todos los nuevos miembros de SSO».
* **Detalles de conexión**: un panel desplegable con campos que se copian al pulsarlos y que necesita el proveedor de identidad (Emisor, URL de retorno y URL de metadatos del SP).

### Aprovisionamiento SCIM

Esta sección solo aparece tras configurar un proveedor de SSO. Permite gestionar la sincronización automática de usuarios.

* **Endpoint SCIM**: un campo de solo lectura que se copia al pulsarlo y muestra la URL base que necesita el proveedor de identidad.
* **Estado del token**: indica si el token actual está **Activo**, **Revocado** o **Sin configurar**.
* **Generar token SCIM / Rotar token SCIM**: un botón para crear o renovar el token de portador necesario.
* **Cómo configurar SCIM en tu proveedor de identidad**: un panel desplegable con instrucciones paso a paso.

**Tabla de correspondencias de atributos SCIM**
Dentro del panel de configuración de SCIM, una tabla explica cómo asignar los campos en el proveedor de identidad.

* **Campo del proveedor de identidad**: nombre del atributo SCIM (por ejemplo, `userName`, `name.givenName`, `name.familyName`, `active`).
* **Campo de AthenaHQ**: a qué corresponde el campo en la aplicación (Correo electrónico, Nombre, Apellidos, Estado activo).

## Qué puedes hacer aquí

* **Añadir dominio (acceso a la organización)**: pulsa **Añadir dominio** para abrir «Añadir dominio de correo». Introduce el dominio, elige un rol predeterminado y pulsa **Añadir dominio** para guardar.
* **Añadir dominio (acceso a sitios web)**: pulsa **Añadir dominio** para abrir «Añadir dominio de acceso a sitios web». Introduce el dominio, selecciona los sitios objetivo en el desplegable, elige un rol y pulsa **Añadir dominio**.
* **Verificar DNS**: pulsa **Verificar DNS** junto a un dominio no verificado para abrir «Verificar propiedad del dominio». Muestra un registro TXT que debes añadir en tu proveedor DNS. Una vez añadido, pulsa **Verificar**.
* **Editar ajustes del dominio**: pulsa **Editar** junto a un dominio para abrir su diálogo. Puedes cambiar el rol, actualizar la lista de sitios (en dominios de nivel de sitio web) o pulsar **Eliminar dominio** (acción destructiva) para borrar completamente la regla.
* **Configurar SSO**: introduce el dominio de correo de tu empresa y pulsa **Continuar**. El asistente te guiará por la verificación DNS (si hace falta) y ofrecerá pestañas para introducir la configuración OIDC o SAML. Pulsa **Finalizar configuración** o **Verificar dominio y finalizar configuración** para completar.
* **Eliminar SSO**: pulsa **⋯** en la tarjeta de Inicio de sesión único y selecciona **Eliminar SSO**. Aparece un diálogo de confirmación destructiva: «¿Eliminar el proveedor de SSO? Todos los que inicien sesión con un correo @\[domain] volverán a usar códigos por correo o el inicio de sesión de Google/Microsoft. Los miembros existentes conservan su acceso». Pulsa **Eliminar SSO** para confirmar.
* **Cambiar el rol predeterminado de SSO**: pulsa **Editar** junto a «Rol predeterminado para nuevos usuarios». Selecciona un rol nuevo y pulsa **Guardar**.
* **Generar / Rotar token SCIM**: pulsa **Generar token SCIM** (o **Rotar token SCIM**). Añade una etiqueta opcional y pulsa **Generar token** (o **Rotar token**). El token nuevo solo se muestra una vez. Debes copiarlo antes de cerrar el diálogo.
* **Copiar detalles de conexión**: pulsa un fragmento de código en línea (como una URL de retorno, un registro TXT de DNS o un token SCIM) para copiarlo al portapapeles. Un texto de ayuda confirma «¡Copiado!».
* **Ampliar a Enterprise**: si tu organización no tiene Enterprise, la sección SSO muestra una tarjeta de ampliación. Pulsa **Ver planes** para abrir los precios y suscribirte.

## Datos que se muestran

* **Tus dominios de incorporación automática**: los dominios que tu equipo ha configurado para conceder automáticamente acceso al espacio o a sitios concretos.
* **Configuración de SSO**: los ajustes del proveedor de identidad SAML/OIDC vinculado a tu organización.
* **Conexión SCIM**: estado del token y URL de endpoints utilizados para sincronizar el directorio de usuarios de tu proveedor de identidad con la aplicación.

## Flujos de trabajo habituales

**Configurar un dominio para la incorporación automática a sitios web**

1. En Acceso a sitios web, pulsa **Añadir dominio**.
2. Escribe el dominio de la empresa en el diálogo (por ejemplo, `acmecorp.com`).
3. Selecciona en el desplegable uno o más sitios a los que deban acceder los usuarios.
4. Selecciona un rol predeterminado y pulsa **Añadir dominio**.
5. Si el dominio no está verificado, pulsa **Verificar DNS**, copia el registro TXT en tu alojamiento DNS y pulsa **Verificar**.

**Configurar el inicio de sesión único (SSO)**

1. En Inicio de sesión único, introduce tu dominio de correo de empresa y pulsa **Continuar**.
2. Completa la verificación DNS si el dominio aún no está verificado.
3. Elige OIDC o SAML según tu proveedor de identidad.
4. Copia la URL de retorno y el ID de entidad proporcionados en la aplicación SSO de tu proveedor de identidad.
5. Pega de vuelta en el formulario de AthenaHQ la URL del emisor, ID de cliente y secreto de cliente (o URL de metadatos para SAML).
6. Pulsa **Finalizar configuración**.

**Rotar un token SCIM**

1. En Aprovisionamiento SCIM, pulsa **Rotar token SCIM**.
2. Lee el aviso de que el token anterior se revocará inmediatamente.
3. Pulsa **Rotar token**.
4. Pulsa el token recién generado para copiarlo y actualiza la configuración SCIM de tu proveedor de identidad.
5. Pulsa **Hecho** para cerrar el diálogo.

## Estados vacíos, de carga y de error

* **Vacío**: si no hay dominios configurados en un nivel, la lista muestra «No hay dominios configurados».
* **Carga**: aparece un indicador giratorio animado en el centro mientras se cargan los datos principales. Las listas de dominios muestran filas de muestra mientras obtienen datos.
* **Error**: si no se carga la configuración de SSO, se muestra «No se ha podido cargar tu configuración de SSO» con **Reintentar**. Si no se carga el estado del token SCIM, muestra «No se ha podido cargar el estado del token» en rojo o ámbar.

## Enlaces de entrada y salida

* **Enlaces de entrada**: la navegación lateral de Configuración (Configuración → Inicio de sesión y acceso).
* **Enlaces de salida**: «Verificar propiedad del dominio» incluye enlaces al panel del proveedor DNS detectado y a su documentación de soporte. «Ver planes» abre el diálogo de planes de precios.

## Preguntas habituales de soporte

**¿Por qué mi dominio pide «Verificar DNS»?**
Si el dominio que has añadido no coincide con el correo verificado de un miembro existente de tu organización, el sistema exige demostrar la propiedad añadiendo un registro TXT concreto en tu proveedor DNS. Así se impide que usuarios no autorizados reclamen dominios que no les pertenecen.

**¿Puedo impedir la incorporación automática sin eliminar el dominio?**
Debes eliminar el dominio para detenerla por completo. Si solo quieres restringir lo que pueden ver, puedes editarlo y cambiar su rol predeterminado por uno personalizado más restrictivo, o moverlo de «Acceso a la organización» a «Acceso a sitios web» para que solo vean paneles concretos.

**Si elimino un dominio de sitio web, ¿pierden el acceso los usuarios?**
Quitar un sitio web de la lista de acceso de un dominio (o eliminar todo el dominio) revoca las pertenencias específicas que el dominio había concedido. Sin embargo, si un usuario también obtuvo acceso por invitación directa o un rol de toda la organización, conservará ese nivel de acceso.

**¿Por qué no puedo establecer Administrador como rol predeterminado?**
Asignar un rol de incorporación automática o de SSO por encima de «Lector» requiere que seas administrador activo de la organización. Es una medida de seguridad para evitar que quienes no son administradores creen, por accidente o de forma intencionada, una vía que conceda privilegios administrativos a nuevos usuarios.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.