SAML と GitHub Apps

Organization または Enterprise が SSO で保護されている場合は、GitHub App を認可、インストール、または要求する前に、organization のアクティブな SSO セッションを開始する必要があります。

この記事の内容

ユーザーに対する GitHub Apps の認可

Organization または Enterprise が SSO を使っている場合、GitHub App を認可した後、organization のリソースまたは Enterprise の internal リソースが表示できないことがあります。 たとえば、アプリでリポジトリの一覧を表示する場合、Organization で所有しているリポジトリが表示されないことがあります。 この問題を解決するには、次の手順に従ってください。

  1. https://github.com/orgs/ORGANIZATION-NAME/sso に移動して、Organization のアクティブ SAML セッションを開始します。 ORGANIZATION-NAME を自身の組織の名前に置き換えます。
    • Enterprise が organization の SSO を管理している場合は、https://github.com/enterprises/ENTERPRISE-NAME/sso に移動して、Enterprise 用アクティブな SSO セッションを開始することもできます。 ENTERPRISE-NAME は、お使いの Enterprise 名に置き換えます。 これは、自分がメンバーになっている Enterprise 内のすべての organization の SSO セッションとして機能します。
    • アカウントが所有するリソースにアクセスしようとしたときにセッションがまだない場合は、SSO もトリガーされます。
  2. GitHub App の承認を取り消します。 詳しくは、「GitHub Apps の承認の確認と取り消し」をご覧ください。
  3. GitHub App を再承認します。 GitHub App の承認がアプリによって開始されます。これは、アプリによって異なります。 たとえば、一部の GitHub Apps では、リンクをクリックするか、ターミナルでコマンドを入力する必要があります。 詳しくは、「GitHub App の承認」をご覧ください。

アプリにサインインすると、SSO セッションがある organization ごとに資格情報の認可が作成されます。 SSO は organization レベルまたは Enterprise レベルで適用できます。 Enterprise レベルで適用されている場合、どの organization との SSO セッションでも、メンバーである各 organization の SSO セッションとしてカウントされます。 これは、アプリケーションの認可時にメンバーになっている各 organization のトークンに資格情��の認可として表示されます。

SSO 資格情報の認可は、アプリとの特定のサインイン セッションに関連付けられます。 別のデバイス上で、または SSO セッションの有効期限が切れた後にアプリに再度サインインする予定がある場合は、サインインする前に新しい SSO セッションを開始して、アプリから organization のリソースにアクセスできるようにする必要があります。

SSO を使う organization での GitHub Apps のインストールまたは要求

Organization または Enterprise で SSO を使っている場合、organization に GitHub App をインストールまたは要求しようとしたときに、organization が一覧に表示されないことがあります。 この問題を解決するには、次の手順に従ってください。

  1. https://github.com/orgs/ORGANIZATION-NAME/sso に移動して、Organization のアクティブ SAML セッションを開始します。 ORGANIZATION-NAME を自身の組織の名前に置き換えます。
    • Enterprise が organization の SSO を管理している場合は、https://github.com/enterprises/ENTERPRISE-NAME/sso に移動して、Enterprise 用アクティブな SSO セッションを開始することもできます。 ENTERPRISE-NAME は、お使いの Enterprise 名に置き換えます。 これは、自分がメンバーになっている Enterprise 内のすべての organization の SSO セッションとして機能します。
  2. GitHub App をもう一度インストールまたは要求してみてください。 詳細については、「サード パーティからの GitHub App のインストール」、「Organization の GitHub Marketplace から GitHub アプリをインストールする」、「Organization の所有者に GitHub App を要求する」を参照してください。