Skip to main content

Authorizing an SSH key for use with single sign-on

To use an SSH key with an organization that uses single sign-on (SSO), you must first authorize the key.

About authorization of SSH keys

You can authorize an existing SSH key, or create a new SSH key and then authorize it. For more information about creating a new SSH key, see 새 SSH 키 생성 및 ssh-agent에 추가.

참고 항목

조직에 대한 연결된 ID가 있는 경우 SAML이 적용되지 않더라도 해당 조직에서 권한 있는 personal access token 및 SSH 키만 사용할 수 있습니다. 조직 또는 엔터프라이즈 소유자가 나중에 연결된 ID를 해지하지 않는 한 해당 조직에 대해 SAML SSO를 통해 인증한 적이 있는 경우 조직에 대한 연결된 ID가 있습니다. 연결된 ID를 해지하는 방법에 대한 자세한 내용은 조직에 대한 구성원의 SAML 액세스 보기 및 관리엔터프라이즈에 대한 사용자의 SAML 액세스 보기 및 관리을(를) 참조하세요.

personal access token 또는 SSH 키에 권한을 부여하려면 먼저 연결된 SAML ID가 있어야 합니다. SAML SSO를 사용하는 조직의 구성원인 경우 IdP를 사용하여 조직에 인증하여 연결된 ID를 한 번 이상 만들 수 있습니다. 자세한 내용은 About authentication with single sign-on을(를) 참조하세요.

personal access token 또는 SSH 키에 권한을 부여한 후에는 다음 방법 중 하나로 해지될 때까지 토큰 또는 키의 권한이 유지됩니다.

  • 조직 또는 엔터프라이즈 소유자가 권한 부여를 취소합니다.
  • 조직에서 제거됩니다.
  • personal access token의 범위가 편집되거나 토큰이 다시 생성됩니다.
  • personal access token이(가) 만드는 동안 정의된 대로 만료되었습니다.

참고 항목

If your SSH key authorization is revoked by an organization, you will not be able to reauthorize the same key. You will need to create a new SSH key and authorize it. For more information about creating a new SSH key, see 새 SSH 키 생성 및 ssh-agent에 추가.

You do not need to authorize SSH certificates signed by your organization's SSH certificate authority (CA).

Authorizing an SSH key

  1. GitHub의 페이지 오른쪽 상단에서 프로필 사진을 선택한 다음, 설정을 선택합니다.

  2. 사이드바의 "액세스" 섹션에서 SSH 및 GPG 키를 클릭합니다.

  3. To the right of the SSH key you'd like to authorize, click Configure SSO. SSO 구성이 표시되지 않으면 SAML IdP를 통해 한 번 이상 인증하여 GitHub의 리소스에 액세스했는지 확인합니다. 자세한 내용은 About authentication with single sign-on을(를) 참조하세요.

    Screenshot of the "Authentication Keys" section. Next to a key, a dropdown menu, labeled "Configure SSO," is outlined in orange.

  4. In the dropdown menu, to the right of the organization you'd like to authorize the SSH key for, click Authorize.

Further reading