SCIM: 목록 API는 페이지 매김 결과를 반환하며, 지원되지 않는 필터는 거부됨(보류 중)

주의

이 동작 변경 사항은 2026_03 번들에 포함되어 있습니다.

번들의 현재 상태는 번들 기록 섹션을 참조하십시오.

SCIM 목록 API 엔드포인트(GET /scim/v2/UsersGET /scim/v2/Groups)는 계정에서 사용자 또는 그룹의 페이지 매김 목록을 반환하도록 변경되며, 선택적으로 제공된 eq 또는 sw 필터와 일치합니다. 이전에는 이러한 엔드포인트가 단일 합성 샘플 오브젝트를 반환했습니다.

필터링되지 않은 목록 호출

변경 전:

GET /scim/v2/UsersGET /scim/v2/Groups``는 ``filter 매개 변수 없이 단일 합성 샘플 오브젝트를 반환했습니다. 예를 들어, ``GET /scim/v2/Users``는 다음을 반환했습니다.

{
  "totalResults": 1,
  "startIndex": 1,
  "itemsPerPage": 1,
  "Resources": [{
    "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User", "..."],
    "id": "1",
    "externalId": "synthesis_user_external_id",
    "userName": "synthesis_user",
    "displayName": "synthesis_user_display_name",
    "active": false
  }]
}

마찬가지로, 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