Skip to content

Declarar los dominios de correo del tenant

Reclama los dominios de correo que posee tu organización, para que el inicio de sesión mediante tu proveedor de identidad se pueda dirigir y admitir para las direcciones de esos dominios, y elimina una reclamación que ya no necesitas.

Quién puede hacerlo

Un administrador del tenant o un administrador de acceso del tenant, o un superadministrador de plataforma que trabaja dentro de tu tenant.

  • La sección Dominios de correo verificados se muestra a quien puede leer los proveedores de identidad de tu tenant (admin.tenant.idp.read).
  • Reclamar y eliminar requieren el permiso para configurar la federación de identidad (admin.tenant.idp.override). Sin él, las reclamaciones se listan sin campo para reclamar una y sin control para eliminarla.

Antes de empezar

  • Una reclamación se crea sin verificar, y una reclamación sin verificar no dirige nada. Tu tenant no puede verificar su propia reclamación: la verifica un administrador de la plataforma cuando se establece que tu organización posee el dominio.
  • El proveedor de identidad propio de tu tenant solo se puede habilitar cuando el tenant tiene al menos un dominio verificado.
  • Reclamar un dominio solo está disponible en un despliegue SaaS. En un despliegue operado por el cliente, los dominios de correo de un tenant no intervienen en el inicio de sesión: el inicio de sesión federado se admite según los dominios verificados propios del despliegue, que declara el operador de la plataforma, y tu proveedor se puede habilitar cuando el despliegue tiene al menos uno. Allí la sección muestra Los dominios de correo no tienen efecto en este despliegue y no ofrece campo para reclamar uno; un dominio ya listado todavía se puede eliminar.
  • Un dominio es un nombre de host de varias etiquetas, como example-bank.com, sin la @. Se guarda en minúsculas, así que Example-Bank.com y example-bank.com son la misma reclamación.
  • Reclamar y eliminar piden un inicio de sesión reciente. Si el tuyo es demasiado antiguo, la consola te pide que confirmes quién eres antes de continuar.
  • En un despliegue SaaS, un operador de la plataforma que trabaja dentro de tu tenant con una sesión de acceso de soporte no puede reclamar un dominio: un dominio verificado admite el inicio de sesión federado para todas sus direcciones.
  • En un despliegue operado por el cliente, eliminar un dominio listado requiere que el operador de la plataforma haya delegado la federación de identidad a tu tenant.

Pasos

  1. Abre Configuración y selecciona la pestaña Integraciones.
  2. En la fila Federación de identidad, selecciona Gestionar.
  3. Busca Dominios de correo verificados.
  4. Para reclamar un dominio, escríbelo en el campo Dominio de correo a reclamar y selecciona Reclamar dominio.
  5. Pide a tu administrador de la plataforma que verifique la reclamación. En un despliegue operado por el cliente no hay nada que reclamar: pide en su lugar al operador de la plataforma que declare el dominio entre los dominios verificados del despliegue.
  6. Para eliminar una reclamación, selecciona el icono de papelera de su fila (Eliminar dominio). El diálogo del mismo título nombra el dominio; confirma con Eliminar dominio.

Qué ves cuando funcionó

Una reclamación aparece en la lista marcada como Sin verificar, y la consola confirma Dominio reclamado. Cuando un administrador de la plataforma la verifica, la fila dice Verificado, con el método de verificación al lado. Una reclamación eliminada sale de la lista, con Dominio eliminado. Ambos cambios se registran en la pista de auditoría. Una vez verificado, el dominio cuenta para habilitar tu proveedor de identidad y dirige el inicio de sesión de sus direcciones.

Si falla

Una reclamación rechazada se muestra encima del campo, con el dominio que escribiste todavía allí. Una eliminación rechazada se muestra dentro del diálogo, que sigue abierto.

Qué ves Causa Qué hacer
El dominio se rechaza por no ser válido El valor no es un host válido de varias etiquetas Escribe la parte de la dirección que va después de la @, por ejemplo example-bank.com
Un rechazo que indica que el dominio ya está reclamado Tu tenant ya reclamó este dominio No hay nada que hacer
La operación no está disponible mientras se actúa en nombre de un tenant (This operation is not available while acting on behalf of a tenant.) Un operador de la plataforma en una sesión de acceso de soporte intentó reclamarlo en un despliegue SaaS Lo reclama el propio administrador del tenant
Un rechazo que indica que la federación de identidad no está delegada a tu tenant En un despliegue operado por el cliente, el operador de la plataforma no delegó la federación de identidad a tu tenant Pide a tu operador de la plataforma que la delegue
403 deployment-not-supported en una reclamación mediante la API El despliegue lo opera el cliente, y allí los dominios de correo de un tenant no intervienen en el inicio de sesión Pide al operador de la plataforma que declare el dominio entre los dominios verificados del despliegue
Una eliminación rechazada porque no se encontró La reclamación ya no existe en tu tenant Cierra el diálogo y vuelve a cargar la página para leer la lista actual
El paso de habilitación del proveedor muestra Declara y verifica al menos un dominio de correo En un despliegue SaaS, todavía no hay ninguna reclamación verificada de tu tenant; en un despliegue operado por el cliente, el despliegue no declara ningún dominio verificado En SaaS, reclama un dominio y pide que se verifique; en un despliegue operado por el cliente, pide al operador de la plataforma que declare uno

Sin la consola

Superficie Cómo
API POST /api/v3/admin/tenants/{tenantId}/idp/email-domains con {"domain": "example-bank.com"} (operación createEmailDomain)
API DELETE /api/v3/admin/tenants/{tenantId}/idp/email-domains/{id} (operación deleteEmailDomain)

GET sobre la misma colección (operación listEmailDomains) responde appliesToSignIn y domains. appliesToSignIn es el veredicto del servidor: true en un despliegue SaaS y false en uno operado por el cliente, donde una reclamación se rechaza con 403 deployment-not-supported y un dominio listado solo se puede eliminar. Cada elemento de domains indica verified, con el método y la hora de verificación una vez verificado.

Ningún comando de ankasecure-km ni método del Admin SDK gestiona los dominios de correo.

Relacionado

Estas páginas están en inglés: