หน้านี้เป็นสำหรับผู้พัฒนา การล็อกอินขององค์กรของคุณเป็นมาตรฐาน การเชื่อมต่อ OAuth 2. 0 และ OpenID ผู้จัดจำหน่าย ดังนั้น โปรแกรมหรือเครื่องมือใด ๆ ก็ตาม สามารถล็อกอินเข้าใช้บัญชีผู้ใช้ Kamo ของพวกเขาได้ และหากได้รับอนุญาตจากพวกเขา สามารถทำงานกับข้อมูลของ Kamo ผ่าน API และเซิร์ฟเวอร์ MCP ของ Kamo ได้ ไม่มีอะไรที่นี่ที่เฉพาะเจาะจงกับผู้จัดจำหน่ายหรือแอพพลิเคชันประเภทใด ๆ
ก่อนที่จะเริ่ม
- ผู้ดูแลระบบเปิด ตั้งค่าถ้างั้น ปลอดภัย, การแสดงตัวและเข้าใช้งาน, โปรแกรมที่เชื่อมต่อ, และเชื่อมต่อโปรแกรมของคุณ (ดูที่ เชื่อมต่อโปรแกรมพวกเขาจะได้รับ หมายเลขไคลเอนต์และสำหรับเวบไซต์ ไคลเอนต์ลับ, แสดงครั้งเดียว
- แอพของคุณอ่านทุกอย่างที่เหลือจาก ที่อยู่ค้นพบ บนบัตรของแอพฯ ตัวอย่างเช่น
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 สิทธิ์ที่จำเป็น (ใดๆก็ได้) |
|---|---|---|
| อ่านรายละเอียดของผู้ติดต่อ | แสดงที่อยู่ติดต่อ |
| สร้างผู้ติดต่อและแก้ไขรายละเอียดของพวกเขาName | สร้างผู้ติดต่อ, แก้ไขผู้ติดต่อ |
| อ่านเบาะแสที่คุณเห็น กับสถานะและประวัติของพวกเขา | แสดงตัวนำ |
| สร้างผู้นำ, แก้ไขพวกเขาและย้ายพวกเขาผ่านท่อ | สร้างผู้นำ, แก้ไขผู้นำ, ย้ายระดับผู้นำ |
| อ่านปฏิทินและเหตุการณ์ของมันName | แสดงปฏิทิน |
| สร้างและเปลี่ยนแปลงเหตุการณ์ในปฏิทินของคุณName | แสดงปฏิทิน |
| อ่านกล่องจดหมายที่คุณสามารถเปิดได้ใน Kamo | เข้าถึงจดหมาย |
| เขียนและส่งอีเมลจากกล่องจดหมายที่คุณสามารถใช้ได้Name | เข้าถึงจดหมาย |
| อ่านบันทึกและรายการตรวจสอบของคุณ | แสดงบันทึก, แสดงสิ่งที่จะทำ |
| สร้างและแก้ไขบันทึกและรายการตรวจสอบ | สร้างโน้ต, แก้ไขโน้ต |
| อ่านเอกสารและแฟ้มที่คุณสามารถเปิดได้ | แสดงเอกสาร |
| โหลดเอกสารและแก้ไขมัน | สร้างเอกสาร, แก้ไขเอกสาร |
| อ่านบทความฐานความรู้ขององค์กรของคุณ | แสดงบทความ 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
เซิร์ฟเวอร์ MCP Kamo อยู่ที่ https://api.yourcompany.com/mcpคลาวด์ MCP ทุกตัวที่รองรับการอนุญาต MCP สามารถเชื่อมต่อได้: เมื่อเรียกครั้งแรก มันจะได้รับ 401 ด้วย WWW-Authenticate ส่วนหัวชี้ไปยัง https://api.yourcompany.com/.well-known/oauth-protected-resource/mcpซึ่งจะตั้งชื่อการล็อกอินขององค์กรของคุณให้เป็นเซิร์ฟเวอร์การอนุญาตใช้งาน จากนั้นไคลเอนต์จะลงทะเบียนตัวมันเอง (หากอนุญาตให้ทำเช่นนั้น) หรือใช้หมายเลขไคลเอนต์ที่ผู้ดูแลระบบมอบให้คุณ ล็อกอินผู้ใช้ตามขั้นตอนด้านบน และส่ง Authorization: Bearer ACCESS_TOKEN เครื่องมือที่มันสามารถใช้ได้ ก็คือ เครื่องมือที่สิทธิ์ของผู้ใช้ และขอบเขตของโทเคนอนุญาตให้ใช้
ล็อกอินบนทีวีหรืออุปกรณ์
อุปกรณ์ที่ไม่มีแป้นพิมพ์จะใช้การล็อกอินของอุปกรณ์ (RFC 8628) โปรแกรมต้องการ ทีวีหรืออุปกรณ์ พิมพ์ หรือเปิดการล็อกอินของอุปกรณ์:
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 รออีก5วินาทีทุกครั้ง รหัสใช้ได้ 10 นาที
เมื่อใครบางคนออกไป
การลบสิทธิ์ในการเข้าถึงของผู้ใช้ใน Kamo จะทำลายโทเคนของเขา: API และเซิร์ฟเวอร์ MCP จะหยุดตอบสนองในทันที (ภายในหนึ่งนาที) และการปรับปรุงจะล้มเหลว ผู้ใช้ยังสามารถลบแอพพลิเคชันด้วยตนเองได้ใน โพรไฟล์ของฉัน, โปรแกรมที่มีสิทธิ์เข้าถึง.
บทความที่เกี่ยวข้อง
คำแนะนำอื่น ๆ ที่ตอบคำถามที่ใกล้เคียงกับนี้
เชื่อมต่อโปรแกรม
การเชื่อมต่อแอปพลิเคชันใช้เวลา7ขั้นตอน Open ตั้งค่าถ้างั้น ปลอดภัย, เลือก การแสดงตัวและเข้าใช้งานถ้างั้น โปรแกรมที่เชื่อมต่อ, และกด เชื่อมต่อโปรแกรมเธอต้องการ จัดการโปรแกรมที่เชื่อมต่อ ขออนุญาต…
ปล่อยให้โปรแกรมเชื่อมต่อด้วยตนเอง
โปรแกรมบางตัว เช่น AI ผู้ช่วยที่ใช้ MCP และเครื่องมือบรรทัดคำสั่ง สามารถเชื่อมต่อตัวเองกับการล็อกอินขององค์กรของคุณ แทนที่จะให้ผู้ดูแลระบบพิมพ์เข้าไป เรียกว่า การจดทะเบียนแบบอัตโนมัติมันคือ ปิดการใช้งาน…
โปรแกรมที่เชื่อมต่อ
แอพพลิเคชันที่เชื่อมต่อ ช่วยให้ผู้ใช้ของคุณสามารถเข้าใช้งานเว็บไซต์และแอพพลิเคชันอื่น ๆ ได้ เช่น WordPress, Grafana, Moodle, Nextcloud หรือเว็บไซต์ของคุณเอง โดยใช้บัญชีผู้ใช้ Kamo ที่พวกเขามีอยู่แล้ว มันทำงานเหมือนกัน…
โปรแกรมที่มีสิทธิ์เข้าถึง
องค์กรของคุณอาจจะอนุญาตให้คุณเข้าใช้งานเว็บไซต์และแอพพลิเคชันอื่น ๆ ด้วยบัญชีผู้ใช้ขององค์กรของคุณ เช่น บล๊อกของบริษัท, แดชบอร์ด หรือเว็บไซต์การฝึกอบรม ครั้งแรกที่คุณทำเช่นนี้ แอพพลิเคชันอาจจะถามว่า…
การจัดสรรอัตโนมัติ
การจัดสรรอัตโนมัติจะทำให้ผู้ให้บริการที่ระบุตัวตนของคุณปรับปรุง Kamo ด้วยตนเอง หากมีผู้ใช้ใหม่ถูกเพิ่มเข้าไปในผู้ให้บริการของคุณ จะปรากฏใน Kamo หากมีการเปลี่ยนแปลงตำแหน่งงานหรือแผนกของเขา จะปรากฏตามมา…
