Autorizar o uso de uma chave SSH para uso com logon único SAML

Para usar uma chave SSH com uma organização que usa logon único SAML (SSO), primeiramente, você deve autorizar a chave.

Neste artigo

Sobre a autorização de chaves SSH

Você pode autorizar uma chave SSH existente ou criar uma e autorizá-la. Para saber mais sobre como criar uma chave SSH, confira Gerando uma nova chave SSH e adicionando-a ao agente SSH.

Note

Se você tiver uma identidade vinculada para uma organização, só poderá usar personal access token e chaves SSH autorizadas com essa organização, mesmo que o SAML não seja aplicado. Você terá uma identidade vinculada para uma organização se já tiver se autenticado por meio do SSO do SAML para essa organização, a menos que um proprietário da organização ou da empresa tenha revogado a identidade vinculada posteriormente. Para obter mais informações sobre como revogar identidades vinculadas, confira "Exibir e gerenciar o acesso SAML de um membro à organização" e "Visualizar e gerenciar o acesso SAML de um usuário à sua empresa".

Antes de autorizar um personal access token ou uma chave SSH, é necessário ter uma identidade SAML vinculada. Se você for membro de uma organização em que o SSO do SAML está habilitado, você pode criar uma identidade vinculada autenticando-se na sua organização com o IdP pelo menos uma vez. Para obter mais informações, confira "Sobre a autenticação com logon único de SAML".

Depois de autorizar um personal access token ou uma chave SSH, o token ou a chave permanecerá autorizado até ser revogado de uma das maneiras a seguir.

  • Um proprietário da empresa ou da organização revoga a autorização.
  • Você é removido da organização.
  • Os escopos em um personal access token são editados ou o token é gerado novamente.
  • O personal access token expirou, conforme definido durante a criação.

Note

Se a autorização de chave SSH for revogada por uma organização, você não poderá autorizar a mesma chave novamente. Será preciso criar outra chave SSH e autorizá-la. Para saber mais sobre como criar uma chave SSH, confira Gerando uma nova chave SSH e adicionando-a ao agente SSH.

Você não precisa autorizar certificados SSH assinados pela AC (autoridade de certificação) SSH da sua organização.

Como autorizar uma chave SSH

  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 "Acesso" da barra lateral, clique em Chaves SSH e GPG.

  3. À direita da chave SSH que você deseja autorizar, clique em Configurar SSO. Se a opção Configurar SSO não for exibida, verifique se você se autenticou, pelo menos, uma vez por meio do IdP do SAML para acessar os recursos no GitHub. Para obter mais informações, confira "Sobre a autenticação com logon único de SAML".

    Captura de tela da seção "Chaves de autenticação". Ao lado de uma chave, um menu suspenso, rotulado "Configurar SSO", está realçado em laranja.

  4. No menu suspenso, à direita da organização para a qual deseja autorizar a chave SSH, clique em Autorizar.

Leitura adicional