Empezar gratis →

Administración

Administrar un espacio de trabajo

Lo que un propietario o un administrador configura para un espacio de trabajo: quién inicia sesión y cómo, quién puede hacer qué, cuánto tiempo se conservan los datos, adónde van las alertas y con qué rigor gobierna la pasarela.

Inicio de sesión único

Un propietario conecta el espacio de trabajo con el proveedor de identidad de la empresa en Ajustes › Acceso › SSO empresarial. OIDC está incluido desde el plan Growth; SAML 2.0, para los proveedores de identidad que solo hablan ese protocolo, con Enterprise.

  • Solo un propietario guarda el proveedor de identidad, activa o desactiva el modo solo SSO, o lo elimina: el proveedor de identidad decide quién inicia sesión con cualquier dirección del dominio. Cada cambio se registra en la auditoría antes de escribirse.
  • Demuestre que el dominio de correo es suyo: añada a su DNS el registro TXT que muestra la pantalla y pulse Verificar el dominio. Antes no se dirige nada a su proveedor de identidad; un cambio de DNS puede tardar hasta una hora en verse.
  • Pruebe Continuar con el SSO de la empresa en la página de inicio de sesión y después active el modo solo SSO: el inicio de sesión con contraseña, con Google y con enlace por correo queda desactivado para todas las direcciones del dominio.
  • Guardar otro proveedor de identidad — otro emisor o ID de cliente, otro entity ID o certificado de firma SAML, otro protocolo — retira la prueba del dominio y desactiva el modo solo SSO: verifique de nuevo el dominio. Guardar el mismo proveedor, con un nuevo secreto de cliente o los mismos metadatos, conserva ambos.
  • Iniciar sesión por SSO no da ninguna pertenencia: a un espacio de trabajo se entra por invitación o mediante SCIM.

Protocolo SAML 2.0

  • El bloque Configuración de SAML da el entity ID y la URL ACS que hay que registrar en su proveedor de identidad. Dé a Azoth los metadatos del proveedor: su URL, o su XML pegado — un proveedor de identidad en su propia red se configura con su XML. Una vez guardado el proveedor, /api/sso/metadata?workspaceId=<id> sirve los metadatos del proveedor de servicio, que la mayoría de los proveedores de identidad importan en un solo paso.
  • El Name ID debe ser persistente y no cambiar para una persona: un Name ID nuevo es una cuenta nueva.
  • Se respeta el cierre de sesión iniciado en el proveedor de identidad: registre /api/sso/logout en su dirección de Azoth como URL de cierre de sesión. Una solicitud de cierre firmada, en el binding HTTP-Redirect o HTTP-POST, termina todas las sesiones de Azoth de la persona que nombra. Se rechazan las solicitudes firmadas con SHA-1: firme con SHA-256 o superior. En la nube de Azoth, la respuesta que se devuelve al proveedor de identidad no va firmada.
  • Cuando cambie el certificado de firma del proveedor de identidad, guarde sus nuevos metadatos en la misma pantalla.

OIDC

  • Introduzca el dominio, la URL del emisor, el ID de cliente y el secreto de cliente, y registre en su proveedor de identidad el URI de redirección que muestra la pantalla, con los scopes openid email profile. Azoth lee el documento de descubrimiento antes de guardar. El secreto de cliente se guarda cifrado y no vuelve a mostrarse: deje el campo vacío para conservarlo.
  • Azoth realiza el inicio de sesión por sí mismo y lo comprueba antes de que exista una sesión: un emisor que pertenece a una sola organización, la firma (RS256, PS256 o ES256) y los claims del ID token, y una dirección de correo exactamente del dominio verificado, que su proveedor de identidad declara haber verificado.
  • Microsoft Entra ID: un emisor de un solo inquilino (https://login.microsoftonline.com/<tenant-id>/v2.0, nunca common, organizations ni consumers) y el claim opcional xms_edov en el ID token. Google Workspace: un cliente OAuth interno a su Workspace, para que Google envíe el dominio (hd).
  • OIDC no tiene cierre de sesión único: una sesión termina cuando caduca — por defecto ocho horas después de que la persona inició sesión.

Aprovisionamiento SCIM

SCIM 2.0 permite que su proveedor de identidad — Microsoft Entra ID, Okta, PingOne, JumpCloud y otros — añada y retire a los miembros del espacio de trabajo. Abra Aprovisionamiento de usuarios (SCIM) desde Ajustes › Acceso › SSO empresarial. SCIM está incluido con el plan Enterprise, como SAML: en otro plan no se crea ningún token y las llamadas del proveedor de identidad se rechazan.

  • URL del inquilino: https://www.azothos.ai/api/scim/v2, o su propio host si se autoaloja. El espacio de trabajo es el del token, nunca el de la URL.
  • Un propietario o un administrador crea el token bearer que envía el proveedor de identidad. Se muestra una sola vez, se guarda solo como huella con clave y se revoca desde la misma pantalla: la siguiente llamada del proveedor de identidad se rechaza entonces.
  • Los usuarios se crean, se leen, se modifican (PATCH, incluido active) y se eliminan; una lista filtra por userName eq y externalId eq. Asocie userName a la dirección de correo de la persona y externalId a su identificador estable en el directorio. No hay operaciones masivas.
  • Una persona aprovisionada así entra como miembro. Su rol viene de sus grupos, más abajo: active el aprovisionamiento de grupos en su proveedor de identidad.
  • El desaprovisionamiento — active puesto a false, o el usuario eliminado — retira la pertenencia de inmediato: los mandatos de los que respondía la persona se suspenden y sus claves personales se revocan. Una cuenta creada por el SCIM de este espacio y que nada más retiene se desactiva, nunca se elimina. El propietario del espacio no puede desaprovisionarse por SCIM: transfiera antes la propiedad en Azoth.

Un grupo solo da un rol con uno de estos nombres visibles — sin contar mayúsculas, espacios alrededor ni los separadores _ o -:

Azoth Owners
Admin — SCIM nunca concede el rol de propietario
Azoth Admins
Admin
Azoth Finance
Responsable financiero
Azoth Security Officers
Responsable de seguridad
Azoth Analysts
Analista
Azoth Members
Miembro
  • Cualquier otro nombre no da ningún rol: el grupo de un equipo, como Finance team, no concede nada. Su proveedor de identidad puede nombrar el rol en su lugar con el atributo urn:ietf:params:scim:schemas:azoth:2.0:Group:mappedRole, que siempre prevalece.
  • Una persona en varios grupos recibe el más privilegiado de sus roles: admin, después responsable de seguridad y responsable financiero — entre esos dos gana el de seguridad —, después analista y después miembro. Retirada del último grupo que le da un rol, sale del espacio de trabajo.
  • Un grupo cuyo nombre no da ningún rol nunca baja ni retira el rol de nadie. Cada rol que un grupo concede o retira se registra en la auditoría antes de aplicarse.

Roles

Cada miembro tiene un solo rol en un espacio de trabajo. Ajustes › Acceso › Equipo invita y modifica a los miembros como propietario, admin, miembro o analista; los roles de responsable financiero y responsable de seguridad vienen de los grupos SCIM.

Propietario
Todo lo que hace un admin, más el método de pago, el inicio de sesión único, la exigencia de autenticación de dos factores, las acciones sujetas a cuatro ojos, las retenciones por litigio y la eliminación del espacio de trabajo. Un espacio siempre conserva un propietario, y solo un propietario concede el rol de propietario.
Admin
Configura el espacio de trabajo, gestiona miembros, roles y claves API, decide las aprobaciones. No puede eliminar el espacio, ni cambiar el método de pago o el proveedor de identidad.
Responsable financiero
La facturación — facturas y método de pago — y el uso, con el registro de auditoría en solo lectura. Sin configuración ni miembros.
Responsable de seguridad
El registro de auditoría, su exportación y su envío a su SIEM; lee los ajustes del inicio de sesión único, las claves API y las rutas de alerta. Sin facturación, sin miembros, sin llamadas a modelos.
Miembro
Llama a modelos a través de Azoth y ve su propio uso; lee las reglas y los ajustes.
Analista
Solo lectura: el uso y el registro de auditoría, sin llamadas a modelos.

Una invitación con un rol por encima de miembro concede ese rol: cuando los cambios de rol requieren cuatro ojos, espera a un segundo propietario o admin, y no se envía nada antes. Lo mismo vale para retirar a un propietario o admin: conserva su acceso hasta que se apruebe. Cada cambio de rol se registra en la auditoría antes de aplicarse.

Cuatro ojos

Algunos actos solo surten efecto cuando una segunda persona los aprueba. Quien pide nunca aprueba su propia solicitud: Azoth lo comprueba, y la base de datos lo comprueba de nuevo.

  • Un propietario elige, en Reglas › Más › Aprobaciones, cuáles de estos actos requieren un segundo propietario o admin: cambiar el rol de un miembro, publicar o modificar una regla activa, cambiar la retención de los datos. Aprobar un conector también puede requerir los cuatro ojos; solo un propietario aprueba uno, así que la segunda persona es otro propietario.
  • Estos lo requieren siempre: ejecutar una llamada que una regla retiene para aprobación, una acción de agente o una llamada a herramienta MCP que pide una persona, una respuesta retenida por la comprobación de fundamentación, una dispensa de red-teaming, una lectura del derecho (una regla aplicada de otro modo, una zona que prevalece), levantar una retención por litigio.
  • Una solicitud espera en Reglas › Más › Aprobaciones y en la página de inicio, y caduca a las 72 horas. Aprobado, el acto se ejecuta con quien aprueba como autor; cada decisión se registra en la auditoría y se sella.
  • Cuando el ajuste no puede leerse, el acto espera a una segunda persona en lugar de ejecutarse con una sola. Una solicitud hecha con una clave API cuya persona se desconoce puede rechazarse, nunca aprobarse: los cuatro ojos necesitan saber quién pidió.
  • Los cuatro ojos necesitan un segundo propietario o admin — un segundo propietario para la aprobación de un conector: invite a uno antes de activarlos. Una excepción a una regla la decide el responsable de la regla o un propietario o admin, nunca quien la pidió (excepciones).
  • Desde Slack o Teams, los propietarios y admins vinculados con MFA deciden las llamadas retenidas, las acciones de agentes y MCP, las respuestas retenidas y las publicaciones de reglas; los propietarios vinculados con MFA deciden también los conectores. Un cambio de rol, un cambio de retención, una dispensa de red-teaming, una lectura del derecho y el levantamiento de una retención se abren siempre en Azoth.

Revisiones de acceso

Un propietario o un admin revisa quién tiene qué derechos en Ajustes › Acceso › Revisión de accesos.

  • La revisión lista los miembros con su rol, su último inicio de sesión, su autenticación de dos factores y su método de inicio de sesión; las invitaciones pendientes; las claves API con su rol, sus ámbitos, su caducidad y su último uso; los tokens SCIM; si se exige la autenticación de dos factores; y qué acciones requieren cuatro ojos.
  • Señala lo que hay que mirar: un propietario o admin sin autenticación de dos factores, ningún inicio de sesión en 90 días, una clave API sin caducidad, sin uso en 90 días, con el hash antiguo o sin restricción de ámbito.
  • Descárguela en JSON, o los miembros en CSV, corrija lo que no debería estar y márquela como hecha. Su preparación y su cierre se sellan en el registro del espacio — su huella y sus recuentos, nunca las direcciones de correo. Haga una cada trimestre.
  • Lo que hace el propio equipo de Azoth en su espacio de trabajo también se sella en su registro (staff_access). En la nube de Azoth, solo llega a sus datos mediante un acceso de soporte que un propietario aceptó, durante 4 horas como máximo.

Retención

Un propietario o un admin fija cuánto tiempo conserva el espacio de trabajo cada tipo de registro en Ajustes › Módulos y conservación › Retención de datos:

Trazas de uso
30 a 365 días
Decisiones de enrutamiento
30 a 365 días
Eventos de bucle
7 a 180 días
Respuestas reutilizadas (caché)
7 a 90 días
Registros de auditoría
365 a 730 días
  • La purga de cada noche aplica estos plazos y la retención propia de la política de datos: gana el más corto. Cuando los cambios de retención requieren cuatro ojos, un cambio espera a un segundo propietario o admin — también una política de datos que conserva las trazas menos tiempo. Una nueva política de datos que no fija retención mantiene el plazo vigente. Una respuesta reutilizada se sirve 7 días como máximo y se elimina una vez caducada, sea cual sea su plazo.
  • El derecho que se le aplica puede fijar un mínimo: la pantalla lo muestra y rechaza un plazo más corto, y la purga nunca baja de él.
  • El registro de decisiones selladas se conserva tanto tiempo como diga su plan o su contrato, y nunca menos que ese mínimo. Una vez aplicado, sus entradas más antiguas se retiran cada noche tras un punto de control sellado, de modo que la cadena sigue siendo verificable desde su nuevo inicio; la pantalla dice si ya se aplica.
  • Una retención por litigio conserva lo que designa, sean cuales sean los plazos. Un propietario la coloca sobre decisiones elegidas; mientras está activa, la purga conserva sus trazas, un borrado conserva su envoltorio, y el espacio no puede eliminarse ni borrarse con su propietario (legal_hold_active). Levantarla requiere cuatro ojos (retenciones por litigio).

Rutas de alerta

Cada alerta del espacio de trabajo va a las rutas de Ajustes › Integraciones y alertas › Alertas, el único lugar donde se fija el destino de una alerta.

  • Una ruta nombra un canal — PagerDuty, un webhook de canal de Slack o Teams, o una dirección de correo — y una gravedad mínima (info, low, medium, high o critical): recibe las alertas de esa gravedad y superiores. Un retraso solo las envía después de él, para avisar a la guardia solo si nadie actuó.
  • Las alertas: aprobaciones y excepciones a la espera de una decisión; alertas de gobernanza (llamadas rechazadas, residencia, huecos de prueba, usos sin mandato); anomalías de inicio de sesión (fallos repetidos, cambios de rol rápidos); caídas de proveedores; cambios de versión de modelos y regresiones; bucles de agentes que Azoth detuvo; la cuota de decisiones selladas cerca de su límite o alcanzada.
  • Los propietarios y admins modifican las rutas y envían una prueba a una ruta de Slack o PagerDuty; los responsables de seguridad las ven.
  • Los umbrales de presupuesto van a los destinos fijados con cada presupuesto. Los eventos de gobernanza también pueden enviarse a sus propios endpoints (webhooks de gobernanza).
  • Nombre un contacto de seguridad en Ajustes › Organización: además de los propietarios y admins, se le informa de una violación de datos personales que afecte a los datos del espacio.

Autenticación de dos factores

Cada persona activa la autenticación de dos factores con una aplicación de autenticación (TOTP) en Ajustes › Acceso; desde entonces, cada inicio de sesión pide su código de 6 dígitos.

  • Un propietario puede exigirla a todos los miembros del espacio. La sesión del propio propietario debe haberla pasado antes, para que nadie deje el espacio sin acceso; después, un miembro que no la tiene es rechazado (mfa_required_by_workspace) hasta que la active y vuelva a iniciar sesión. La revisión de accesos indica si se exige.
  • Decidir una aprobación desde Slack o Teams requiere una cuenta vinculada con MFA.
  • El propio equipo de Azoth la usa siempre: una pantalla de administración de la plataforma rechaza una sesión sin ella.
  • Una clave API no inicia sesión, así que la autenticación de dos factores no se le aplica: dé a las claves ámbitos y una caducidad, y revíselas.

Modo de gobernanza

Un propietario o un admin elige con qué rigor gobierna la pasarela el espacio en Ajustes › Organización › Modo de gobernanza:

Observar
Las llamadas sin mandato aprobado se sirven y se marcan en el registro: no se bloquea nada nuevo.
Gobernar
Lo mismo, más una alerta a los administradores por cada una de esas llamadas.
Aplicar
Las llamadas sin mandato aprobado se bloquean, y cada bloqueo se sella.
  • El modo decide qué pasa con las llamadas no vinculadas a un mandato aprobado, con los mandatos de los que ya nadie responde o vencidos, y con el derecho aplicable. Las reglas, los presupuestos, la parada de emergencia y las prácticas prohibidas (Reglamento de IA, art. 5) bloquean llamadas en todos los modos.
  • El modo que se aplica es el más estricto entre el del despliegue y el del espacio: un espacio solo puede endurecerlo, nunca relajarlo. La pantalla atenúa los modos más flexibles que el del despliegue.
  • Cada cambio se registra en la auditoría antes de escribirse y después se sella. Cada decisión sella el modo en que se tomó, de modo que un expediente muestra si Azoth observaba o aplicaba.
  • Si la elección del espacio no puede leerse, nada se relaja: el último valor leído se conserva hasta 10 minutos y después la llamada se gobierna en modo Aplicar.
  • Un sistema clasificado como prohibido se rechaza en todos los modos, sea cual sea su estado: ningún modo, excepción ni dispensa lo sirve.
  • Antes de elegir Aplicar, revise Mandatos › Sistemas y agentes: toda llamada no vinculada a un mandato aprobado se rechaza entonces.
  • Los agentes tienen su propia postura, en Ajustes › Acceso › Postura Guard de los agentes: Observar comprueba cada llamada a herramienta frente a su mandato y la sella; Aplicar bloquea las llamadas fuera del mandato y retiene las acciones irreversibles para una persona. También ella solo puede ser más estricta que la del despliegue.

Atribución humana

Una decisión puede nombrar a la persona para la que se hizo una llamada — sellada como seudónimo, nunca como nombre — para que un expediente pueda decir quién la lanzó. Se configura en Ajustes › Acceso › Quién hizo cada llamada.

Clave personal
Cada llamada es de su titular: el propietario o admin que la creó, para sí mismo. Nunca puede nombrar a otra persona, y se revoca cuando su titular sale del espacio o es borrado.
Clave de servicio que puede nombrar a la persona
Se autoriza al crear la clave. La aplicación envía X-Azoth-On-Behalf-Of con el id SCIM o la dirección de correo de la persona, y la llamada se atribuye a ese miembro.
Clave de servicio
No nombra a nadie, como antes.
  • El tipo de una clave se fija al crearla: para cambiarlo, cree otra clave.
  • El identificador que envía la aplicación se asocia a un miembro y después se descarta: nunca se guarda, se registra ni se sella. La decisión sella un seudónimo del miembro — distinto en cada espacio — y cómo se conoció a la persona. Borrar a la persona elimina el vínculo del seudónimo, y la cadena sigue verificándose.
  • Un encabezado que no nombra a ningún miembro se sirve y se registra como no resuelto. X-Azoth-End-User es otra cosa: el visitante anónimo de un sistema público.
  • Un propietario o admin puede activar Exigir que cada llamada nombre a su persona: una llamada que no nombra a ningún miembro se rechaza entonces, y el rechazo se sella. El cambio se registra en la auditoría y se sella.
  • Los rechazos: on_behalf_of_not_allowed (403: una clave que no puede nombrar personas envió el encabezado), human_identity_required (400: el espacio exige una persona y la llamada no nombra ninguna), identity_unavailable (503: la clave o la exigencia no pudo leerse, y la llamada se rechaza en lugar de servirse sin control), invalid_on_behalf_of (400: un encabezado mal formado). Cada uno se explica en Códigos de error.
  • En un despliegue con su ajuste por defecto, mientras un espacio no use la atribución — una clave personal, una clave autorizada a nombrar personas o la exigencia activada —, sus llamadas se sirven exactamente como antes, y el X-Azoth-On-Behalf-Of que envía se ignora.