2.2. セルフサービス自動化ポータル用のカスタム SSL 証明書の設定
Ansible Automation Platform インスタンスでカスタムまたは自己署名 SSL 証明書を使用している場合は、セルフサービス自動化ポータルがそれらの証明書を信頼するように設定する必要があります。この設定がないと、セルフサービス自動化ポータルと Ansible Automation Platform 間の認証が SSL 検証エラーで失敗します。
前提条件
- あなたは OpenShift Container Platform クラスターへの管理者権限を持っています。
- Ansible Automation Platform インスタンスで使用されるカスタム認証局 (CA) 証明書ファイルをお持ちです。
- セルフサービス自動化ポータルは、OpenShift Container Platform クラスターにインストールされています。
手順
Ansible Automation Platform インスタンスから CA 証明書ファイルを取得してください。
CA 証明書ファイルがない場合は、Ansible Automation Platform サーバーから抽出できます。
openssl s_client -showcerts -connect <aap-hostname>:443 </dev/null 2>/dev/null | openssl x509 -outform PEM > aap-ca-cert.pem<aap-hostname> を、ご使用の Ansible Automation Platform のホスト名に置き換えてください。- 管理者特権で OpenShift Container Platform クラスターにログインしてください。
カスタム CA 証明書を含む ConfigMap を作成します。
oc create configmap custom-ca-bundle \ --from-file=ca-bundle.crt=aap-ca-cert.pem \ -n <namespace><namespace> を、セルフサービス自動化ポータルがインストールされている名前空間に置き換えてください。セルフサービス自動化ポータルの Helm チャートの値を更新して、カスタム CA 証明書をマウントします。
upstream: backstage: extraEnvVarsSecrets: - custom-ca-bundle extraVolumes: - name: custom-ca configMap: name: custom-ca-bundle extraVolumeMounts: - name: custom-ca mountPath: /etc/pki/ca-trust/source/anchors/ readOnly: trueセルフサービス自動化ポータルの Helm チャートをアップグレードして、更新された設定を適用します。
helm upgrade <release-name> <chart-name> \ -f values.yaml \ -n <namespace><release-name>を Helm のリリース名に、<chart-name> をセルフサービス自動化ポータルのチャート名に置き換えてください。- セルフサービス自動化ポータル Pod が新しい設定で再起動するまでお待ちください。
検証
セルフサービス自動化ポータル Pod が実行されていることを確認してください。
oc get pods -n <namespace>すべてのセルフサービス自動化ポータル Pod は、
実行中のステータスを表示する必要があります。Ansible Automation Platform の認証情報を使用して、セルフサービス自動化ポータルにサインインしてみてください。
SSL 証明書の設定が正しければ、SSL 検証エラーなしで正常に認証できます。
SSL 関連のエラーがないか、セルフサービス自動化ポータルのログを確認してください。
oc logs -n <namespace> <pod-name> | grep -i sslSSL 検証エラーが表示されない場合、カスタム CA 証明書は正しく信頼されています。
トラブルシューティング
この手順を実行しても SSL 検証エラーが続く場合は、以下の手順に従ってください。
- CA 証明書ファイルに完全な証明書チェーンが含まれていることを確認してください。
- 証明書ファイルが PEM 形式であることを確認してください。
- 設定ファイル内の Ansible Automation Platform のホスト名が、SSL 証明書のホスト名と一致していることを確認してください。
-
Helm の設定値にある
checkSSLパラメーターがtrue(デフォルト値) に設定されていることを確認してください。これをfalseに設定すると、SSL 検証が完全に無効になります。これは、実稼働環境では推奨されません。