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 に追加する.

メモ

Organization にリンクされた ID がある場合、SAML が強制されていない場合でも、その organization で使えるのは認可された personal access token と SSH キーのみです。 リンクされている ID をある組織または企業の所有者が後で取り消さない限り、ある Organization の SAML SSO を認証している場合、その Organization にリンクされている ID が与えられます。 リンクされた ID の取り消しの詳細については、「組織に対するメンバーの SAML アクセスの表示と管理」と「Enterprise へのユーザの SAML アクセスの表示および管理」を参照してください。

personal access token または SSH キーを承認する前に、リンクされた SAML ID が必要です。 SAML SSO が有効になっている組織のメンバーである場合は、IdP を使用して組織に少なくとも 1 回認証することで、リンクされた 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 を介して少なくとも 1 回、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