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

1 つの接続された IdP を返す

federationSettingsリソースを使用すると、フェデレーション認証構成の 1 つのID プロバイダーを返すことができます。

このエンドポイントを呼び出すには、フェデレーション構成内の少なくとも 1 つの接続された組織のOrganization Ownerロールが必要です。

GET /federationSettings/{FEDERATION-SETTINGS-ID}/identityProviders/{IDP-ID}
名前
タイプ
説明

FEDERATION-SETTINGS-ID

string

フェデレーション認証構成を識別する一意な 24 桁の 16 進数のstring 。

IDP-ID

string

IdP を識別する一意の 20 桁の 16 進数文字列。

次のクエリ パラメータは 任意です。

名前
タイプ
必要性
説明
default

pretty

ブール値

任意

レスポンス本体をpretty-print形式にするかどうかを示すフラグ。

false

envelope

ブール値

任意

応答をエンベロープでラップするかどうかを示すフラグ。

一部の API クライアントは、HTTP レスポンス ヘッダーまたはステータス コードにアクセスできません。これを修正するには、クエリで envelope=true を設定します。

1 つの結果を返すエンドポイントの場合、レスポンス本体には次のものが含まれます。

  • status: HTTPレスポンス コード

  • content: 期待される応答本体

false

このエンドポイントは、HTTP リクエスト本体パラメータを使用しません。

名前
タイプ
説明

acsUrl

string

IdPが SAML 応答を送信するアサーション コンシューマー サービス URL。

associatedDomains

配列

ユーザーがこのIdPにログインできる構成済みのドメインを含むリスト。

associatedOrgs

配列

ユーザーがこのIdPにログインできる組織を含むリスト。

audienceUri

string

SAML アサーションの対象オーディエンスの識別子。

displayName

string

IdPを識別する人間が判読できるラベル。

issuerUri

string

SAML アサーションの発行者の識別子。

oktaIdpId

string

IdP を識別する一意の 20 桁の 16 進数文字列。

pemFileInfo

配列

IdP の PEM でエンコードされた公開キー証明書の開始日や有効期限などのファイル情報を含むリスト。

  • certificates (配列): IdP のPEMでエンコードされた公開キー証明書の開始日と有効期限が含まれたリスト。

  • fileName (string):IdP のPEMでエンコードされた公開キー証明書を含むファイルを識別するラベル。

requestBinding

string

AuthNRequest を送信するために使用されるSAML認証要求プロトコル バインディング。 Cloud Manager は次のバインディング値をサポートしています。

  • HTTP POST

  • HTTP REDIRECT

responseSignatureAlgorithm

string

IdP署名を暗号化するために使用されるアルゴリズム。 Cloud Manager は次の署名アルゴリズム値をサポートしています。

  • SHA-1

  • SHA-256

ssoDebugEnabled

ブール値

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

ssoUrl

string

SAML AuthNRequest の受信者の URL。

status

string

IdP がアクティブかどうかを示すラベル。IdP は、少なくと 1 つのドメインを IdP にマッピングするまで Inactive です。

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --include \ --request GET "https://cloud.mongodb.com/api/public/v1.0/federationSettings/{FEDERATION-SETTINGS-ID}/identityProviders/{IDP-ID}"
{ "acsUrl" : "https://example.mongodb.com/sso/saml2/12345678901234567890", "associatedDomains" : [ ], "associatedOrgs" : [ ], "audienceUri" : "https://www.example.com/saml2/service-provider/abcdefghij1234567890", "displayName" : "Test", "issuerUri" : "urn:123456789000.us.provider.com", "oktaIdpId" : "1234567890abcdefghij", "pemFileInfo" : { "certificates" : [ { "notAfter" : "2035-09-29T15:03:55Z", "notBefore" : "2022-01-20T15:03:55Z" } ], "fileName" : "file.pem" }, "requestBinding" : "HTTP-POST", "responseSignatureAlgorithm" : "SHA-256", "ssoDebugEnabled" : true, "ssoUrl" : "https://123456789000.us.provider.com/samlp/12345678901234567890123456789012", "status" : "INACTIVE" }