Añadir y verificar un dominio

Esta página te guía para añadir un dominio a tu organización y verificarlo. Necesitarás unos diez minutos y acceso a la configuración DNS del dominio, o la ayuda de la persona que lo tiene.

Antes de empezar

Permisos. Necesitas el rol Propietario o Administrador. Si la pestaña Dominios aparece desactivada, o no ves el botón Añadir dominio, pide ayuda a un administrador de tu organización.
Acceso al DNS del dominio. La verificación requiere añadir un registro TXT al dominio. Esto se hace en el panel de la empresa que aloja el DNS del dominio, no en BreezeAuth.

Encontrar los dominios de tu organización

Inicia sesión en la consola de administración.
En la barra lateral, selecciona Organización. Se abre la página Gestionar organización.
Selecciona la pestaña Dominios.

La lista muestra todos los dominios añadidos a la organización, cuándo se añadieron y su estado: Verificado, con la fecha de verificación, o Pendiente.

Consejo: mientras tu organización no tenga ningún dominio verificado, la consola de administración se lo recuerda a los administradores con el cuadro Verifica un dominio para habilitar usuarios gestionados. Selecciona Verificar un dominio para ir directamente a esta pestaña, o Ahora no para ocultarlo hasta tu próxima sesión.

Añadir un dominio

En la pestaña Dominios, selecciona Añadir dominio. Se abre el cuadro Añadir un nuevo dominio.
En Dominio, introduce solo el dominio, sin https://, www. ni una dirección de correo. Por ejemplo: ejemplo.com.
Selecciona Confirmar.

El dominio se añade como Pendiente y se abre el cuadro Verificar dominio con el registro DNS que hay que publicar.

Se aplican algunas reglas:

El dominio debe ser un nombre de dominio completo, como ejemplo.com o ejemplo.es. Se admiten letras, números, guiones y puntos. Las mayúsculas se convierten en minúsculas.
Añade el dominio exactamente como aparece después de la @ en las direcciones de correo. Si algunas personas usan @ventas.ejemplo.com, añade ventas.ejemplo.com como un dominio aparte.
Si ves Este dominio ya se ha añadido a esta organización., el dominio ya está en la lista.
Si ves Este dominio ya está verificado para otra organización., otra organización de BreezeAuth ya ha demostrado que es suyo. Si crees que se trata de un error, contacta con soporte.

Publicar el registro DNS

El cuadro Verificar dominio muestra el registro que hay que añadir al DNS del dominio:

Campo	Qué introducir
Tipo de registro	`TXT`
Nombre / Host	`@` o en blanco, es decir, el propio dominio. Algunos proveedores te piden que escribas el dominio completo.
Valor	El valor que se muestra en el cuadro, como `breeze-auth-domain-verification=6f1c…`. Usa el botón de copiar que hay al lado.

Selecciona el botón de copiar junto a Valor.
En otra pestaña del navegador, abre la configuración DNS de tu dominio en tu proveedor de DNS.
Crea un nuevo registro de tipo TXT para el propio dominio (@) y pega el valor.
Guarda el registro.

Si no puedes cambiar el DNS tú mismo, envía los tres valores anteriores a la persona que gestiona tu dominio. Puedes cerrar el cuadro y volver más tarde: el valor no cambia y se vuelve a mostrar al seleccionar Verificar dominio.

Nota: añadir un registro TXT no afecta a tu sitio web ni a tu correo. Un dominio puede tener muchos registros TXT, por ejemplo para la seguridad del correo (SPF) o para otros servicios. No modifiques ni elimines los existentes; añade uno nuevo.

Iniciar la verificación

En la pestaña Dominios, selecciona Verificar dominio junto al dominio pendiente, si el cuadro no está abierto.
Selecciona Iniciar la verificación.
Espera unos segundos mientras BreezeAuth consulta el DNS del dominio.

Si se encuentra el registro, verás Dominio verificado correctamente. y el dominio aparecerá como Verificado. Después, BreezeAuth convierte en segundo plano las cuentas del dominio en usuarios gestionados. Consulta Qué pasa con las cuentas existentes.

Si ves No se ha podido verificar el dominio, todavía no se ha encontrado el registro. El dominio sigue Pendiente y puedes volver a intentarlo en cualquier momento.

Importante: los cambios de DNS tardan un tiempo en propagarse por internet. Normalmente son unos minutos, pero según tu proveedor de DNS pueden ser varias horas. Hasta entonces, la verificación falla. BreezeAuth no lo reintenta automáticamente: vuelve a seleccionar Iniciar la verificación más tarde.

Si la verificación sigue fallando

Comprueba	Qué hacer
El registro está en un nombre incorrecto	El registro debe estar en el propio dominio (`@`), no en un subdominio como `www`. Algunos proveedores añaden el dominio automáticamente y convierten `ejemplo.com` en `ejemplo.com.ejemplo.com`.
El valor está incompleto	Pega el valor completo, incluido el prefijo `breeze-auth-domain-verification=`, sin espacios ni comillas añadidos a mano.
El registro está en otro dominio	Asegúrate de haber editado la zona DNS del mismo dominio que añadiste en BreezeAuth.
El cambio de DNS aún no se ha propagado	Espera un poco y vuelve a intentarlo. Tu equipo de TI puede comprobar lo que ve internet con una herramienta como `nslookup -type=TXT ejemplo.com` o un servicio de consulta DNS en línea.
El dominio usa otro proveedor de DNS	Si has cambiado el dominio de proveedor hace poco, el registro debe añadirse en el proveedor que responde actualmente por el dominio (sus “servidores de nombres”).

Después de la verificación

Conserva el registro. BreezeAuth solo comprueba el registro cuando inicias la verificación, así que eliminarlo después no la deshace. Aun así, te recomendamos conservarlo, para que quien revise tu DNS sepa por qué está ahí.
Verifica tus otros dominios. Repite estos pasos para cada dominio que usen las direcciones de correo de tu gente.
Revisa las cuentas existentes. Algunas personas pueden aparecer ahora como Revisión pendiente en Usuarios. Consulta Revisar las cuentas pendientes.

Eliminar un dominio

En la pestaña Dominios, selecciona el icono de la papelera junto al dominio.
Confirma en el cuadro Eliminar dominio.

Importante: eliminar un dominio no se puede deshacer. Si lo vuelves a añadir más tarde, BreezeAuth genera un valor nuevo y tendrás que actualizar el registro DNS y verificarlo de nuevo.

Cuando eliminas un dominio verificado:

Las cuentas que ya gestiona tu organización siguen siendo gestionadas. No vuelven a ser invitadas.
Las personas que añadas a partir de entonces con un correo de ese dominio se añaden como invitadas.
Cualquiera puede volver a crear una cuenta personal de BreezeAuth con un correo de ese dominio, y otra organización puede añadirlo y verificarlo.

Eliminar un dominio pendiente no afecta a ninguna cuenta.

Los cambios quedan auditados

La adición, la verificación y la eliminación de dominios quedan registradas en los Registros de auditoría de tu organización, junto con quién hizo el cambio y cuándo. Si tus sistemas necesitan reaccionar a estos cambios, suscribe un webhook a los eventos de dominio.