https://docs.kakaowork.com/kakao_work_account/dev_process/ Recent content in 개발 프로세스 on 카카오워크 기술문서 Hugo -- gohugo.io ko-kr © Kakao Corp. https://docs.kakaowork.com/kakao_work_account/dev_process/agent/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.kakaowork.com/kakao_work_account/dev_process/agent/ 메타 정보 API 개발 Adapter Agent 서버에서 구현한 Capability와 오류 정보를 공유하기 위해 Adapter Agent API의 Agent Capability를 구현해야 합니다. 표Agent Capability 분류 Capability 하위 API 설명 Adapter Agent API Agent Capability getAgentCapabilities Adapter Agent 서버에 구현되어 있는 Capability 정보를 카카오워크 서비스 시스템에 제공 reportError 카카오워크 서비스 시스템으로부터 오류 정보를 수신 주의 Agent Capability 구현 시 모든 Adapter Agent 서버를 반드시 구현해야 합니다. https://docs.kakaowork.com/kakao_work_account/dev_process/user/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.kakaowork.com/kakao_work_account/dev_process/user/ 사용자 정보 API 개발 고객사의 계정 정보를 카카오워크 계정 서버에 동기화하고, 사용자 정보 메타데이터 및 동기화 관련 옵션을 카카오워크 계정 관리자 사이트에서 제어하기 위해 Adapter Agent API의 User Capability를 구현해야 합니다. 표User Capability 분류 Capability API 명 설명 Adapter Agent API User Capability getValidUsers API 호출 시점을 기준으로 카카오워크 서비스 시스템을 사용할 수 있는 사용자 목록 제공 getChangedUsers 정보 변경, 활성화 및 비활성화가 일어난 사용자 목록 제공 https://docs.kakaowork.com/kakao_work_account/dev_process/login/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.kakaowork.com/kakao_work_account/dev_process/login/ 로그인 정보 API 개발 고객사의 직원들이 고객사의 인증 시스템을 기반으로 카카오워크 서비스를 이용할 수 있도록 Adapter Agent API의 Login Capability를 구현해야 합니다. Login Capability 구현 시, 고객사의 인증 시스템이 어떤 방식의 인증을 지원하는지에 따라 적절한 계정 타입을 선택하고, identifyUser API 또는 extractUser API를 선택하여 구현합니다. 현재 카카오워크 서비스 시스템은 ID/PW 인증 연동, OAuth 2.0 인증 연동, SAML 2.0 인증 연동 방식을 지원합니다. 표Login Capability 분류 Capability API 명 설명 Adapter Agent API Login Capability identifyUser 입력받은 ID와 Password 등이 올바른지 확인 https://docs.kakaowork.com/kakao_work_account/dev_process/orgunit/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.kakaowork.com/kakao_work_account/dev_process/orgunit/ 조직도 정보 API 개발 카카오워크에 고객사의 조직도 정보를 동기화하기 위해 Adapter Agent API의 orgUnit Capability를 구현해야 합니다. 표orgUnit Capability 분류 Capability API 명 설명 Adapter Agent API orgUnit Capability getValidOrgunits API 요청 시점에서 유효한 조직도 전체 목록 제공 getChangedOrgunits 특정 시점부터 API 호출 시점까지의 추가, 변경, 비활성화가 일어난 조직도 목록 제공 getResponsibilities 직책 정보 제공 getPositions 직위 정보 제공 카카오워크에 고객사의 조직도 정보를 동기화할 때는 다음과 같이 구성합니다. https://docs.kakaowork.com/kakao_work_account/dev_process/adapter/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.kakaowork.com/kakao_work_account/dev_process/adapter/ 로그인 정보 API 호출 Adapter API는 카카오워크의 Adapter 서버에 구현되어 있으며, Adapter Agent 서버가 Adapter 서버로 직접 호출합니다. 표Adapter API 목록 분류 Capability API 명 설명 Adapter API - getOrgLoginType Adapter Agent 서버를 구현한 고객사의 로그인 방식에 대한 정보를 제공 ex) LDAP, OAuth 2.0, SAML 2.0 등 Adapter API를 호출하는 경우는 다음과 같습니다. - Adapter Agent 서버에서 로직을 처리하는 중, 카카오워크 서비스 시스템이 가지고 있는 정보가 필요한 경우 https://docs.kakaowork.com/kakao_work_account/dev_process/ssourl/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.kakaowork.com/kakao_work_account/dev_process/ssourl/ SSO 연동 고객사의 직원들이 카카오워크 서비스를 통해 Single Sign-On(SSO)을 이용할 수 있도록 Adapter Agent API의 SSO Capability를 구현해야 합니다. SSO Capability 구현 시, Login Capability의 구현 메서드(identifyUser API 또는 extractUser API)의 Response에 user_principal을 반환해야합니다. 표SSO Capability 분류 Capability API 명 설명 Adapter Agent API SSO Capability generateSsoUrl SSO URL 제공 generateSsoUrl 구현 카카오워크 서비스는 Adapter 서버를 통해 Adapter Agent 서버가 제공하는 고객사 유저의 SSO URL을 얻게 됩니다. https://docs.kakaowork.com/kakao_work_account/dev_process/drm/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.kakaowork.com/kakao_work_account/dev_process/drm/ DRM API 개발 고객사의 직원들이 카카오워크 서비스를 통해 파일을 주고받는 과정에서 각 직원의 DRM(Digital Rights Management) 권한 확인 및 해제 요청이 필요합니다. 이를 수행하기 위해 Adapter Agent API의 DRM Capability를 구현해야 합니다. 주의 Agent Capability 구현 시, SSO Capability 구현 및 계정 연결 제공자 정보 등록이 필수로 선행되어야 합니다. 표DRM Capability 분류 Capability API 명 설명 Adapter Agent API DRM Capability authenticate 파일 타입 확인 및 DRM 파일인 경우, 사용자의 접근 권한 확인 decrypt 파일 타입 확인 및 DRM 파일인 경우, 사용자의 접근 권한 확인 및 DRM 해제 요청 Adapter API - uploadResult DRM 해제 결과 전달 uploadDecrypted DRM 해제 파일 전달 authenticate 구현 카카오워크 서비스는 authenticate API를 통해 Adapter Agent 서버에 사용자의 DRM 파일 접근 권한 확인을 요청합니다.