コンテンツにスキップ
PynPyn

OpenID Connectプロバイダーを接続する

あなたのIDプロバイダーはOpenID Connectに対応していて、そのプロバイダーで従業員をPynにサインインさせ、ロールも決めさせたい、という状況です。Single Sign-On連携はプロバイダー、そのissuer、認可コードフローのクライアントを受け取り、プロバイダーのOpenID設定を確認して、必要なリダイレクトURIとサインインリンクを表示します。

  • あなたがPynの管理者またはオーナーで、ワークスペースでSingle Sign-On連携が有効であること。
  • プロバイダーで機密クライアントを作成できる人がいること(「The client needs the standard authorization code flow and a client secret.」)。Pynはopenid、profile、emailのスコープを要求します。ロールのマッピングにはIDトークンにgroupsクレームが必要で(Entraはrolesを発行します)、そのクレームを取得するためのスコープがあればAdditional Scopesに入れます。
  • issuer、クライアントID、クライアントシークレットがあること。KeycloakではKeycloak Server URLとRealmが必要で、Pynはそれらからissuerを組み立てます。
The Connect single sign-on dialog with the Provider select and credential fields.
Connect single sign-on: choose the Provider, then enter the issuer, client ID, client secret and groups claim.
  1. Pynで左のナビゲーションのSettingsを開き、Integrationsの下のAvailableを開きます。

  2. Single Sign-Onのタイルを選びます。Connect single sign-onダイアログが開きます。

  3. ProviderをKeycloak、Okta、Microsoft Entra ID、Auth0、Ping Identityから選びます。それ以外のプロバイダーではSingle Sign-Onを選びます。

  4. KeycloakではKeycloak Server URLとRealmを、それ以外ではIssuer URLを入力します。

  5. Client IDとClient Secretを入力します。プロバイダーがgroups以外の名前を使うならGroups Claimを、openid profile email以外のスコープが必要ならAdditional Scopesを設定します。

  6. ダイアログに「Add this as a valid redirect URI on the client in your provider, then come back and connect.」という説明付きで表示されたRedirect URIをコピーします。

  7. Connectを選びます。ダイアログには「Checking those details with your provider…」と表示され、続いて「Single sign-on is configured. Use the sign-in link on the integration to let your people sign in with it.」という通知が出ます。

  8. パネルのGroup mappingsで、Owner groups、Admin groups、Power user groups、User groupsにカンマ区切りのグループ名を、オーナーから順に入力します。

タイルはInstalledでActiveを表示し、パネルにはRedirect URIとSign-in linkが表示されます。Sign-in linkの説明は「Share this with your people to sign in through your provider. Opening it signs you in.」です。ダイアログが接続を拒否した場合は、表示された理由を確認します。「That address answered, but not with an OpenID configuration.」は、issuerがプロバイダーの設定が公開されているベースURLではないことを意味します。「Could not reach that issuer.」はインターネットから到達できないことを、「The issuer needs to be a full URL, starting with https://.」は形式の問題を意味します。「An unexpected error occurred. Please check the details and try again. If the error persists, contact support.」はリクエストが届かなかったことを意味するので、もう一度試します。メニュー(…)のReconnectでダイアログを再び開き、どの項目でも変更できます。