개시하다

평가 환경의 최대 사용자 수는 10000명입니다.
이 범위 내에서 사용자 등록,/v2.0/Users를 사용하여 사용자 검색을 시도했습니다.

testuser 0001~testuser 9989 등록.총 9992 사용자가 있는 디렉토리 준비

사용자 정의 속성 deptcode 만들기

deptcode에 임의의 영문 자모 4자리 + 임의의 숫자 3자리 데이터 등록

예제)

1. 검색 결과의 최대 값

테스트 사용자라는 키워드로 검색합니다.

검색 결과로 2천500건을 반납했다.

이 2500벌의 가격은 get/v2입니다.0/Users API는 한 번에 사용할 수 있는 사용자 수에 대한 최대 값입니다.
사용자 정보를 검색할 때 2500건의 상한치를 의식해야 한다.

2. 사용자 정의 속성 검색

이번에는 다음 사용자를 이용하여 검색을 시도합니다.
항목
속성 이름
설정 값
사용자 이름
username
testuser2000
사용자 정의 속성
deptcode
QQVB817

2.1. 관리 콘솔에서 사용자 이름 검색

관리 화면에서testuser 2000을 검색하면fulltext라는 전문 인덱스로 요청합니다.

リクエストURL：
GET https://<テナント名>.verify.ibm.com/v2.0/Users?count=200&sortBy=urn:ietf:params:scim:schemas:extension:ibm:2.0:User:lastLogin&sortOrder=descending&startIndex=1&fullText=testuser2000

테스트 사용자 2000의 결과가 돌아왔습니다.

2.2. 관리 콘솔에서 사용자 정의 속성 찾기

그런 다음 관리 화면에서 사용자 정의 속성으로 설정된 값을 찾습니다.
fulltext 옵션에서 검색합니다. 사용자 정의 속성이 대상에 없기 때문에 검색과 일치하는 결과가 없습니다.

2.3. API를 통해 사용자 정의 속성 찾기

API에서 "QQVB817"에 해당하는 사용자 정의 속성(deptcode) 기록을 찾으려면 Filter 옵션을 사용하여 읽어들입니다.
대문자로 시작하는 Filter는 필터링되지 않으므로 소문자 Filter를 사용해야 합니다.

リクエストURL例（一部割愛）
GET https://<テナント名>.verify.ibm.com/v2.0/Users?filter=urn:ietf:params:scim:schemas:extension:ibm:2.0:User:customAttributes.deptcode eq "QQVB817"

Postman을 사용하여 API를 실행하면 검색 결과가 반환됩니다.

최후

이번에는 사용자 검색의 주의사항을 소개했다.
API를 사용하여 읽어들일 때는 다음 사항에 유의하십시오.

get/v2.최대 0/users API 검색 결과 2500건

fulltext 옵션은 사용자 정의 속성에 적용되지 않습니다

사용자 정의 속성은 Filter 옵션으로 검색할 수 있습니다 (Filter 는 모두 소문자)