federationSettings 리소스 를 사용하면 페더레이션 인증 구성에 대해 하나의 ID 제공자 를 반환할 수 있습니다.
필수 역할
이 엔드포인트를 호출하려면 페더레이션 구성에서 하나 이상의 연결된 조직에 대한 Organization Owner 역할이 있어야 합니다.
Resource
GET /federationSettings/{FEDERATION-SETTINGS-ID}/identityProviders/{IDP-ID}
요청 경로 매개변수
이름 | 유형 | 설명 |
|---|---|---|
| 문자열 | 페더레이션 인증 구성을 식별하는 고유한 24자리 16진수 문자열입니다. |
| 문자열 | IdP 를 식별하는 고유한 20자리 16진수 문자열입니다. |
요청 쿼리 매개변수
다음 쿼리 매개변수는 선택 사항입니다.
이름 | 유형 | 필요성 | 설명 | 기본값 | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
pretty | 부울 | 옵션 | 응답 본문이 pretty-print 형식이어야 하는지 여부를 나타내는 플래그입니다. |
| ||||||
envelope | 부울 | 옵션 | 응답을 엔벨로프에 래핑할지 여부를 나타내는 플래그입니다. 일부 API 클라이언트는 HTTP 응답 헤더 또는 상태 코드에 액세스할 수 없습니다. 이 문제를 해결하려면 쿼리에서 envelope=true를 설정합니다. 하나의 결과를 반환하는 엔드포인트의 경우 응답 본문에는 다음이 포함됩니다.
|
|
요청 본문 매개변수
이 엔드포인트는 HTTP 요청 본문 매개변수를 사용하지 않습니다.
응답
이름 | 유형 | 설명 | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 문자열 | IdP 가 SAML 응답을 보내는 어설션 소비자 서비스 URL입니다. | |||||||||
| 배열 | 사용자가 이 IdP 에 로그인할 수 있는 구성된 도메인이 포함된 목록입니다. | |||||||||
| 배열 | 사용자가 이 IdP 에 로그인할 수 있는 조직이 포함된 목록입니다. | |||||||||
| 문자열 | SAML Assertion의의도된 대상에 대한 식별자입니다. | |||||||||
| 문자열 | IdP 를 식별하는 사람이 읽을 수 있는 레이블입니다. | |||||||||
| 문자열 | SAML Assertion발급자의 식별자입니다. | |||||||||
| 문자열 | IdP 를 식별하는 고유한 20자리 16진수 문자열입니다. | |||||||||
| 배열 | ID 제공자의 PEM인코딩된 공개 키 인증서의 시작 날짜, 만료 날짜 등 파일 정보가 포함된 목록입니다.
| |||||||||
| 문자열 | AuthNRequest를 전송하는 데 사용되는 SAML 인증 요청 프로토콜 바인딩. Cloud Manager는 다음과 같은 바인딩 값을 지원합니다.
| |||||||||
| 문자열 | IdP 서명을 암호화하는 데 사용되는 알고리즘입니다. Cloud Manager는 다음과 같은 서명 알고리즘 값을 지원합니다.
| |||||||||
| 부울 | IdP 에 SSO 디버깅이 활성화되어 있는지 여부를 나타내는 플래그입니다. | |||||||||
| 문자열 | SAML AuthNRequest 수신자의 URL. | |||||||||
| 문자열 | ID 제공자가 활성 상태인지 여부를 나타내는 레이블입니다. IdP 는 하나 이상의 도메인을 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" }