이 페이지는 개발자를 위한 것입니다. 조직의 로그인은 표준입니다 OAuth 2.0 및 OpenID 연결 모든 앱이나 도구가 Kamo 계정으로 로그인할 수 있으며, 사용자의 권한으로 API와 Kamo MCP 서버를 통해 Kamo 데이터를 사용할 수 있습니다. 여기에는 하나의 벤더 또는 하나의 종류의 앱에 특화된 내용이 없습니다.
시작하기 전에
- 관리자가 열립니다 설정, 그럼 보안, ID & 로그인, 연결된 앱, 그리고 앱을 연결합니다(참조 앱 연결) 그들은 얻을 고객 ID, 그리고 웹사이트에 대 한 비밀 클라이언트, 한 번 표시됩니다.
- 애플리케이션은 다음에서 다른 모든 것을 읽습니다 발견 주소 예를 들어, 앱의 카드에
https://login.yourcompany.com/.well-known/openid-configuration. 자신의 웹 주소가없는 조직은 하나와 같은https://login.kamouniverse.com/o/<organization number>/.well-known/openid-configuration. 이 페이지의 모든 다른 주소는 같은 시작 발행자.
권한 (범위)
앱이 다음과 같은 권한을 요청합니다 scope로그인 권한은 다음과 같습니다 openid (항상 필요함), profile, email, phone, kamo.org, kamo.roles 그리고 offline_access (새로 고침 토큰으로 연결 유지).
아래의 데이터 권한은 앱이 다른 사람을 대신하여 API를 사용할 수 있도록 합니다. 각 권한은 해당 사람이 이미 가지고 있는 Kamo개의 권한을 나타냅니다. 앱은 Kamo에서 사용자가 할 수 있는 것보다 더 많은 것을 할 수 없습니다: 토큰이 발행되면 해당 사용자가 그 순간에 보유한 Kamo개의 데이터 권한만을 담고, 모든 호출이 그 순간에 보유한 데이터 권한과 비교하여 다시 확인됩니다. 앱은 삭제를 사용할 수 없습니다.
범위 | 무엇을 허용하는가 | Kamo 권한이 필요합니다 (아무것도) |
|---|---|---|
| 연락처 및 세부 정보 읽기 | 연락처 보기 |
| 연락처 만들기 및 세부 정보 편집하기 | 연락처 생성, 연락처 편집 |
| 볼 수 있는 리드를 읽고 상태와 이력을 확인하세요 | 리드 보기 |
| 리드 생성, 편집 및 파이프라인을 통해 이동 | 리드 생성, 리드 편집, 리드 단계 이동 |
| 캘린더 및 이벤트 읽기 | 달력 보기 |
| 캘린더에서 이벤트 생성 및 변경하기 | 달력 보기 |
| Kamo에서 열 수 있는 메일박스 읽기 | 메일 액세스 |
| 사용할 수 있는 사서함에서 전자 메일 작성 및 보내기 | 메일 액세스 |
| 메모 및 체크리스트 읽기 | 노트 보기, 작업 보기 |
| 메모 및 체크리스트 생성 및 편집 | 노트 만들기, 노트 편집하기 |
| 열 수 있는 문서 및 파일 읽기 | 문서 보기 |
| 문서 업로드 및 편집 | 문서 만들기, 문서 편집 |
| 조직의 지식 기반 문서 읽기 | KB 기사 보기 |
| 지식 기반 문서 생성 및 편집 | KB 기사 만들기, KB 기사 편집 |
| 회의 및 세부 정보 읽기 | 모임 보기 |
| 모임 예약, 변경 및 시작 | 회의 시작, 회의 관리 |
동일한 목록, 항상 현재,에 있습니다 https://api.<your domain>/api/security/oidc/scopes그래, 그래 write 이 권한을 사용하면 앱이 동일한 유형의 데이터를 읽을 수도 있습니다.
앱은 앱에 부여된 권한만 요청할 수 있습니다. 관리자가 앱을 연결할 때 권한을 선택합니다 무엇을 볼 수 있는지, 아래의 데이터는 Kamo 데이터 작업, 하나 보기 그리고 하나 변경 각각 필요한 Kamo 권한을 보여주는 데이터 종류별로 전환합니다. 요청한 범위를 정확히 전환하도록 요청합니다. 앱에 부여되지 않은 범위를 요청하면 다음과 같이 실패합니다 invalid_scope.
누군가에 로그인 (PKCE 인증 코드)
PKCE 챌린지와 함께 인증 주소로 사용자의 브라우저를 보냅니다.
https://login.yourcompany.com/oauth/authorize?response_type=code&client_id=YOUR_CLIENT_ID
&redirect_uri=https%3A%2F%2Fapp.example.com%2Fcallback&scope=openid%20profile%20contacts.read%20offline_access
&state=RANDOM&code_challenge=BASE64URL_SHA256_OF_VERIFIER&code_challenge_method=S256로그인하고, 앱이 요청하는 것을 간단한 단어로 확인하고, 허용. 귀하의 리디렉션 주소 수신 code, state 그리고 iss. 토큰을위한 코드를 교환:
curl -X POST https://login.yourcompany.com/oauth/token \
-u YOUR_CLIENT_ID:YOUR_CLIENT_SECRET \
-d grant_type=authorization_code -d code=THE_CODE \
-d redirect_uri=https://app.example.com/callback -d code_verifier=THE_VERIFIER비밀을 유지할 수 없는 앱(단일 페이지, 모바일, 데스크톱, 명령줄) 보내기 client_id=YOUR_CLIENT_ID 대신에 -u답은 access_token (수행자 표시) id_token (사인한 사람), refresh_token (단지 offline_access) 그리고 scope (토큰이 실제로 가지고 있는 것)
API 호출
조직의 API 주소로 액세스 토큰을 보냅니다.
curl https://api.yourcompany.com/api/contacts -H "Authorization: Bearer ACCESS_TOKEN"- 401 다음으로
WWW-Authenticate: Bearer error="invalid_token": 토큰이 만료되었거나 취소되었거나 사용자가 더 이상 액세스할 수 없습니다. 새로 고침하거나 다시 로그인하십시오. - 403 다음으로
error="insufficient_scope", scope="contacts.write": 토큰에 주소가 필요한 권한이 없습니다. 로그인 시 요청하십시오. - 리딩 (영어)
GET)이 필요합니다read그 종류의 데이터의 권한; 데이터를 변경하는 모든 필요write.
앱이 스스로 등록하도록 허용
관리자가 활성화한 경우 앱이 스스로 연결하도록 허용 표준 등록 요청(RFC 7591)을 사용하여 누구도 입력하지 않고 앱을 등록할 수 있습니다. 주소는 검색 문서에서 다음과 같이 표시됩니다 registration_endpoint:
curl -X POST https://login.yourcompany.com/oauth/register -H "Content-Type: application/json" -d '{
"client_name": "My Tool", "redirect_uris": ["http://127.0.0.1:33418/callback"],
"token_endpoint_auth_method": "none", "grant_types": ["authorization_code", "refresh_token"],
"scope": "openid contacts.read leads.read offline_access" }'답은 당신에게 있습니다 client_id (그리고 client_secret 하나를 유지하는 앱) 및 kamo_status. 대기 중 누구든지 로그인할 수 있기 전에 관리자가 연결된 앱에서 승인해야 합니다. 그 때까지 로그인하면 "이 앱은 승인을 기다리고 있습니다."가 표시됩니다 404.
AI 도우미 또는 MCP 클라이언트 연결
Kamo MCP 서버는 다음에 있습니다 https://api.yourcompany.com/mcp. MCP 인증을 지원하는 모든 MCP 클라이언트는 연결할 수 있습니다 401 와 함께 WWW-Authenticate 다음을 가리키는 헤더 https://api.yourcompany.com/.well-known/oauth-protected-resource/mcp그런 다음 클라이언트가 자체적으로 등록하거나(허용된 경우) 관리자가 제공한 클라이언트 ID를 사용하여 위와 같이 사용자를 로그인하고 로그인 메시지를 보냅니다 Authorization: Bearer ACCESS_TOKEN 사용할 수 있는 도구는 사용자의 권한과 토큰의 범위가 허용하는 것과 정확히 같습니다.
TV 또는 장치에서 로그인
키보드가 없는 장치는 장치 로그인(RFC 8628)을 사용합니다 TV 또는 장치 다음을 입력하거나 장치 로그인을 켜십시오.
curl -X POST https://login.yourcompany.com/oauth/device_authorization -d client_id=YOUR_CLIENT_ID -d "scope=openid profile"사람을 보여주십시오 user_code (같은 WDJB-MJHT) 그리고 verification_uri, 다음 폴링 매 interval 초:
curl -X POST https://login.yourcompany.com/oauth/token -d grant_type=urn:ietf:params:oauth:grant-type:device_code \
-d device_code=THE_DEVICE_CODE -d client_id=YOUR_CLIENT_ID답이 될 때까지 투표를 계속합니다 authorization_pending; 에 slow_down 코드는 10분 동안 유효합니다.
누군가가 떠날 때
사람의 액세스 제거 Kamo API와 MCP 서버가 즉시(1분 이내) 응답을 중단하고 새로 고침에 실패합니다. 사용자는 앱을 직접 제거할 수도 있습니다 내 프로필 보기, 액세스가 있는 앱.
관련 기사 보기
이것에 가까운 질문에 대답하는 다른 가이드.
앱 연결
앱을 연결하는 데는 7가지 단계가 필요합니다. 열기 설정, 그럼 보안, 선택 ID & 로그인, 그럼 연결된 앱, 그리고 누르십시오 앱 연결당신이 필요해요 연결된 앱 관리 허락하세요 아무것도 저장되지 않습니다 앱 연결 누군가가 앱에 로그인할 때까지 아무도 영향을 받지 않습니다. 앱 연결 2단계, 4단계, 6단계의 오른쪽에는 사용자가 처음 로그인할 때 표시되는 페이지의 이미지가 나타납니다. 이…
앱이 스스로 연결하도록 허용
MCP 및 명령줄 도구를 사용하는 AI 조수와 같은 일부 앱은 관리자가 입력하는 대신 조직의 로그인에 자동으로 연결할 수 있습니다 동적 등록그래요 꺼짐 당신이 켜지 않는 한. 어디에 있는지 열기 설정, 그럼 보안, 선택 ID & 로그인, 그럼 연결된 앱당신이 필요해요 연결된 앱 관리 권한이 있어야 하며 조직의 로그인 공급자가 켜져 있어야 합니다. 세 가지 선택 꺼짐 (기본값): 앱이 스스로…
연결된 앱
연결된 앱을 사용하면 사용자가 이미 가지고 있는 Kamo 계정으로 WordPress, Grafana, Moodle, Nextcloud 또는 귀하의 웹사이트와 같은 다른 웹사이트 및 앱에 로그인할 수 있습니다 Google으로 로그인모든 앱에 대해 하나의 계정과 하나의 암호를 사용할 수 있으며, 사용자가 조직을 떠나면 더 이상 앱에 로그인할 수 없습니다. 연결된 앱 열기 설정, 그럼 보안,…
액세스가 있는 앱
조직 계정을 사용하여 회사 블로그, 대시보드 또는 교육 사이트와 같은 다른 웹 사이트 및 앱에 로그인할 수 있습니다. 처음 로그인할 때 앱이 볼 수 있는 내용을 묻고 사용자가 선택할 수 있습니다 허용 또는 허용하지 않음. 액세스가 있는 앱 허용한 모든 앱이 프로필에 나열됩니다. 사진을 열고 내 프로필 보기, 그리고 이동합니다 접근 이 카드는 자신의 프로필에 있는 사용자만 볼 수 있습니다.…
자동 프로비저닝
자동 프로비저닝을 사용하면 ID 공급자가 Kamo을 자동으로 최신 상태로 유지할 수 있습니다. 공급자에 추가된 사람은 Kamo에 나타나고, 해당 직함 또는 부서의 변경 사항은 그에 따라 나타나며, 공급자에서 제거된 사람은 Kamo에 종료됩니다 SCIM 프로토콜. 자동 프로비저닝 열기 설정, 그럼 보안, 선택 ID & 로그인, 그럼 프로비저닝당신이 필요해요 ID 공급자 관리 프로비저닝은 ID…
