Herramientas para dominios personalizados
Conecta y gestiona dominios mediante las herramientas de hosting.
En esta página
Conecta un dominio, comprueba su DNS y elige el dominio principal. Configuras los registros DNS en tu proveedor.
Nota
La conexión se aplica al Space. Eres miembro y el Space no está bloqueado. Un Space es un espacio de trabajo compartido en la app.
Para las cuatro herramientas, necesitas el rol Propietario, Administrador o Usuario. El rol Solo lectura no basta.
hosting_add_domain Add domain
cambia datos
Añade un dominio personalizado a un proyecto. El dominio queda en espera: solo sirve el sitio web cuando el DNS está configurado, hosting_check_domain lo ha comprobado como correcto y existe el certificado.
La respuesta indica los registros DNS necesarios. Si faltan porque la transferencia está pendiente, ejecuta hosting_check_domain.
- El nombre de host tiene como máximo 253 caracteres, no es una dirección IP y se indica sin
https://ni ruta. TEISENDA rechaza nombres de host de las zonasteisenda.com,teisendapages.comyteisendahosting.com. - Un proyecto tiene como máximo 19 dominios personalizados.
- El plan limita los dominios personalizados por Space: puede tener tantos como proyectos permita su plan, es decir, 1 en Free y 10 en Max. Con Max contratado hay paquetes que añaden 5 proyectos y, por tanto, 5 dominios personalizados cada uno; consulta Comprar y dar de baja paquetes. Si se alcanza esa cantidad, TEISENDA rechaza la llamada y no cambia nada.
¿Qué registros DNS indica la respuesta y para qué sirven?
La lista solo incluye un registro AAAA cuando el nodo de hosting indica uno. El registro TXT con el nombre _teisenda-hosting.<Domain> y el valor teisenda-hosting=<Nachweis> demuestra que el dominio te pertenece.
| Parámetro | Tipo | Requisito | Descripción |
|---|---|---|---|
space | Número entero | obligatorio | El ID del Space de diez dígitos. |
project | Número entero | obligatorio | El número del proyecto, tal como lo muestra hosting_list_projects. |
hostname | Texto | obligatorio | Un nombre de host sin https:// ni ruta, por ejemplo, www.example.com. |
hosting_check_domain Check domain
cambia datos
Comprueba el DNS y activa el dominio si los registros son correctos. Después se emite el certificado en segundo plano.
Vuelve a ejecutar la herramienta para comprobar el estado actual. Si la emisión del certificado ha fallado, inicia otro intento.
Si el DNS no es correcto, la respuesta indica los problemas y Configura el registro CNAME o el registro A y, además, el registro TXT como prueba de titularidad..
| Parámetro | Tipo | Requisito | Descripción |
|---|---|---|---|
space | Número entero | obligatorio | El ID del Space de diez dígitos. |
project | Número entero | obligatorio | El número del proyecto, tal como lo muestra hosting_list_projects. |
hostname | Texto | obligatorio | Un nombre de host sin https:// ni ruta, por ejemplo, www.example.com. |
hosting_set_primary_domain Set primary domain
cambia datoselimina, sobrescribe o cambia lo visible
Establece el dominio principal: la dirección a la que redirigen todas las demás direcciones del proyecto. Es un dominio personalizado activo o, si falta hostname, la dirección de TEISENDA del proyecto.
El dominio principal cambia en la primera llamada. Un dominio personalizado debe estar activo; los visitantes ven el cambio en cuanto se transfiere.
| Parámetro | Tipo | Requisito | Descripción |
|---|---|---|---|
space | Número entero | obligatorio | El ID del Space de diez dígitos. |
project | Número entero | obligatorio | El número del proyecto, tal como lo muestra hosting_list_projects. |
hostname | Texto | opcional | El dominio personalizado que se convierte en principal: un nombre de host sin https:// ni ruta, por ejemplo, www.example.com. Si falta, la dirección de TEISENDA se convierte en principal. |
hosting_remove_domain Remove domain
cambia datoselimina, sobrescribe o cambia lo visibledos pasos
Elimina el dominio y el certificado. Si era el dominio principal, vuelve a aplicarse la dirección de TEISENDA.
Ejecuta primero la herramienta sin confirm. Solo la segunda llamada con la frase de confirmación devuelta elimina el dominio; la aplicación debe obtener antes tu consentimiento.
| Parámetro | Tipo | Requisito | Descripción |
|---|---|---|---|
space | Número entero | obligatorio | El ID del Space de diez dígitos. |
project | Número entero | obligatorio | El número del proyecto, tal como lo muestra hosting_list_projects. |
hostname | Texto | obligatorio | Un nombre de host sin https:// ni ruta, por ejemplo, www.example.com. |
confirm | Texto | opcional | La aplicación debe omitirlo en la primera llamada; la respuesta indica entonces una frase de confirmación. Solo debe enviar exactamente esa frase después de obtener tu consentimiento. |
Si algo falla
Cuando una solución menciona una herramienta, pide a la aplicación que la ejecute. El mensaje sobre el plan termina indicando dónde encontrar el plan del Space en TEISENDA; en los ajustes, la entrada se llama Facturación.
Ese no es un nombre de host válido. Introdúcelo sin https:// y sin ruta.
El nombre de host no es válido. Tiene como máximo 253 caracteres, no es una dirección IP y se indica sin https:// ni ruta. Indica solo el nombre de host, por ejemplo, www.example.com.
Este dominio está bloqueado.
El nombre de host pertenece a una zona que ningún proyecto puede usar: teisenda.com o teisendapages.com. Usa un dominio personalizado.
Las direcciones de esta zona las asigna únicamente TEISENDA.
El nombre de host pertenece a la zona teisendahosting.com, donde TEISENDA asigna las direcciones de TEISENDA. Usa un dominio personalizado.
Este dominio ya lleva a un proyecto.
El dominio ya apunta a un proyecto: a este, a otro del Space o a uno de otro Space. Aparece el mismo mensaje si el nodo de hosting conoce el dominio como perteneciente a un proyecto. Un nombre de host solo puede pertenecer a un proyecto entre todos los Spaces. Elimínalo primero del otro proyecto con hosting_remove_domain o usa otro nombre de host.
No se permiten más de … dominios propios.
El proyecto ya tiene 19 dominios personalizados. Elimina primero un dominio.
El plan de este Space no permite más dominios propios: … de … ya están añadidos. No se ha cambiado nada. El plan de este Space figura en TEISENDA, en Ajustes › Planes.
El plan del Space no permite otro dominio personalizado: puede tener tantos como proyectos permita su plan. TEISENDA no ha cambiado nada. Elimina un dominio. Max y sus paquetes permiten más proyectos y, por tanto, más dominios personalizados; consulta Planes Free y Max y Comprar y dar de baja paquetes.
El dominio … no pertenece a este proyecto.
El dominio no pertenece a este proyecto. Consulta los dominios del proyecto con hosting_project_status.
Solo es posible cuando el dominio está activo.
Se ha llamado a hosting_set_primary_domain para un dominio que todavía no está activo. Completa la configuración del DNS y ejecuta hosting_check_domain hasta que esté activo.
El DNS de … todavía no es correcto:
No es un rechazo: hosting_check_domain ha detectado que el DNS del dominio todavía no es correcto. Después de la frase aparece una línea por problema; las líneas están en la siguiente sección. Configura los registros en tu proveedor de DNS y vuelve a ejecutar hosting_check_domain.
Problemas que indica hosting_check_domain
Ninguna de estas líneas es un rechazo. Las nueve primeras aparecen en el resultado de hosting_check_domain mientras el DNS no sea correcto. Las tres últimas son el problema guardado en el dominio; hosting_project_status y hosting_check_domain lo muestran como problema del dominio.
No hay ningún registro DNS para el dominio.
El nombre del dominio no apunta a ningún sitio: al final de su cadena CNAME, el nodo de hosting no encuentra ni un registro A ni uno AAAA. Configura el registro CNAME o A que indica el resultado.
Falta el registro A.
El dominio tiene un registro AAAA pero ningún registro A. Configura el registro A con el valor indicado en el resultado o, en su lugar, el registro CNAME.
Hay otro registro A que apunta a otro sitio.
Además del registro A que apunta al nodo de hosting, el dominio tiene otro que apunta a otro lugar. Elimina el otro registro A en tu proveedor de DNS.
El dominio apunta a otro servidor.
El dominio tiene registros A y ninguno contiene la dirección del nodo de hosting: apunta a otro servidor. Sustituye el registro CNAME o A existente por el indicado en el resultado.
Hay un registro AAAA que apunta a otro sitio.
El dominio tiene un registro AAAA que no corresponde a la dirección IPv6 del nodo de hosting. La autoridad de certificación da prioridad a IPv6 y falla con un registro así. Elimina ese registro AAAA o configúralo con el valor que indica el resultado, si este indica uno.
Un registro CAA prohíbe la emisión del certificado.
Un registro CAA del dominio o de un nombre superior solo permite certificados de autoridades distintas de Let's Encrypt, que usa el nodo de hosting. Cambia o elimina el registro CAA en tu proveedor de DNS para permitir letsencrypt.org.
Falta la prueba de titularidad: el registro TXT no está configurado.
Falta la prueba de propiedad: el dominio no apunta mediante CNAME a una dirección del mismo proyecto en teisendahosting.com y el registro TXT _teisenda-hosting.<Domain> tampoco contiene el valor esperado. Un registro A por sí solo no demuestra nada. Configura el registro TXT con el nombre y el valor indicados en el resultado.
El DNS del dominio no responde.
Los resolutores que consulta el nodo de hosting no han respondido para el dominio. Por eso no se ha podido comprobar el DNS. Comprueba en tu proveedor de DNS que el dominio se resuelve y vuelve a ejecutar hosting_check_domain.
Los registros todavía no han llegado a todas partes. Inténtalo de nuevo en unos minutos.
Uno de los dos resolutores públicos que consulta el nodo de hosting ya ve los registros correctos y el otro todavía no. En ese caso, esta línea aparece sola. Espera unos minutos y vuelve a ejecutar hosting_check_domain.
El DNS todavía no es correcto.
Un intento de activar el dominio encontró que el DNS no era correcto en ese momento. Por eso no se ha solicitado un certificado. Corrige el DNS y vuelve a ejecutar hosting_check_domain.
El certificado ha sido rechazado.
La emisión del certificado ha fallado, sea cual sea el motivo. El dominio pasa al estado failed. Comprueba los registros DNS, especialmente cualquier registro CAA, y vuelve a ejecutar hosting_check_domain; inicia otro intento en cuanto el DNS es correcto. Si el problema persiste, contacta con soporte.
El nodo de hosting informa de un problema con este dominio.
El nodo de hosting indica algo para lo que TEISENDA no tiene una frase específica, por ejemplo que un reinicio del nodo ha interrumpido la emisión del certificado. Vuelve a ejecutar hosting_check_domain.
Los mensajes sobre el Space y el número de proyecto aparecen en las herramientas para Spaces y proyectos. Los demás que pueden aparecer con cualquier herramienta están en Resolver errores del Connector.