주 컨텐츠로 이동
문서
문서
Peakon
최종 업데이트: 2025-01-24
개념: Peakon SCIM 2.0 API

개념: Peakon SCIM 2.0 API

Peakon의 API는 직원 프로비저닝 및 프로비저닝 해제를 자동화하여 Peakon 설문 조사 참여가 Microsoft Azure Active Directory, Okta, OneLogin과 같은 SCIM 2.0 프로토콜을 지원하는 시스템과 일치하도록 보장합니다. 이 방법을 사용하면 여러 시스템에서 직원 기록을 업데이트하고 동기화할 수 있습니다.

SCIM 2.0 소개

SCIM(System for Cross-domain Identity Management) 2.0은 HTTP를 통한 단방향으로 사용자를 프로비저닝하기 위한 표준화된 REST 프로토콜을 지정합니다. 기존의 ID 관리 시스템을 구성하여 데이터베이스에 적용된 변경 사항을 Peakon과 같은 타사 애플리케이션에 자동으로 동기화할 수 있습니다. SCIM 프로토콜에서는 중앙 ID 관리 시스템을 "ID 공급자"라고 하며, 타사 애플리케이션을 "서비스 공급자"라고 합니다. 기존 ID 관리 시스템과 함께 Peakon을 서비스 공급자로 구성하면 조직에서 자동 계정 프로비저닝의 모든 이점을 활용할 수 있습니다.
설정 방법에 대한 지침은 다음을 방문하세요. SCIM 2.0을 사용하여 직원 프로비저닝 설정.

지원되는 작업

Peakon SCIM 2.0 API는 다음 작업을 지원합니다.
  • 사용자 생성
  • 사용자 업데이트
  • 사용자 삭제
  • 사용자 활성화/비활성화
  • 사용자를 위한 대량 작업

Enterprise Schema Extension

Peakon은 SCIM 2.0 사양에 정의된 대로 Enterprise 사용자 스키마 확장에서 다음과 같은 기본 속성을 지원합니다.
  • 직원 번호
  • 부서
  • 매니저
귀사의 스키마에는 귀사의 Enterprise 사용자 스키마와 Peakon 스키마 확장이 포함되어 있습니다. 사용 가능한 필드를 포함하여 회사에서 지원하는 스키마를 검색하려면 스키마
가져오기
엔드포인트를 호출합니다.

Peakon 스키마 확장

Peakon은 기본 필드 외에도 사용자 정의 속성(예:
관리자
,
생년월일
,
부서
등)에 대한 필드 데이터를 허용하는 사용자 정의 스키마 확장을 제공합니다. 이 확장의 형식은 SCIM 2.0 사양에 지정된 형식을 따릅니다.
사용자 정의 속성의 값 유형은 속성 유형에 따라 달라집니다.
속성 유형
값 유형
옵션 유형 속성.
예:
부서
.
문자열 값(최대 256자).
날짜 유형 속성.
예:
생년월일
.
DateTime
문자열(ISO 8601 형식).
숫자형 속성.
예:
급여
.
정수 값.
직원 유형 속성.
예:
관리자
.
참조된 직원의 이메일을 포함하는 문자열 값입니다. 직원 유형 속성은 시스템의 다른 직원을 참조하므로 참조된 직원은 시스템에 미리 존재해야 합니다. 2단계 프로비저닝을 사용하면 첫 번째 단계에서는 기본 필드만 포함하고 두 번째 단계에서는 확장 필드를 포함하여 이 작업을 수행할 수 있습니다.
사용자 정의 속성은 기본 리소스 필드의 하위 개체로 제공됩니다. 예: 
{
“name” : {
“firstName”: “Jane”,
“lastName”: “Smith”
},
“urn:ietf:params:scim:schemas:extension:peakon:2.0:User”: {
“Business Unit”: “Engineering”,
“Department”: “IT”
}
}
사용 가능한 필드를 포함하여 회사에서 지원하는 스키마를 검색하려면 스키마
가져오기
엔드포인트를 호출합니다.

유효 탑재량

방문하다 참고: Peakon SCIM 2.0 API 페이로드자세한 내용은.

속도 제한

Peakon SCIM API의 속도는 시간당 25,000개 작업으로 제한됩니다. 대량 SCIM API 요청은 요청 페이로드의 작업당 1개의 작업을 소모합니다. 다른 SCIM API 요청은 1개의 작업을 소모합니다. 모든 통합은 이 제한을 초과하지 않도록 API 호출을 조절해야 합니다.