Verificar tu dominio personalizado para GitHub Pages

Puedes incrementar la seguridad de tu dominio personalizado y evitar los ataques de adquisición si verificas tu dominio.

¿Quién puede utilizar esta característica?

GitHub Pages is available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see GitHub’s plans.

GitHub Pages now uses GitHub Actions to execute the Jekyll build. When using a branch as the source of your build, GitHub Actions must be enabled in your repository if you want to use the built-in Jekyll workflow. Alternatively, if GitHub Actions is unavailable or disabled, adding a .nojekyll file to the root of your source branch will bypass the Jekyll build process and deploy the content directly. For more information on enabling GitHub Actions, see Managing GitHub Actions settings for a repository.

En este artículo

Acerca de la verificación de dominios para GitHub pages

Cuando se verifica un dominio personalizado para una cuenta personal, solo podrán utilizarse los repositorios que le pertenezcan para publicar un sitio de GitHub Pages en el dominio personalizado verificado o en los subdominios inmediatos de los dominios. De forma similar, cuando se verifica un dominio personalizado para una organización, solo podrán utilizarse los repositorios que le pertenezcan para publicar un sitio de GitHub Pages en el dominio personalizado verificado o en los subdominios inmediatos de los dominios.

El verificar tu dominio impide que otros usuarios de GitHub lo reclamen y lo utilicen para publicar su propio sitio de GitHub Pages. Puede haber robo de dominio cuando borras tu repositorio, cuando bajas de categoría tu plan de facturación o después de cualquier otro cambio que desenlace al dominio personalizado o inhabilite a GitHub Pages mientras el dominio sigue configurado para GitHub Pages y no esté verificado.

Cuando verificas un dominio, cualquier subdominio inmediato también se incluye en dicha verificación. Por ejemplo, si se comprueba el dominio personalizado github.com, docs.github.com, support.github.com y cualquier otro subdominio inmediato también se protegerá de las adquisiciones.

Warning

Se recomienda encarecidamente no usar registros DNS comodín, como *.example.com. Estos registros te ponen en riesgo inmediato de adquisición de dominio, incluso si compruebas el dominio. Por ejemplo, si compruebas example.com, esto impide que alguien use a.example.com, pero todavía podrían hacerse cargo de b.a.example.com (que está cubierto por el registro DNS con caracteres comodín). Para obtener más información, vea «Verificar tu dominio personalizado para GitHub Pages».

También se puede verificar un dominio para tu organización o empresa, el cual muestre una insignia de "Verificado" en el perfil de la misma y, que en GitHub Enterprise Cloud, te permita restringir las notificaciones a las direcciones de correo electrónico utilizando el dominio verificado. Para más información, consulta Verificar o aprobar un dominio para tu organización y Verificar o aprobar un dominio para tu empresa.

Comprobación de un nombre de dominio que ya está en uso

Puede que estés verificando un dominio que posees, que está actualmente en uso por parte de otro usuario u organización, para que esté disponible para tu sitio web de GitHub Pages. En este caso, el dominio se liberará inmediatamente de los sitios web de GitHub Pages que pertenecen a otros usuarios u organizaciones. Si estás intentando comprobar un dominio ya verificado (por otro usuario u organización), el proceso de liberación no se realizará correctamente.

Verificar un dominio para tu sitio de usuario

  1. En la esquina superior derecha de cualquier página en GitHub, haga clic en la fotografía de perfil y luego en Configuración.

  2. En la sección "Código, planificación y automatización" de la barra lateral, haz clic en Páginas.

  3. A la derecha, haga clic en Add a domain (Agregar un dominio).

  4. En "¿Qué dominio quieres agregar?", escribe el dominio que desees verificar y haz clic en Agregar dominio.

    Captura de pantalla de un cuadro de texto para agregar un dominio comprobado en GitHub Pages, rellenado con "example.com". Debajo del texto hay un botón verde con la etiqueta "Agregar dominio".

  5. Sigue las instrucciones debajo de "Agregar un registro de TXT de DNS" para crear el registro de TXT con tu servicio de hospedaje de dominio.

    Captura de pantalla de las instrucciones de GitHub Pages para agregar un registro TXT a la configuración DNS de example.com.

  6. Espera a que cambie tu configuración de DNS, esto podría suceder de inmediato o tomar hasta 24 horas. Puede confirmar el cambio a su configuración de DNS mediante la ejecución del comando dig en la línea de comandos. En el comando siguiente, reemplace USERNAME por el nombre de usuario y example.com por el dominio que está comprobando. Si se actualizó tu configuración de DNS, deberías ver tu registro de TXT nuevo en la salida.

    dig _github-pages-challenge-USERNAME.example.com +nostats +nocomments +nocmd TXT

  7. Después de confirmar que tu configuración de DNS se actualizó, puedes verificar el dominio. Si el cambio no fue inmediato y navegó fuera de la página anterior, vuelva a la configuración de las páginas realizando los siguientes pasos y, a la derecha del dominio, haga clic en y luego en Continue verifying.

    Captura de pantalla de la configuración de GitHub Pages que muestra dominios comprobados. Debajo del icono de kebab horizontal a la derecha, la opción desplegable "Seguir comprobando" aparece en naranja oscuro.

  8. Para comprobar el dominio, haga clic en Verify (Comprobar).

  9. Para asegurarte de que tu dominio personalizado permanezca verificado, mantén el registro de TXT en la configuración DNS de tu dominio.

Verificar un dominio para tu sitio de organización

Los propietarios de organización pueden verificar los dominios personalizados para su organización.

  1. En la esquina superior derecha de GitHub, seleccione la foto del perfil y haga clic en Sus organizaciones.

  2. Junto a la organización, haga clic en Settings.

  3. En la sección "Código, planificación y automatización" de la barra lateral, haz clic en Páginas.

  4. A la derecha, haga clic en Add a domain (Agregar un dominio).

  5. En "¿Qué dominio quieres agregar?", escribe el dominio que desees verificar y haz clic en Agregar dominio.

    Captura de pantalla de un cuadro de texto para agregar un dominio comprobado en GitHub Pages, rellenado con "example.com". Debajo del texto hay un botón verde con la etiqueta "Agregar dominio".

  6. Sigue las instrucciones debajo de "Agregar un registro de TXT de DNS" para crear el registro de TXT con tu servicio de hospedaje de dominio.

    Captura de pantalla de las instrucciones de GitHub Pages para agregar un registro TXT a la configuración DNS de example.com.

  7. Espera a que cambie la configuración de DNS. Esto puede ser inmediato o tardar hasta 24 horas. Puede confirmar el cambio a su configuración de DNS mediante la ejecución del comando dig en la línea de comandos. En el comando siguiente, reemplace ORGANIZATION por el nombre de la organización y example.com por el dominio que está comprobando. Si se actualizó tu configuración de DNS, deberías ver tu registro de TXT nuevo en la salida.

    dig _github-pages-challenge-ORGANIZATION.example.com +nostats +nocomments +nocmd TXT

  8. Después de confirmar que tu configuración de DNS se actualizó, puedes verificar el dominio. Si el cambio no fue inmediato y navegó fuera de la página anterior, vuelva a la configuración de las páginas realizando los siguientes pasos y, a la derecha del dominio, haga clic en y luego en Continue verifying.

    Captura de pantalla de la configuración de GitHub Pages que muestra dominios comprobados. Debajo del icono de kebab horizontal a la derecha, la opción desplegable "Seguir comprobando" aparece en naranja oscuro.

  9. Para comprobar el dominio, haga clic en Verify (Comprobar).

  10. Para asegurarte de que tu dominio personalizado permanezca verificado, mantén el registro de TXT en la configuración DNS de tu dominio.