Skip to main content

Gerenciar suas chaves de acesso

Você pode ser solicitado a registrar uma chave de acesso durante a entrada ou optar por registrar uma nova chave de acesso nas configurações da conta. Para usuários de 2FA, você pode atualizar as chaves de segurança qualificadas existentes para chaves de acesso.

Quem pode usar esse recurso

Personal account owners who manage their own credentials can authenticate to GitHub.com using passkeys.

Sobre o gerenciamento de suas chaves de acesso

Se você estiver se conectando a GitHub.com de um dispositivo e navegador qualificados, GitHub poderá solicitar que você registre o dispositivo como uma chave de acesso durante a entrada. Você também pode adicionar chaves de acesso à sua conta de suas configurações de conta. Para obter mais informações, confira "Adicionar uma chave de acesso à sua conta".

Se você usar a autenticação de dois fatores (2FA), o GitHub poderá solicitar a atualização das chaves de segurança qualificadas existentes (como Mac TouchID ou Windows Hello) para chaves de acesso após a autenticação no GitHub.com. Você também pode atualizar as chaves de segurança qualificadas das configurações da sua conta. Para obter mais informações, confira "Atualizar uma chave de segurança existente para uma chave de acesso".

Para obter informações sobre como remover uma chave de acesso da conta, confira "Remover uma chave de acesso da sua conta".

Adicionar uma chave de acesso à sua conta

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

    Screenshot of a user's account menu on GitHub. The menu item "Settings" is outlined in dark orange.

  2. Na seção "Acesso" da barra lateral, clique em Senha e autenticação.

  3. Em "Chaves de acesso", clique em Adicionar uma chave de acesso.

  4. Se solicitado, autentique com sua senha ou use outro método de autenticação existente.

  5. Em "Configurar autenticação sem senha", examine o prompt e clique em Adicionar chave de acesso.

  6. No prompt, siga as etapas descritas pelo provedor de chave de acesso.

  7. Na próxima página, examine as informações confirmando que uma chave de acesso foi registrada com êxito e clique em Concluído.

Atualizar uma chave de segurança existente para uma chave de acesso

Observações:

  • O suporte da plataforma para atualização de chaves de segurança é inconsistente; portanto, se estiver observando falhas no seu sistema operacional ou navegador ao tentar registrar uma credencial existente, sugerimos remover e registrar novamente a chave de segurança.
  • Se você usou uma chave de segurança recentemente e ela for elegível para uma atualização, um botão Atualizar será mostrado ao lado da chave de segurança no menu de configurações. É possível usar o botão para acionar o fluxo de atualização. Você também pode tentar atualizar outras chaves registrando-as como uma chave de acesso, mesmo que o botão Atualizar não seja mostrado.

Antes de iniciar o procedimento de atualização, verifique se você está usando o dispositivo vinculado à chave de segurança existente. Quando você clicar em Adicionar uma chave de acesso nas configurações da sua conta, o GitHub o colocará automaticamente no fluxo "Atualizar para uma chave de acesso".

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

    Screenshot of a user's account menu on GitHub. The menu item "Settings" is outlined in dark orange.

  2. Na seção "Acesso" da barra lateral, clique em Senha e autenticação.

  3. Em "Chaves de acesso", clique em Adicionar uma chave de acesso.

  4. Se solicitado, autentique com sua senha ou use outro método de autenticação existente.

  5. Em "Configurar autenticação sem senha", em "Atualizar seu registro de chave de segurança para uma chave de acesso", examine as informações que confirmam o nome da chave de segurança a ser atualizada e clique em Atualizar para chave de acesso.

  6. No prompt, siga as etapas descritas pelo provedor de chave de acesso.

  7. Na próxima página, examine as informações confirmando que uma chave de acesso foi registrada com êxito e clique em Concluído.

Remover uma chave de acesso da sua conta

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

    Screenshot of a user's account menu on GitHub. The menu item "Settings" is outlined in dark orange.

  2. Na seção "Acesso" da barra lateral, clique em Senha e autenticação.

  3. À direita da chave de acesso que você deseja remover, clique em .

  4. Examine as informações na janela pop-up "Excluir confirmação" e clique em Excluir.

Recuperar uma chave de acesso

Muitas chaves de acesso dão suporte à sincronização, em que sua chave de acesso é apoiada pelo sistema de contas do provedor (iCloud, conta do Google, gerenciador de senhas etc.). Se você perder seu dispositivo, poderá recuperar suas chaves de acesso sincronizadas entrando no provedor de chave de acesso.

Em alguns casos, sua chave de acesso pode estar "vinculada ao dispositivo", o que significa que a chave de acesso não pode ser sincronizada e não há backup na nuvem. Por exemplo, você pode registrar chaves de segurança de hardware FIDO2 (como YubiKey) como uma chave de acesso, mas essa chave de acesso não será sincronizada. Se a chave de acesso estiver associada ao dispositivo e você perder ou apagar o dispositivo, a chave de acesso não poderá ser recuperada. Se você está usando apenas chaves de acesso vinculadas a dispositivos, é uma prática recomendada registrar chaves de acesso em pelo menos dois dispositivos diferentes, caso você perca o acesso a um deles.

Você pode ver quais das suas chaves de acesso estão sincronizadas e quais são associadas ao dispositivo, em "Chaves de acesso" nas configurações de segurança da sua conta. As chaves de acesso sincronizadas incluirão um rótulo azul Synced ao lado do nome.

Leitura adicional