10.8.6. フェデレーション設定フィールド参照

このリファレンスでは、SpireServer カスタムリソースにおける SPIRE フェデレーションで使用可能なすべての設定フィールドに関する詳細情報を提供します。フェデレーションの設定をカスタマイズする際は、このリファレンスを参照してください。

Expand

フィールド	型	必須	デフォルト	説明
`フェデレーション.バンドルエンドポイント`	object	はい	該当なし	このクラスターのフェデレーションエンドポイントの設定。これにより、トラストバンドルがリモートクラスターに公開されます。
`連邦。連邦化`	array	いいえ	`[]`	連携するリモートの信頼ドメインのリスト。
`フェデレーション管理ルート`	string	いいえ	`" 真実 "`	OpenShift ルートの自動作成を有効または無効にします。オペレーター管理ルートの場合は `true`、手動ルート管理の場合は `false` に設定してください。

Expand

フィールド	型	必須	デフォルト	説明
`フェデレーション.バンドルエンドポイント.プロファイル`	文字列 (列挙型)	はい	`https_spiffe`	バンドルエンドポイントの認証プロファイル。有効な値: `https_spiffe` または `https_web`。この値は初期設定後は変更できません。
`federation.bundleEndpoint.refreshHint`	integer	いいえ	`300`	リモートサーバーがトラストバンドルを更新する推奨間隔 (秒単位)。有効範囲:60-3600。
`フェデレーション.バンドルエンドポイント.httpsWeb`	object	条件分岐	該当なし	`プロファイル` が `https_web` の場合に必須です。証明書の設定が含まれています。

Expand

フィールド	型	必須	デフォルト	説明
`フェデレーション.バンドルエンドポイント.httpsWeb.acme`	object	条件分岐	該当なし	ACME による自動証明書管理の設定。`servingCert` とは相互排他的です。
`federation.bundleEndpoint.httpsWeb.servingCert`	object	条件分岐	該当なし	証明書の手動設定。`アクメ` とは相互排他的である。

Expand

フィールド	型	必須	デフォルト	説明
`federation.bundleEndpoint.httpsWeb.acme.directoryUrl`	string	はい	該当なし	ACME ディレクトリーの URL。Let’s Encrypt のプロダクションについては、`https://acme-v02.api.letsencrypt.org/directory を参照し` てください。ステージング用: `https://acme-staging-v02.api.letsencrypt.org/directory`
`federation.bundleEndpoint.httpsWeb.acme.domainName`	string	はい	該当なし	証明書の完全修飾ドメイン名。通常はフェデレーションエンドポイントのホスト名です。
`federation.bundleEndpoint.httpsWeb.acme.email`	string	はい	該当なし	ACME アカウント登録および証明書有効期限通知用のメールアドレス。
`federation.bundleEndpoint.httpsWeb.acme.tosAccepted`	string	いいえ	`"false"`	ACME プロバイダーの利用規約に同意してください。証明書を取得するには、`真実` でなければならない。

Expand

フィールド	型	必須	デフォルト	説明
`federation.bundleEndpoint.httpsWeb.servingCert.fileSyncInterval`	integer	いいえ	`86400`	証明書の更新を確認する間隔 (秒単位)。有効範囲:3600-7776000(1 時間 -90 日間)。
`federation.bundleEndpoint.httpsWeb.servingCert.externalSecretRef`	string	はい	該当なし	フェデレーションルート用の TLS 証明書 (`tls.crt`) と秘密鍵 (`tls.key`) を含む Kubernetes Secret の名前。

Expand

フィールド	型	必須	デフォルト	説明
`federation.federatesWith[].trustDomain`	string	はい	該当なし	リモート SPIRE デプロイメントの信頼ドメイン名 (例: `cluster2.example.com`)。
`federation.federatesWith[].bundleEndpointUrl`	string	はい	該当なし	リモートフェデレーションエンドポイントの HTTPS URL(例: `https`://federation.apps.cluster2.example.com)。
`federation.federatesWith[].bundleEndpointProfile`	文字列 (列挙型)	はい	該当なし	リモートエンドポイントの認証プロファイル。有効な値: `https_spiffe` または `https_web`。
`federation.federatesWith[].endpointSpiffeId`	string	条件分岐	該当なし	リモート SPIRE サーバーの SPIFFE ID (例: `spiffe://cluster2.example.com/spire/server`)。`bundleEndpointProfile` が `https_spiffe` の場合に必須です。

フィールド検証ルール

オペレーターは、以下の検証ルールを適用します。

プロファイルの不変性: bundleEndpoint.profile フィールドは、初期設定後には変更できません。変更するには、SpireServer リソースを削除して再作成する必要があります (システムの再インストール)。
相互排他性: httpsWeb 内では、acme または servingCert のいずれか一方のみを指定できます。
条件要件: プロファイル が https_web の場合、acme または servingCert の いずれかが設定された httpsWeb オブジェクトが存在する必要があります。
SPIFFE ID の要件: federatesWith リストで bundleEndpointProfile が https_spiffe の場合、endpointSpiffeId フィールドは必須です。
配列の制限: federatesWith 配列は最大 50 個のエントリーをサポートします。
数値範囲:
- refreshHint:60-3600 秒
- ファイル同期間隔:3600-7776000 秒