適用対象: ✔️ ホストされたコントロール プレーンのアーキテクチャ
組み込みの OpenShift OAuth サーバーではなく、外部 OpenID Connect (OIDC) ID プロバイダーを認証に使用するように、ホストされたコントロール プレーンを使用してAzure Red Hat OpenShiftを設定します。 組み込みの OAuth サーバーはさまざまな ID プロバイダーをサポートしていますが、機能は限られています。 外部 OIDC ID プロバイダーをホストされたコントロール プレーンとAzure Red Hat OpenShiftに直接統合することで、CLI アクセスなどのマシン間ワークフローを有効にし、組み込みの OAuth サーバーで使用できない機能を取得できます。
この記事では、CLI と OpenShift コンソールの両方にアクセスできるように、Microsoft Entra IDを外部認証プロバイダーとして構成する方法について説明します。
Prerequisites
- Azure CLI バージョン 2.67.0 以降。
az --versionを使用して、インストールされているバージョンを見つけます。 インストールまたはアップグレードが必要な場合は、Azure CLI のインストールを参照してください。 - 一時的な管理者資格情報がインストールされていることを確認します。
- OpenShift Web コンソールにアクセスするには、クラスターに少なくとも 1 つのノード プールが必要です。 詳細については、「ノード プールの作成」を参照してください。
- お客様の Microsoft Entra ID テナント内でアプリケーションを登録する権限。 既定では、すべてのユーザーがアプリケーションを登録できます。 この設定が [いいえ] に変更されている場合は、 アプリケーション開発者 ロールまたは アプリケーション管理者ロールが 必要です。
- Azure CLI バージョン 2.93.0 以降。
az --versionを使用して、インストールされているバージョンを見つけます。 インストールまたはアップグレードが必要な場合は、Azure CLI のインストールを参照してください。
環境変数を準備する
次の環境変数が定義されていることを確認します。
CUSTOMER_RG_NAME="<resource-group-name>"
CLUSTER_NAME="<cluster-name>"
EXTERNAL_AUTH_DISPLAY_NAME="${CLUSTER_NAME}-auth"
EXTERNAL_AUTH_NAME="entra"
TENANT_ID=$(az account show --query tenantId --output tsv)
ISSUER_URL="https://login.microsoftonline.com/${TENANT_ID}/v2.0"
SUBSCRIPTION_ID=$(az account show --query id --output tsv)
CUSTOMER_RG_NAME="<resource-group-name>"
CLUSTER_NAME="<cluster-name>"
EXTERNAL_AUTH_DISPLAY_NAME="${CLUSTER_NAME}-auth"
EXTERNAL_AUTH_NAME="entra"
TENANT_ID=$(az account show --query tenantId --output tsv)
ISSUER_URL="https://login.microsoftonline.com/${TENANT_ID}/v2.0"
Microsoft Entra ID を構成する
OpenShift 認証コールバック URL を取得します。
CONSOLE_URL=$(az aro hcp cluster show \ --resource-group "${CUSTOMER_RG_NAME}" \ --name "${CLUSTER_NAME}" \ --query properties.console.url --output tsv) CONSOLE_CALLBACK_URL="${CONSOLE_URL}/auth/callback"新しいアプリケーションを Microsoft Entra ID に登録する。
ocまたはkubectlCLI を介して API サーバーにアクセスするには、2 つ目のリダイレクト URI を追加します。次の例では、必要な OpenShift 認証コールバック URL と CLI アクセス用の 2 番目のリダイレクトという 2 つのリダイレクト URI を使用して、Microsoft Entra ID アプリケーションを作成します。
CLIENT_ID=$(az ad app create \ --display-name "${EXTERNAL_AUTH_DISPLAY_NAME}" \ --web-redirect-uris ${CONSOLE_CALLBACK_URL} http://localhost:8000 \ --query appId --output tsv)アプリケーションのクライアント シークレットを作成します。 コンソール メッセージは、コマンド出力に資格情報が含まれていることを通知します。 この記事の後半でクライアント シークレットを使用します。
Note
この記事のすべての手順を完了したら、変数をクリアします。 機密性の高い変数のクリーンアップを参照してください。
CLIENT_SECRET=$(az ad app credential reset --id ${CLIENT_ID} --query password --output tsv)
外部認証プロバイダーを作成する
Important
OpenShift Web コンソールへのアクセスを構成するには、外部認証プロバイダーを作成する前に、クラスターに少なくとも 1 つのノード プールが必要です。 詳細については、「ノード プールの作成」を参照してください。
次のクレーム マッピングは、Microsoft Entra ID が出力するように設定した preferred_username と groups のクレームを OpenShift がどのように読み取るかを示しています。
ホストされたコントロール プレーンを使用してAzure Red Hat OpenShift用の外部認証プロバイダーを作成します。
az aro hcp cluster external-auth create \ --resource-group "${CUSTOMER_RG_NAME}" \ --cluster-name "${CLUSTER_NAME}" \ --name "${EXTERNAL_AUTH_NAME}" \ --issuer-url "${ISSUER_URL}" \ --issuer-audience "[${CLIENT_ID}]" \ --claim groups \ --username-claim preferred_username \ --username-prefix-policy NoPrefix \ --client client-id="${CLIENT_ID}" component-name=console auth-client-namespace=openshift-console extra-scopes="[profile]" type=Confidential \ --client client-id="${CLIENT_ID}" component-name=cli auth-client-namespace=openshift-console extra-scopes="[profile]" type=Public外部認証プロバイダーの構成を確認します。
az aro hcp cluster external-auth show \ --resource-group "${CUSTOMER_RG_NAME}" \ --cluster-name "${CLUSTER_NAME}" \ --name "${EXTERNAL_AUTH_NAME}"
ホストされたコントロール プレーンを使用してAzure Red Hat OpenShift用に外部認証プロバイダーを構成します。 外部認証プロバイダーを構成するには、
externalAuthsリソースを定義します。 次の例は、Bicep ファイル内のexternalAuthsリソースを示しています。 外部認証プロバイダーのプロパティの詳細については、「外部認証の構成プロパティ」を参照してください。次の例を
externalauth.bicepとして保存します。@description('The name of the external auth provider configuration') param externalAuthName string @description('The issuer url') param issuerURL string @description('The client ID') param clientID string @description('Name of the hypershift cluster') param clusterName string resource hcp 'Microsoft.RedHatOpenShift/hcpOpenShiftClusters@2026-10-01' existing = { name: clusterName } resource externalauth 'Microsoft.RedHatOpenShift/hcpOpenShiftClusters/externalAuths@2026-10-01' = { parent: hcp name: externalAuthName properties: { claim: { mappings: { username: { claim: 'preferred_username' prefixPolicy: 'NoPrefix' } groups: { claim: 'groups' } } } clients: [ { clientId: clientID component: { name: 'console' authClientNamespace: 'openshift-console' } extraScopes: [ 'profile' ] type: 'Confidential' } { clientId: clientID component: { name: 'cli' authClientNamespace: 'openshift-console' } extraScopes: [ 'profile' ] type: 'Public' } ] issuer: { url: issuerURL audiences: [ clientID ] } } }Bicep ファイルを適用します。
az deployment group create \ --name 'aro-hcp-auth' \ --subscription "${SUBSCRIPTION_ID}" \ --resource-group "${CUSTOMER_RG_NAME}" \ --template-file externalauth.bicep \ --parameters \ externalAuthName="${EXTERNAL_AUTH_NAME}" \ issuerURL="${ISSUER_URL}" \ clientID="${CLIENT_ID}" \ clusterName="${CLUSTER_NAME}"外部認証プロバイダーの構成を確認します。
az aro hcp cluster external-auth show \ --resource-group "${CUSTOMER_RG_NAME}" \ --cluster-name "${CLUSTER_NAME}" \ --name "${EXTERNAL_AUTH_NAME}"
OpenShift で認証と承認を構成する
外部認証プロバイダーを作成した後、ホストされたコントロール プレーン クラスターを使用してAzure Red Hat OpenShiftにサインインして、機密クライアント (OpenShift コンソール) のアクセスを構成し、ロールベースのアクセス制御 (RBAC) を設定します。
ホストされたコントロール プレーン クラスターを使用するAzure Red Hat OpenShiftの一時的な管理資格情報がない場合は、その資格情報を生成します。 詳細については、「ホストされたコントロール プレーン クラスターを使用してAzure Red Hat OpenShiftに接続する」を参照してください。
OpenShift でクライアント シークレットを作成します。
oc create secret generic ${EXTERNAL_AUTH_NAME}-console-openshift-console \ --namespace openshift-config \ --from-literal=clientSecret=${CLIENT_SECRET}(省略可能)必要に応じて、ホストされたコントロール プレーン クラスターを使用してユーザーとグループをAzure Red Hat OpenShiftに割り当てます。
既定では、Microsoft Entra テナント内のすべてのユーザーは、正常に認証された後、登録済みのアプリケーションにアクセスできます。 Microsoft Entra IDを使用すると、テナント管理者と開発者は、テナント内の特定のユーザーまたはセキュリティ グループのセットにアプリを制限できます。
Microsoft Entra アプリを特定のユーザー セットに制限するには、「Microsoft Entra アプリを一連のユーザーに制限する」を参照してください。
ユーザーまたはグループにクラスター管理者ロールへのアクセス権を付与するように RBAC を構成します。
既定では、OpenShift では、ユーザーが最初にサインインしたときにクラスター内でアクションを実行するアクセス許可は付与されません。 ホストされたコントロール プレーンを使用するAzure Red Hat OpenShiftには、クラスターに対するフル アクセスと制御を許可するクラスター管理者ロールなど、多数の構成済みロールが含まれています。 クラスターでは、認証されたユーザーの
RoleBindingオブジェクトとClusterRoleBindingオブジェクトは自動的に作成されません。これらのバインドは自分で作成する必要があります。この例では、クラスター管理者ロールを特定のMicrosoft Entra IDユーザーまたはグループに付与する
ClusterRoleBindingオブジェクトを作成する方法を示します。 RBAC の使用に関するページの手順に従って、セキュリティ グループのロール バインドを作成することもできます。アクセス権を付与するユーザーのMicrosoft Entra IDユーザー プリンシパル名を取得します。
USER_NAME=$(az ad user show --id "<user-email>" --query userPrincipalName -o tsv)ユーザーにクラスター管理者ロールを付与する
ClusterRoleBindingオブジェクトを作成します。oc apply -f - <<EOF apiVersion: rbac.authorization.k8s.io/v1 kind: ClusterRoleBinding metadata: name: aro-admin roleRef: apiGroup: rbac.authorization.k8s.io kind: ClusterRole name: cluster-admin subjects: - apiGroup: rbac.authorization.k8s.io kind: User name: $USER_NAME EOF
外部認証構成を検証する
クラスターの外部認証を設定したら、OpenShift CLI と Web コンソールの構成を検証できます。
OpenShift Web コンソールを使用してアクセスを確認する
OpenShift Web コンソールの URL を取得します。
az aro hcp cluster show \ --resource-group "${CUSTOMER_RG_NAME}" \ --name "${CLUSTER_NAME}" \ --query properties.console.url --output tsvWeb ブラウザーで URL を開き、サインインします。
OpenShift CLI を使用してアクセスを検証する
Microsoft Entra IDを使用して、OpenShift コマンド ライン ツールにサインインできます。 この認証方法は、kubelogin client-go 資格情報プラグインがツールに直接組み込まれているために機能します。
API URL を取得します。
API_URL=$(az aro hcp cluster show \ --resource-group "${CUSTOMER_RG_NAME}" \ --name "${CLUSTER_NAME}" \ --query properties.api.url --output tsv)次のコマンドを実行して、クラスターにサインインします。
oc login $API_URL \ --exec-plugin=oc-oidc \ --client-id=$CLIENT_ID \ --client-secret=$CLIENT_SECRET \ --issuer-url=$ISSUER_URL \ --extra-scopes=profile \ --callback-port=8000このコマンドは URL を表示します。 URL を使用して、ブラウザーで認証プロセスを完了します。 完了すると、OpenShift CLI が認証されます。
資格情報が正しく設定されていることを確認します。
oc auth whoami出力例:
ATTRIBUTE VALUE Username user@email.com Groups [<group-id> system:authenticated]
機密性の高い変数をクリーンアップする
外部認証が機能していることを確認したら、シェル セッションから機密性の高い変数をクリアします。
CLIENT_SECRET=""