SCIM: 목록 API는 페이지 매김 결과를 반환하며, 지원되지 않는 필터는 거부됨(보류 중)¶
SCIM 목록 API 엔드포인트(GET /scim/v2/Users 및 GET /scim/v2/Groups)는 계정에서 사용자 또는 그룹의 페이지 매김 목록을 반환하도록 변경되며, 선택적으로 제공된 eq 또는 sw 필터와 일치합니다. 이전에는 이러한 엔드포인트가 단일 합성 샘플 오브젝트를 반환했습니다.
필터링되지 않은 목록 호출
- 변경 전:
GET /scim/v2/Users및GET /scim/v2/Groups``는 ``filter매개 변수 없이 단일 합성 샘플 오브젝트를 반환했습니다. 예를 들어, ``GET /scim/v2/Users``는 다음을 반환했습니다.마찬가지로,
GET /scim/v2/Groups``는 단일 ``synthetic_group오브젝트를 반환했습니다.- 변경 후:
동일한 호출은 계정에서 표준 SCIM 페이지 매김(
startIndex,count)으로 사용자 또는 그룹의 페이지 매김 목록을 반환합니다.
필터 식 유효성 검사
- 변경 전:
필터 값이 대략적으로 구문 분석되었습니다. 논리 연산자(
and,or) 및 잘못된 형식의 필터 값을 포함한 지원되지 않는 필터 식이 자동으로 수락되어 빈Resources배열과 함께 ``200 OK``를 반환했습니다.- 변경 후:
이제 필터 값이 SCIM의 JSON 인코딩 요구 사항과 일관되게 따옴표로 묶인 JSON으로 구문 분석됩니다. 지원되지 않거나 형식이 잘못된 필터 식은 HTTP
400 Bad Request및 SCIM 오류 유형invalidFilter``로 거부됩니다. ``eq또는 ``sw``에서 지원되는 단일 특성 필터는 영향을 받지 않습니다.
ServiceProviderConfig 필터 지원
- 변경 전:
GET /scim/v2/ServiceProviderConfig``는 ``filter.supported``를 정수(``0)로 보고했습니다.- 변경 후:
filter.supported``는 RFC 7643의 요구 사항에 따라 부울(``true)입니다.
SCIM 클라이언트가 and 또는 or``를 사용하여 필터 식을 보내는 고객은 간단한 필터를 사용하거나 ``400 invalidFilter 응답을 처리하도록 클라이언트를 업데이트해야 합니다.
참고
사용자 또는 그룹 수가 많은 고객은 필터링되지 않은 목록 호출의 응답 시간이 증가할 수 있습니다. 응답 크기를 줄이려면 사용자를 나열할 때 ``excludedAttributes=groups``를 사용하거나 그룹을 나열할 때 ``excludedAttributes=members``를 사용합니다. 이를 통해 대규모 계정의 응답 크기와 대기 시간의 주요 동인인 구성원 자격 확장이 방지됩니다.
Ref: 2276