Bu sayfa geliştiriciler içindir. Kuruluşunuzun girişi standarttır OAuth 2.0 ve OpenID Bağlantı Bu, herhangi bir uygulama ya da araç sizin insanlarınızın kendi Kamo hesaplarıyla giriş yapabilmeleri ve izinleriyle API ve Kamo MCP sunucusu aracılığıyla kendi Kamo verileriyle çalışabilmeleri içindir. Burada hiçbir şey bir satıcıya veya bir uygulama türüne özgü değildir.
Başlamadan Önce
- Bir yönetici açılır Ayarları, o zaman Güvenlik, Kimlik ve Giriş, Bağlantılı Uygulamalar, ve uygulamanıza bağlanır (bkz Bir Uygulama BağlaOnlar bir şey alır istemci IDVe bir web sitesi için gizli istemci, bir kez gösterildi.
- Uygulaman diğer her şeyi okuyor keşif adresi uygulamanın kartında, örneğin
https://login.yourcompany.com/.well-known/openid-configurationKendi web adresi olmayan kuruluşlar şu şekilde bir adresi vardır:https://login.kamouniverse.com/o/<organization number>/.well-known/openid-configurationBu sayfadaki diğer adresler de aynı şekilde başlıyor yayımcı.
İzinler (Kapsamlar)
Bir uygulama aşağıdaki izinleri istiyor scopeGiriş izinleri şu şekildedir: openid (her zaman gerekli), profile, email, phone, kamo.org, kamo.roles ve offline_access (yenileme işareti ile bağlantılı kalın).
Aşağıdaki veri izinleri, bir uygulamanın API'yi birisi adına kullanmasına izin verir. Her biri, kişinin zaten sahip olduğu Kamo izini temsil eder. Bir uygulama, kişinin Kamo içinde kendisinin yapabileceğinden daha fazlasını asla yapamaz: bir işaret çıkarıldığında sadece kişinin o anda sahip olduğu Kamo izinlerin veri izinlerini taşır ve her çağrı o anda sahip oldukları izinlerle karşılaştırılır. Silme bir uygulama için asla mevcut değildir.
Kapsam | Neye izin veriyor? | Kamo izine ihtiyacı var (herhangi biri) |
|---|---|---|
| Kişiler ve onların ayrıntılarını oku | Kişileri Göster |
| Kişileri oluştur ve ayrıntılarını düzenleName | Kişiler Yarat, Kişileri Düzenle |
| Görebileceğiniz yolları, durumları ve geçmişleriyle birlikte okuyun | Öncüleri Göster |
| İlişkiler oluşturun, düzenleyin ve boru hattında taşıyınName | İlişkiler Yarat, İlişkileri Düzenle, İlişki Sahnesini Taşıştır |
| Takviminizi ve olasılıkları okuyunName | Takvim Göster |
| Takviminizdeki olayları oluştur ve değiştir | Takvim Göster |
| Kamo'de açacağınız posta kutularını oku | E-posta erişimi |
| Kullanacağınız posta kutularından e-posta yazın ve gönderin | E-posta erişimi |
| Notlarınızı ve kontrol listelerini okuyun | Notları Gör, Görevleri Gör |
| Notlar ve kontrol listeleri oluşturun ve düzenleyin | Notlar Yarat, Notları Düzenle |
| Açabileceğiniz belge ve dosyaları oku | Belgeleri Gör |
| Belgeleri yükle ve düzenle | Belge Yarat, Belge Düzenle |
| Kuruluşunuzun bilgi tabanını okuyun | KB Makalelerini Göster |
| Bilgi tabanlı makaleler oluştur ve düzenle | KB Makaleleri Yarat, KB Makaleleri Düzenle |
| Toplantılarınızı ve bunların ayrıntılarını oku | Toplantıları Göster |
| Toplantıları planla, değiştir ve başlat | Toplantıyı Başlat, Toplantıyı Yönet |
Aynı liste, her zaman güncel, şurada https://api.<your domain>/api/security/oidc/scopes- Evet, evet write Bu izin aynı zamanda uygulamanın aynı tür veriyi okumasına izin veriyor.
Bir uygulama sadece ona verilen izinleri isteyebilir. Yöneticinizin bu izinleri uygulama bağlandığında seçtiğini unutmayın: aşağıdaki giriş izinleri Gördüğü şeyler, veriler altındakiler Kamo Veriyle Çalış, bir Bak Ve bir... Değiştir veri türüne göre geçiş yap, her biri ihtiyacı olan Kamo izni gösterir. İstediğiniz alanları tam olarak açmalarını isteyin; uygulamaya verilmemiş olan bir alan için istemek şuyla başarısız olur: invalid_scope.
Birisini Giriş Et (PKCE ile Yetkilendirme Kodu)
Kişinin tarayıcısını kimlik doğrulama adresine bir PKCE meydan okuması ile gönder:
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=S256Giriş yapıyorlar, uygulamanızın ne istediğini açık sözlü olarak görüyorlar ve "Kayıt Ol" butonuna basıyorlar İzin VerGeri yönlendirme adresiniz code, state ve issKodları sembollerle değiştirin:
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_VERIFIERSır tutmayan uygulamalar (tek sayfa, mobil, masaüstü, komut satırı) gönder client_id=YOUR_CLIENT_ID yerine -uCevap var access_token Bir işaret taşıyıcıdır id_token (İmza atanlar), refresh_token (yalnızca offline_accessve scope (Sembolün gerçekten taşıdığı şey).
API'yi Çağır
Erişim tokenini kuruluşunuzun API adresine gönderin:
curl https://api.yourcompany.com/api/contacts -H "Authorization: Bearer ACCESS_TOKEN"- 401 ile
WWW-Authenticate: Bearer error="invalid_token": token süresi doldu, iptal edildi veya kişinin artık erişimi yok. Lütfen yenileyin veya tekrar giriş yapın. - 403 ile
error="insufficient_scope", scope="contacts.write": token adresin ihtiyacı olan izinleri taşımıyor. Giriş esnasında isteyin. - Reading (İngilizce)
GET) ihtiyacı varreadBu tür verilerin izinleri; veri ihtiyaçlarını değiştiren herhangi bir şeywrite.
Uygulamanın kendisini kaydetmesine izin ver
Eğer bir yönetici etkinleştirdiyse Uygulamaların Bağlanmasını İzinle (o makaleye bakınız), bir uygulama, standart kayıt talebini (RFC 7591) kullanarak, herhangi biri kayıt olmadan kayıt olabilir. Adres, keşif belgesinde aşağıdaki gibidir: 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" }'Cevap senin client_id (ve bir client_secret bir tane tutan uygulamalar için) ve kamo_status. Bekleniyor Bu, herhangi biri giriş yapmadan önce Bağlantılı Uygulamalar'da bir yöneticinin bunu onaylaması gerektiği anlamına gelir; o zamana kadar giriş "Bu uygulama onayı bekliyor" gösterir. Kayıt kapatılınca adres cevaplar 404.
Bir AI Yardımcı ya da MCP İstemcisi Bağla
Kamo MCP sunucusu şuradadır https://api.yourcompany.com/mcp. MCP yetkilendirmesini destekleyen herhangi bir MCP istemcisi bağlanabilir: ilk çağrısında 401 ile WWW-Authenticate başlık şuna işaret ediyor https://api.yourcompany.com/.well-known/oauth-protected-resource/mcp, bu da organizasyonunuzun girişini yetkilendirme sunucusu olarak adlandırır. Sonra istemci kendisini kayıt eder (eğer izin verilirse) veya yöneticinin size verdiği bir istemci ID' si kullanır, kişiyi yukarıdaki gibi kayıt eder ve Authorization: Bearer ACCESS_TOKEN Kullandığı araçlar tam olarak kişinin izinleri ve token'ın kapsamı tarafından izin verilenler.
Bir TV veya Aygıtta Giriş Yap
Klavyesi olmayan cihazlar cihaz girişini kullanır (RFC 8628). Uygulama aşağıdakileri gerektirir: Televizyon ya da Aygıt yazın, ya da aygıt girişi etkinleştirilsin:
curl -X POST https://login.yourcompany.com/oauth/device_authorization -d client_id=YOUR_CLIENT_ID -d "scope=openid profile"Göster o kişiye user_code (Mesela WDJB-MJHT) ve verification_uri, sonra her interval saniyeler:
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_IDCevap "Evet" oluncaya kadar oylamaya devam edin authorization_pending; on slow_down Her seferinde 5 saniye daha bekleyin.
Birisi ayrıldığında
Bir kişinin erişimini kaldırmak Kamo bir dakika içinde) ve güncelleme başarısız olur. İnsanlar aynı zamanda bir uygulamayı kendileri de kaldırabilirler Profilim, Erişimi Olan Uygulamalar.
İlgili makaleler
Buna benzer sorulara cevap veren diğer rehberler.
Bir Uygulama Bağla
Bir uygulamayı bağlamak yedi kısa adım alır. Aç Ayarları, o zaman Güvenlik, seç Kimlik ve Giriş, o zaman Bağlantılı Uygulamalar, ve basın Bir Uygulama Bağlaİhtiyacın var Bağlantılı Uygulamaları Yönet İzin verin. Hiçbir…
Uygulamaların Bağlanmasını İzinle
MCP ve komut satırı araçlarını kullanan AI asistanları gibi bazı uygulamalar, yöneticinin onları yazması yerine kendileri örgütünüzdeki girişe bağlanabilir. Buna "%s" denir dinamik kayıtEvet, öyle Kapalı Sen açmazsan.…
Bağlantılı Uygulamalar
Bağlantılı Uygulamalar, WordPress, Grafana, Moodle, Nextcloud veya kendi web siteniz gibi diğer web sitelerine ve uygulamalara, sahip oldukları Kamo hesabı ile giriş yapmalarını sağlar. Bu şöyle çalışır: Google ile…
Erişimli Uygulamalar
Örgütünüz, şirket blogu, kontrol paneli veya eğitim sitesi gibi diğer web sitelerine ve uygulamalarına örgüt hesabınızla giriş yapmanızı sağlayabilir. İlk kez giriş yaptığınızda, uygulama ne göreceğini sorabilir ve siz…
Otomatik Yapılandırma
Otomatik temin, kimlik sağlayıcınızın Kamo'yi kendiliğinden güncel tutmasına izin verir. Tedarikçinize eklenen birisi Kamo'de görüntülenir, görevi veya departmanındaki bir değişiklik onları takip eder ve tedarikçinizden…
