AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
Docs Menu

AtlasFederatedAuth カスタム リソース

AtlasFederatedAuthカスタム リソースは、Atlas 組織のフェデレーティッド認証を構成します。

When you create the AtlasFederatedAuth custom resource, Atlas Kubernetes Operator uses the Federated Authentication API Resource to update the organization configuration for the federation. In the organization configuration, you specify federation settings for your Atlas organization such as organization and role mappings.

重要

カスタム リソースはデフォルトでオブジェクトを削除しなくなりました

  • Atlas Kubernetes Operator はカスタムリソース構成ファイルを使用して Atlas 構成を管理しますが、Atlas Kubernetes Operator2.0 以降、 Kubernetesで削除したカスタム リソースは Atlas で削除されなくなりました(デフォルトでは )。代わりに、Atlas Kubernetes Operator は Atlas 内のそれらのリソースの管理を停止します。 例、 Kubernetesで カスタム リソースを削除すると、デフォルトでは、Atlas Kubernetes Operator は AtlasAtlasProject から対応するプロジェクトを自動的に削除しなくなります。この動作の変更は、誤ってまたは予期せずに削除されるのを防ぐことを目的としています。 この動作を Atlas Kubernetes Operator. 以前に使用されていたデフォルトに戻す方法などの詳細については、「2 0新しいデフォルト: Atlas Kubernetes Operator. の削除保護2 0」を参照してください。

    同様に、Atlas Kubernetes Operator を使用してKubernetesの Atlasプロジェクトからチームを削除しても、Atlas Kubernetes Operator は Atlas からチームを削除しません。

  • デフォルトのAtlas 構成値が暗黙的に使用されるのを避けるために、必要な構成の詳細を明示的に定義します。 場合によっては、Atlas のデフォルトを継承すると調整ループが発生し、カスタムリソースがREADY 状態に達しなくなります。 例、含まれている例に示すように、 AtlasDeployment カスタムリソースで必要なオートスケーリング動作を明示的に定義すると、カスタムリソース内の静的インスタンスサイズが、オートスケーリングが有効になっている Atlas 配置に繰り返し適用されないことが保証されます。

    autoScaling:
    diskGB:
    enabled: true
    compute:
    enabled: true
    scaleDownEnabled: true
    minInstanceSize: M30
    maxInstanceSize: M40

このリソースを使用するには、Atlas 組織にリンクされた既存の ID プロバイダー( IdP )が必要です。 詳細については、「 Kubernetes からのフェデレーション認証の活用 」を参照してください。

次の例では、次の操作を実行するAtlasFederatedAuthカスタム リソースを構成します。

  • 指定されたシークレットにリンクされた組織のフェデレーティッド認証を有効にします。

  • 承認されたドメインとしてmy-org-domain.comを追加します。

  • 組織のドメイン制限を有効にします。

  • SSOのデバッグを無効にします。

  • Grants the Organization Member role to users after authenticating.

  • Maps the Organization Owner role for the organization and applies the role mapping to an IdP group named org-admin.

  • Maps the Organization Project Creator and Project Owner roles for a project in the organization named dev-project and applies the role mapping to an IdP group named dev-team.

apiVersion: atlas.mongodb.com/v1
kind: AtlasFederatedAuth
metadata:
name: atlas-default-federated-auth
namespace: mongodb-atlas-system
spec:
enabled: true
dataAccessIdentityProviders:
- 32b6e34b3d91647abb20e7b8
- 42d8v92k5a34184rnv93f0c1
connectionSecretRef:
name: my-org-secret
namespace: mongodb-atlas-system
domainAllowList:
- my-org-domain.com
domainRestrictionEnabled: true
ssoDebugEnabled: false
postAuthRoleGrants:
- ORG_MEMBER
roleMappings:
- externalGroupName: org-admin
roleAssignments:
- role: ORG_OWNER
- externalGroupName: dev-team
roleAssignments:
- role: ORG_GROUP_CREATOR
- projectName: dev-project
role: GROUP_OWNER
status:
conditions:
- type: Ready
status: True
- type: RolesReady
status: True
- type: UsersReady
status: True

注意

前の例には、更新プロセスを説明するstatusセクションが含まれています。 詳しくは、「プロセスの作成と更新 」を参照してください。

This section describes the parameters available for the AtlasFederatedAuth custom resource. For detailed descriptions of the parameters, see the Atlas Federated Authentication API Resource.

これらの説明、このページの例、および API ドキュメントを参照して、仕様をカスタマイズします。

metadata.name

型: string

必須

Atlas Kubernetes Operator が組織のフェデレーティッド認証を構成するために使用するAtlasFederatedAuthカスタム リソースを識別する名前。

metadata.namespace

型: string

任意

atlasFederatedAuth カスタムリソースを含める名前空間。指定されていない場合、Atlas Kubernetes Operator は kubectl によって設定された現在の名前空間を使用します。

spec.enabled

タイプ: ブール値

必須

組織に対してフェデレーティッド認証を有効にするかどうかを決定するフラグ。 デフォルトはfalseです。

spec.dataAccessIdentityProviders

タイプ: list

任意

Atlas Kubernetes Operator が組織のフェデレーティッド認証の構成 に使用する ID プロバイダーを識別する string 値のリスト。

注意

dataAccessIdentityProviders パラメータは、データアクセスに使用される 1 つ以上の ID プロバイダーを定義します。 つまり、 AtlasDatabaseUserリソースで構成されている、実際のMongoDBデータベースインスタンスにアクセスするために使用されます。これは、Atlas UIの ID プロバイダーを使用するを構成するために使用される AtlasFederatedAuthリソースの既存のオプションとは異なります。

spec.connectionSecretRef.name

型: string

必須

Atlas Kubernetes Operator がpassword Atlas への接続に使用する組織IDとAPIキーを持つ単一の フィールドを含む opaque シークレットの名前。シークレットを作成するときは、orgID publicApiKey、 、privateApiKey フィールドを指定します。

The secret's API keys must have the Organization Owner role. You can use the same secret from an AtlasProject Custom Resource only if the secret has Organization Owner permissions.

Atlas Kubernetes Operator atlas.mongodb.com/type=credentialsは、不要な シークレット の監視を回避するために、ラベル のシークレットのみを監視します。

次の例ではシークレットにラベルを付けます。

kubectl label secret the-user-password atlas.mongodb.com/type=credentials

注意

デフォルトでは 、Atlas Kubernetes Operator は カスタム AtlasProjectリソースと同じ名前空間に接続シークレットを保持します。シークレットを別の名前空間に保存するには、spec. connectionSecretRef を指定します。名前空間パラメータ。

spec.connectionSecretRef.namespace

型: string

任意

Atlas Kubernetes Operator が Atlas に接続するために使用する組織IDとAPIキーのシークレットを含む名前空間。このパラメーターを省略または指定しない場合、Atlas Kubernetes Operator は カスタム AtlasProjectリソースと同じ名前空間に接続シークレットを保持します。

spec.domainAllowList

タイプ: 文字列の配列

任意

メールアドレスに基づいて組織に参加できるユーザーを制限する承認済みドメイン。

spec.domainRestrictionEnabled

タイプ: ブール値

必須

接続済み組織に対してドメイン制限が有効になっているかどうかを示すフラグ。 デフォルトはfalseです。

このパラメータをtrueに設定すると、Atlas はフェデレーション外の組織に属するユーザーのリストを返します。 詳細については、「ユーザー競合 」を参照してください。

spec.ssoDebugEnabled

タイプ: ブール値

任意

IdP で SSO デバッグが有効になっているかどうかを示すフラグ。デフォルトは false です。

spec.postAuthRoleGrants

タイプ: 文字列の配列

任意

認証後にこの組織内のユーザーに付与される Atlas ロール。以下に例を挙げます。

  • ORG_MEMBER

  • ORG_READ_ONLY

  • ORG_BILLING_ADMIN

  • ORG_GROUP_CREATOR

  • ORG_OWNER

  • ORG_BILLING_READ_ONLY

許容値の完全なリストについては、フェデレーティッド認証 API リソース を参照してください。

spec.roleMappings

タイプ: オブジェクトの配列

任意

この組織で設定されているロール マッピング。

The spec.roleMappings.roleAssignments parameter must include at least one organization role within the current organization or the projects in the organization.

spec.roleMappings.externalGroupName

型: string

必須

このロール・マッピングが適用される IdP グループを識別する、人間に判読可能なユニークなラベル。

spec.roleMappings.roleAssignments

タイプ: オブジェクトの配列

任意

Atlas のロールと、各ロールに関連付けられたグループおよび組織の一意の識別子。 このパラメーターには、現在の組織内の少なくとも 1 つの組織ロールまたは組織内のプロジェクトを含める必要があります。

spec.roleMappings.roleAssignments.projectName

型: string

任意

ロールを関連付ける組織内の Atlas プロジェクト。

spec.roleMappings.roleAssignments.role

型: string

任意

Atlas が特定の API キー、ユーザー、またはチームに付与する特権のコレクションを識別する、人間が判読可能なラベル。 これらのロールには、組織レベルとプロジェクト レベルの特権が含まれます。

Atlas Kubernetes Operator は、次の値を受け入れます。

  • ORG_MEMBER

  • ORG_READ_ONLY

  • ORG_BILLING_ADMIN

  • ORG_GROUP_CREATOR

  • ORG_OWNER

  • ORG_BILLING_READ_ONLY

  • GROUP_OWNER

  • GROUP_READ_ONLY

  • GROUP_DATA_ACCESS_ADMIN

  • GROUP_DATA_ACCESS_READ_ONLY

  • GROUP_DATA_ACCESS_READ_WRITE

  • GROUP_CLUSTER_MANAGER

  • GROUP_SEARCH_INDEX_EDITOR

このページを評価