ホーム
製品
OpenShift Container Platform
4.2
認証
第4章アイデンティティープロバイダーの設定

第4章アイデンティティープロバイダーの設定

4.1. HTPasswd アイデンティティープロバイダーの設定

4.1.1. OpenShift Container Platform のアイデンティティープロバイダーについて

デフォルトでは、kubeadmin ユーザーのみがクラスターに存在します。アイデンティティープロバイダーを指定するには、アイデンティティープロバイダーを記述し、これをクラスターに追加するカスタムリソース (CR、Custom Resource) を作成する必要があります。

注記

/、:、および % を含む OpenShift Container Platform ユーザー名はサポートされません。

HTPasswd アイデンティティープロバイダーを定義するには、以下の手順を実行する必要があります。

ユーザーおよびパスワード情報を保存するために htpasswd ファイルを作成します。Linux および Windows用の手順が説明されます。
htpasswd ファイルを表すために OpenShift Container Platform シークレットを作成します。
HTPasswd アイデンティティープロバイダーリソースを定義します。
リソースをデフォルトの OAuth 設定に適用します。

4.1.2. Linux を使用した HTPasswd ファイルの作成

HTPasswd アイデンティティープロバイダーを使用するには、htpasswdを使用してクラスターのユーザー名およびパスワードを含むフラットファイルを生成する必要があります。

前提条件

htpasswd ユーティリティーへのアクセスがあること。Red Hat Enterprise Linux では、これは httpd-tools パッケージをインストールして利用できます。

手順

ユーザー名およびハッシュされたパスワードを含むフラットファイルを作成します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
```
htpasswd -c -B -b </path/to/users.htpasswd> <user_name> <password>
```
```
$ htpasswd -c -B -b </path/to/users.htpasswd> <user_name> <password>
```
コマンドにより、ハッシュされたバージョンのパスワードが生成されます。
例:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
```
htpasswd -c -B -b users.htpasswd user1 MyPassword!
```
```
$ htpasswd -c -B -b users.htpasswd user1 MyPassword!

Adding password for user user1
```
ファイルに対する認証情報の追加またはその更新を継続します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
```
htpasswd -B -b </path/to/users.htpasswd> <user_name> <password>
```
```
$ htpasswd -B -b </path/to/users.htpasswd> <user_name> <password>
```

4.1.3. Windows を使用した HTPasswd ファイルの作成

前提条件

htpasswd.exe へのアクセスがあること。このファイルは、数多くの Apache httpd ディストリビューションの \bin ディレクトリーに含まれます。

手順

ユーザー名およびハッシュされたパスワードを含むフラットファイルを作成します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
```
> htpasswd.exe -c -B -b <\path\to\users.htpasswd> <user_name> <password>
```
```
> htpasswd.exe -c -B -b <\path\to\users.htpasswd> <user_name> <password>
```
コマンドにより、ハッシュされたバージョンのパスワードが生成されます。
例:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
```
> htpasswd.exe -c -B -b users.htpasswd user1 MyPassword!

Adding password for user user1
```
```
> htpasswd.exe -c -B -b users.htpasswd user1 MyPassword!

Adding password for user user1
```
ファイルに対する認証情報の追加またはその更新を継続します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
```
> htpasswd.exe -b <\path\to\users.htpasswd> <user_name> <password>
```
```
> htpasswd.exe -b <\path\to\users.htpasswd> <user_name> <password>
```

4.1.4. HTPasswd シークレットの作成

HTPasswd アイデンティティープロバイダーを使用するには、HTPasswd ユーザーファイルが含まれるシークレットを定義する必要があります。

前提条件

HTPasswd ファイルを作成します。

手順

HTPasswd ユーザーファイルが含まれる OpenShift Container Platform シークレットを作成します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
```
oc create secret generic htpass-secret --from-file=htpasswd=</path/to/users.htpasswd> -n openshift-config
```
```
$ oc create secret generic htpass-secret --from-file=htpasswd=</path/to/users.htpasswd> -n openshift-config
```
注記
上記のコマンドが示すように、--from-file 引数についてのユーザーファイルを含むシークレットキーには htpasswd という名前を指定する必要があります。

4.1.5. HTPasswd CR のサンプル

以下のカスタムリソース (CR) は、HTPasswd アイデンティティープロバイダーのパラメーターおよび許可される値を示します。

HTPasswd CR

Copy to Clipboard Toggle word wrap

apiVersion: config.openshift.io/v1
kind: OAuth
metadata:
  name: cluster
spec:
  identityProviders:
  - name: my_htpasswd_provider 
    mappingMethod: claim 
    type: HTPasswd
    htpasswd:
      fileData:
        name: htpass-secret

apiVersion: config.openshift.io/v1
kind: OAuth
metadata:
  name: cluster
spec:
  identityProviders:
  - name: my_htpasswd_provider


    mappingMethod: claim


    type: HTPasswd
    htpasswd:
      fileData:
        name: htpass-secret

1: このプロバイダー名は、プロバイダーのユーザー名にプレフィックスとして付加され、アイデンティティー名が作成されます。
2: このプロバイダーのアイデンティティーとユーザーオブジェクト間にマッピングが確立される方法を制御します。
3: htpasswdを使用して生成されたファイルが含まれる既存のシークレットです。

4.1.6. アイデンティティープロバイダーのクラスターへの追加

クラスターのインストール後に、アイデンティティープロバイダーをそのクラスターに追加し、ユーザーの認証を実行できるようにします。

前提条件

OpenShift Container Platform クラスターを作成します。
アイデンティティープロバイダーのカスタムリソース (CR) を作成します。
管理者としてログインしている必要があります。

手順

定義された CR を適用します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
```
oc apply -f </path/to/CR>
```
```
$ oc apply -f </path/to/CR>
```
注記
CR が存在しない場合、oc apply は新規 CR を作成し、さらに以下の警告をトリガーする可能性があります。Warning: oc apply should be used on resources created by either oc create --save-config or oc applyこの場合は、この警告を無視しても問題ありません。
アイデンティティープロバイダーのユーザーとしてクラスターにログインし、プロンプトが出されたらパスワードを入力します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
```
oc login -u <username>
```
```
$ oc login -u <username>
```
ユーザーが正常にログインされていることを確認し、ユーザー名を表示します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
```
oc whoami
```
```
$ oc whoami
```

4.1.7. HTPasswd アイデンティティープロバイダーの更新

既存の HTPasswd アイデンティティープロバイダーにユーザーを追加したり、既存の HTPasswd アイデンティティープロバイダーからユーザーを削除したりできます。

前提条件

HTPasswd ユーザーファイルが含まれるシークレットを作成している。この手順では、htpass-secret という名前であることを前提としています。
HTPasswd アイデンティティープロバイダーを設定している。この手順では、my_htpasswd_provider という名前であることを前提としています。
htpasswd ユーティリティーへのアクセスがある。Red Hat Enterprise Linux では、これは httpd-tools パッケージをインストールして利用できます。
クラスター管理者の権限がある。

手順

HTPasswd ファイルを htpass-secret シークレットから取得し、ファイルをお使いのファイルシステムに保存します。

Copy to Clipboard Toggle word wrap

oc get secret htpass-secret -ojsonpath={.data.htpasswd} -n openshift-config | base64 -d > users.htpasswd

$ oc get secret htpass-secret -ojsonpath={.data.htpasswd} -n openshift-config | base64 -d > users.htpasswd

users.htpasswd ファイルからユーザーを追加したり、削除したりします。
- 新規ユーザーを追加するには、以下を実行します。
  Copy to Clipboard Copied! Toggle word wrap Toggle overflow
```
htpasswd -bB users.htpasswd <username> <password>
```
```
$ htpasswd -bB users.htpasswd <username> <password>
Adding password for user <username>
```
- 既存ユーザーを削除するには、以下を実行します。
  Copy to Clipboard Copied! Toggle word wrap Toggle overflow
```
htpasswd -D users.htpasswd <username>
```
```
$ htpasswd -D users.htpasswd <username>
Deleting password for user <username>
```

htpass-secret シークレットを、users.htpasswd ファイルの更新されたユーザーに置き換えます。

Copy to Clipboard Toggle word wrap

oc create secret generic htpass-secret --from-file=htpasswd=users.htpasswd --dry-run -o yaml -n openshift-config | oc replace -f -

$ oc create secret generic htpass-secret --from-file=htpasswd=users.htpasswd --dry-run -o yaml -n openshift-config | oc replace -f -

複数のユーザーを削除した場合は、追加でユーザーごとに既存のリソースを削除する必要があります。
1. ユーザーを削除します。
  Copy to Clipboard Copied! Toggle word wrap Toggle overflow
```
oc delete user <username>
```
```
$ oc delete user <username>
user.user.openshift.io "<username>" deleted
```
  ユーザーを必ず削除してください。削除しない場合、ユーザーは期限切れでない限り、トークンを引き続き使用できます。
2. ユーザーのアイデンティティーを削除します。
  Copy to Clipboard Copied! Toggle word wrap Toggle overflow
```
oc delete identity my_htpasswd_provider:<username>
```
```
$ oc delete identity my_htpasswd_provider:<username>
identity.user.openshift.io "my_htpasswd_provider:<username>" deleted
```

4.1.8. Web コンソールを使用したアイデンティティープロバイダーの設定

CLI ではなく Web コンソールを使用してアイデンティティープロバイダー (IDP) を設定します。

前提条件

クラスター管理者として Web コンソールにログインしている必要があります。

手順

Administration Cluster Settings に移動します。
Global Configuration タブで、OAuth をクリックします。
Identity Providers セクションで、Add ドロップダウンメニューからアイデンティティープロバイダーを選択します。

注記

既存の IDP を上書きすることなく、Web コンソールで複数の IDP を指定することができます。

トップに戻る

第4章アイデンティティープロバイダーの設定

4.1. HTPasswd アイデンティティープロバイダーの設定

4.1.1. OpenShift Container Platform のアイデンティティープロバイダーについて

4.1.2. Linux を使用した HTPasswd ファイルの作成

4.1.3. Windows を使用した HTPasswd ファイルの作成

4.1.4. HTPasswd シークレットの作成

4.1.5. HTPasswd CR のサンプル

4.1.6. アイデンティティープロバイダーのクラスターへの追加

4.1.7. HTPasswd アイデンティティープロバイダーの更新

4.1.8. Web コンソールを使用したアイデンティティープロバイダーの設定

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

第4章 アイデンティティープロバイダーの設定

4.1. HTPasswd アイデンティティープロバイダーの設定

4.1.1. OpenShift Container Platform のアイデンティティープロバイダーについて

4.1.2. Linux を使用した HTPasswd ファイルの作成

4.1.3. Windows を使用した HTPasswd ファイルの作成

4.1.4. HTPasswd シークレットの作成

4.1.5. HTPasswd CR のサンプル

4.1.6. アイデンティティープロバイダーのクラスターへの追加

4.1.7. HTPasswd アイデンティティープロバイダーの更新

4.1.8. Web コンソールを使用したアイデンティティープロバイダーの設定

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

第4章アイデンティティープロバイダーの設定