Skip to main content

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.

Você pode autorizar uma chave SSH existente ou criar uma e autorizá-la. Para obter mais informações sobre como criar uma chave SSH, confira "Como gerar uma nova chave SSH e adicioná-la ao ssh-agent".

Observação: se você tiver uma identidade vinculada para uma organização, só será possível usar personal access token e chaves SSH autorizados 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 "Como ver e gerenciar o acesso do SAML de um membro à sua organização" e "Como ver e gerenciar o acesso do 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 o logon único do 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.

Observação: 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 obter mais informações sobre como criar uma chave SSH, confira "Como gerar uma nova chave SSH e adicioná-la ao ssh-agent".

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

    Ícone Settings (Configurações) na barra de usuário

  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 do GitHub.com. Para obter mais informações, confira "Sobre a autenticação com o logon único do SAML".

    Captura de tela do botão autorizar token de SSO

  4. À direita da organização para a qual deseja autorizar a chave SSH, clique em Autorizar.

    Captura de tela do botão autorizar token

Leitura adicional