第2章 Red Hat Single Sign-On (RHSSO) による認証

手順

1. Developer Hub が RHSSO で認証できるようにするには、RHSSO の手順を完了し、レルムとユーザーを作成 し、Developer Hub アプリケーションを登録 します。

   1. 既存のレルムを使用するか、<my_realm> などの固有の 名前 を持つ レルムを作成 します。次のステップのために値を保存します。

      • RHSSO レルムのベース URL (例: <your_rhsso_URL>/auth/realms/<your_realm>)。

   2. RHSSO に Developer Hub を登録するには、作成されたレルムで、次の内容を使用して クライアント ID を作成 します。

      1. クライアント ID: <RHDH> などの固有のクライアント ID。
      2. 有効なリダイレクト URI: OIDC ハンドラー URL https://<RHDH_URL>/api/auth/oidc/handler/frame に設定します。
      3. Credentials タブに移動し、Client secret をコピーします。

      4. 次のステップのために値を保存します。

         • Client ID
         • Client Secret
   3. 検証手順を準備するには、同じレルムで、既存のユーザーの認証情報を取得するか、ユーザーを作成 します。検証手順用にユーザー認証情報を保存します。

2. RHSSO 認証情報を Developer Hub シークレットに追加するには、secrets-rhdh などの Developer Hub シークレットを編集し、次のキー/値のペアを追加します。

   AUTH_OIDC_CLIENT_ID

   保存した クライアント ID を入力します。

   AUTH_OIDC_CLIENT_SECRET

   保存した クライアントシークレット を入力します。

   AUTH_OIDC_METADATA_URL

   保存した RHSSO レルムのベース URL を入力します。

3. Developer Hub のカスタム設定で RHSSO 認証プロバイダーをセットアップするには、app-config-rhdh などのカスタム Developer Hub ConfigMap を編集し、app-config-rhdh.yaml コンテンツに次の行を追加します。

   RHSSO による認証を有効にするための必須フィールドを含む app-config-rhdh.yaml フラグメント

   auth:
     environment: production
     providers:
       oidc:
         production:
           metadataUrl: ${AUTH_OIDC_METADATA_URL}
           clientId: ${AUTH_OIDC_CLIENT_ID}
           clientSecret: ${AUTH_OIDC_CLIENT_SECRET}
   signInPage: oidc

   Copy to Clipboard Toggle word wrap

   environment: production

   環境を production としてマークすると、Developer Hub のホームページでゲストログインが非表示になります。

   metadataUrl、clientId、clientSecret

   シークレットを使用して OIDC プロバイダーを設定します。

   sigInPage: oidc

   OIDC プロバイダーをデフォルトのサインインプロバイダーとして有効にします。

   オプション: 次のオプションフィールドを追加することを検討してください。

   dangerouslyAllowSignInWithoutUserInCatalog: true

   Developer Hub ソフトウェアカタログでユーザーをプロビジョニングする必要なく認証を有効にします。

   警告

   このオプションは Developer Hub の機能を調べるために使用しますが、実稼働環境では使用しないでください。

   ソフトウェアカタログに存在しないユーザーを認証できるようにするオプションフィールドを含む app-config-rhdh.yaml フラグメント

   auth:
     environment: production
     providers:
       oidc:
         production:
           metadataUrl: ${AUTH_OIDC_METADATA_URL}
           clientId: ${AUTH_OIDC_CLIENT_ID}
           clientSecret: ${AUTH_OIDC_CLIENT_SECRET}
   signInPage: oidc
   dangerouslyAllowSignInWithoutUserInCatalog: true

   Copy to Clipboard Toggle word wrap

1. ナビゲーションメニューの Configure セクションで、Realm Settings をクリックします。
2. Realm Settings ページで、Tokens タブをクリックします。
3. Tokens タブの Refresh tokens セクションで、Revoke Refresh Token を Enabled に切り替えます。

検証

1. Developer Hub のログインページに移動します。
2. Developer Hub のサインインページには OIDC を使用してサインイン と表示され、ゲストユーザーのサインインは無効になっています。
3. 保存した ユーザー名 と パスワード の値を使用して、OIDC でログインします。