10.2. Red Hat Quay の Red Hat Single Sign-On の設定

手順

1. Operator Installed Operators Red Hat Quay Quay Registry Config Bundle Secret に移動して、Red Hat Quay config.yaml ファイルを編集します。次に、Actions Edit Secret をクリックします。または、config.yaml ファイルをローカルに更新することもできます。

2. 以下の情報を OpenShift Container Platform config.yaml ファイルの Red Hat Quay に追加します。

   # ...
   RHSSO_LOGIN_CONFIG:
     CLIENT_ID: <client_id>
     CLIENT_SECRET: <client_secret>
     OIDC_SERVER: <oidc_server_url>
     SERVICE_NAME: <service_name>
     SERVICE_ICON: <service_icon>
     VERIFIED_EMAIL_CLAIM_NAME: <example_email_address>
     PREFERRED_USERNAME_CLAIM_NAME: <preferred_username>
     LOGIN_SCOPES: [ 'openid', 'roles' ]
     USE_PKCE: true
     PKCE_METHOD: "S256"
   # ...

   各項目の説明:

   RHSSO_LOGIN_CONFIG:: OIDC 設定を保持する親キーを指定します。この例では、親キーとして RHSSO_LOGIN_CONFIG が使用されており、文字列は特定のニーズに基づいて任意の文字列に置き換えることができます。たとえば、ABC123 などです。ただし、GOOGLE と GITHUB という文字列は受け付けられません。これらの文字列は、それぞれの ID プラットフォーム用に予約されており、使用するプラットフォームに応じて特定の config.yaml エントリーが必要です。

   CLIENT_ID:: アイデンティティープロバイダーに登録されるアプリケーションのクライアント ID を指定します。たとえば、quay などです。

   CLIENT_SECRET:: クライアントシークレットを指定します。

   OIDC_SERVER:: Red Hat Single Sign-On インスタンスの完全修飾ドメイン名 (FQDN) を指定します。末尾に /auth/realms/ とレルム名が付加されます。末尾にスラッシュを含める必要があります。例: https://sso-redhat.example.com//auth/realms/<your_realm_name>/。

   SERVICE_NAME:: Red Hat Quay ログインページに表示される名前を指定します。たとえば、Red Hat Single Sign On など です。

   SERVICE_ICON:: ログイン画面に表示されるアイコンを指定します。例: /static/img/RedHat.svg.

   VERIFIED_EMAIL_CLAIM_NAME:: ユーザーのメールアドレスを検証するために使用されるクレームの名前を指定します。

   PREFERRED_USERNAME_CLAIM_NAME:: ユーザーのメールアドレスを検証するために使用されるクレームの名前を指定します。

   LOGIN_SCOPES:: ログインフローを実行する際に OIDC プロバイダーに送信するスコープを指定します。たとえば、openid などです。

   USE_PKCE:: コード交換用証明キー (PKCE) を有効にするかどうかを指定します。デフォルトは False です。

   PKCE_METHOD:: 初回認可リクエストで送信される コードチャレンジ を生成するために使用されるコードチャレンジ方法を指定します。デフォルトは S256 です。

3. Red Hat Single Sign-On を有効にして、OpenShift Container Platform デプロイメントで Red Hat Quay を再起動します。