Verificando seu domínio personalizado para o GitHub Pages

Você pode aumentar a segurança de seu domínio personalizado e evitar ataques verificando seu domínio.

Quem pode usar esse recurso?

O GitHub Pages está disponível em repositórios públicos com o GitHub Free e o GitHub Free para organizações, e em repositórios públicos e privados com o GitHub Pro, o GitHub Team, o GitHub Enterprise Cloud e o GitHub Enterprise Server. Para mais informações, confira "Planos do GitHub".

O GitHub Pages agora usa o GitHub Actions para executar a compilação Jekyll. Ao usar uma ramificação como a origem da sua compilação, o GitHub Actions deverá estar habilitado em seu repositório se você quiser usar o fluxo de trabalho interno do Jekyll. Como alternativa, se o GitHub Actions não estiver disponível ou estiver desabilitado, adicionar um .nojekyll arquivo à raiz da ramificação de origem ignorará o processo de compilação do Jekyll e implantará o conteúdo diretamente. Para mais informações sobre ativar o GitHub Actions, confira "Gerenciando as configurações do GitHub Actions para um repositório".

Neste artigo

Sobre a verificação de domínio para o GitHub Pages

Quando você verifica um domínio personalizado de sua conta pessoal, somente repositórios pertencentes a sua conta pessoal podem ser usados para publicar um site GitHub Pages no domínio personalizado verificado ou nos subdomínios imediatos do domínio. De forma similar, quando você verifica um domínio personalizado de sua organização pessoal, apenas repositórios pertencentes a sua organização podem ser usados para publicar um site GitHub Pages no domínio personalizado verificado ou nos subdomínios imediatos do domínio.

Verificar seu domínio impede que outros usuários do GitHub de assumir seu domínio personalizado e usá-lo para publicar seu próprio site de GitHub Pages. As tomadas de domínio podem acontecer quando você excluir seu repositório, quando seu plano de cobrança é rebaixado, ou após qualquer outra alteração que desvincula o domínio personalizado ou quando você desabilita GitHub Pages enquanto o domínio permanece configurado para GitHub Pages e não é verificado.

Ao verificar um domínio, todos os subdomínios imediatos também são incluídos na verificação. Por exemplo, se o domínio personalizado github.com for verificado, o docs.github.com, o support.github.com e todos os outros subdomínios imediatos também serão protegidos contra tomadas de controle.

Aviso: é altamente recomendável não usar registros DNS curingas, como *.example.com. Esses registros colocam você em risco imediato de aquisições de domínio, mesmo se você verificar o domínio. Por exemplo, verificar example.com impedirá que outra pessoa use a.example.com, mas ela ainda poderá usar b.a.example.com (que é coberto pelo registro DNS curinga). Para obter mais informações, confira "Verificando seu domínio personalizado para o GitHub Pages".

Também é possível verificar um domínio para sua organização ou empresa, que exibe um selo "Verificado" na organização ou no perfil da empresa e, em GitHub Enterprise Cloud, permite que você restrinja notificações para endereços de e-mail usando o domínio verificado. Para saber mais, confira "Verificar ou aprovar um domínio para sua organização" e "Verificando ou aprovando um domínio para sua empresa".

Verificação de um domínio que já está ocupado

Você pode estar verificando um domínio seu, que está atualmente em uso por outro usuário ou organização, para disponibilizá-lo para seu site do GitHub Pages. Nesse caso, o domínio será imediatamente liberado dos sites do GitHub Pages que pertencem a outros usuários ou organizações. Se você estiver tentando verificar um domínio já verificado (verificado por outro usuário ou organização), o processo de liberação não será bem-sucedido.

Verificar um domínio para o seu site de usuário

  1. No canto superior direito de qualquer página do GitHub, clique sua foto de perfil e, em seguida, clique em Configurações.

  2. Na seção "Código, planejamento e automação" da barra lateral, clique em Páginas.

  3. À direita, clique em Adicionar um domínio.

  4. Em "Qual domínio você deseja adicionar?", insira o domínio que você deseja verificar e clique em Adicionar domínio.

    Captura de tela de uma caixa de texto para adicionar um domínio verificado no GitHub Pages, preenchida com "example.com". Abaixo do texto há um botão verde "Adicionar domínio".

  5. Siga as instruções descritas em "Adicionar um registro TXT DNS" para criar o registro TXT no serviço de hospedagem de domínio.

    Captura de tela das instruções do GitHub Pages para adicionar um registro TXT à configuração DNS de example.com.

  6. Aguarde que a configuração de DNS seja alterada. Isto pode ser imediato ou demorar até 24 horas. Confirme a alteração na configuração de DNS executando o comando dig na linha de comando. No comando abaixo, substitua USERNAME pelo nome de usuário e example.com pelo domínio que você está verificando. Se a sua configuração de DNS foi atualizada, você deverá ver o seu novo registro TXT na saída.

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

  7. Depois de confirmar que a configuração de DNS foi atualizada, verifique o domínio. Se a alteração não for imediata e você tiver saído da página anterior, volte às configurações do Pages seguindo as primeiras etapas e, à direita do domínio, clique em e clique em Continuar verificando.

    Captura de tela das configurações do GitHub Pages mostrando domínios verificados. Há uma opção suspensa "Continuar a verificação" abaixo do ícone de kebab horizontal à direita com um contorno em laranja escuro.

  8. Para verificar o domínio, clique em Verificar.

  9. Para garantir que o seu domínio personalizado permaneça verificado, mantenha o registro TXT na configuração DNS dele.

Verificando um domínio para o site da organização

Os proprietários da organização podem verificar domínios personalizados para a sua organização.

  1. No canto superior direito de GitHub, selecione sua foto de perfil e selecione Suas organizações.

  2. Ao lado da organização, clique em Configurações.

  3. Na seção "Código, planejamento e automação" da barra lateral, clique em Páginas.

  4. À direita, clique em Adicionar um domínio.

  5. Em "Qual domínio você deseja adicionar?", insira o domínio que você deseja verificar e clique em Adicionar domínio.

    Captura de tela de uma caixa de texto para adicionar um domínio verificado no GitHub Pages, preenchida com "example.com". Abaixo do texto há um botão verde "Adicionar domínio".

  6. Siga as instruções descritas em "Adicionar um registro TXT DNS" para criar o registro TXT no serviço de hospedagem de domínio.

    Captura de tela das instruções do GitHub Pages para adicionar um registro TXT à configuração DNS de example.com.

  7. Aguarde a alteração da configuração de DNS. Isso pode ser imediato ou levar até 24 horas. Confirme a alteração na configuração de DNS executando o comando dig na linha de comando. No comando abaixo, substitua ORGANIZATION pelo nome da sua organização e example.com pelo domínio que você está verificando. Se a sua configuração de DNS foi atualizada, você deverá ver o seu novo registro TXT na saída.

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

  8. Depois de confirmar que a configuração de DNS foi atualizada, verifique o domínio. Se a alteração não for imediata e você tiver saído da página anterior, volte às configurações do Pages seguindo as primeiras etapas e, à direita do domínio, clique em e clique em Continuar verificando.

    Captura de tela das configurações do GitHub Pages mostrando domínios verificados. Há uma opção suspensa "Continuar a verificação" abaixo do ícone de kebab horizontal à direita com um contorno em laranja escuro.

  9. Para verificar o domínio, clique em Verificar.

  10. Para garantir que o seu domínio personalizado permaneça verificado, mantenha o registro TXT na configuração DNS dele.