Questa pagina è destinata agli sviluppatori. L'accesso dell'organizzazione è uno standard OAuth 2.0 e OpenID Connect Il tuo fornitore di servizi di cloud è il tuo fornitore di servizi di cloud, quindi qualsiasi app o strumento può accedere ai tuoi utenti con i loro Kamo account e, con il loro permesso, lavorare con i loro Kamo dati tramite l'API e il server Kamo MCP.
Prima di iniziare
- Si apre un amministratore Impostazioni, allora Sicurezza, Identità & accesso, Le app connesse, e collega la tua app (vedi Collegare un'app). Ottengono un ID del cliente, e per un sito web a Il cliente segreto, mostrato una volta.
- La tua app legge tutto il resto dal Indirizzo di scoperta Sulla scheda dell'app, ad esempio
https://login.yourcompany.com/.well-known/openid-configuration. Le organizzazioni senza un proprio indirizzo web ne hanno uno comehttps://login.kamouniverse.com/o/<organization number>/.well-known/openid-configuration. Ogni altro indirizzo in questa pagina inizia con lo stesso emittente.
Autorizzazioni (ambiti di applicazione)
Un'app chiede autorizzazioni con scope. Le autorizzazioni di accesso sono openid (sempre necessario), profile, email, phone, kamo.org, kamo.roles e offline_access (resta connesso con un token di aggiornamento).
Le autorizzazioni per i dati riportate di seguito consentono a un'app di utilizzare l'API per conto di un utente, ognuna delle quali rappresenta Kamo autorizzazioni di cui la persona già dispone. Un'app non può mai fare più di quanto la persona potrebbe fare in Kamo se stessa: quando viene emesso un token, esso contiene solo i permessi relativi ai dati di cui la persona detiene Kamo permessi in quel momento, e ogni chiamata viene controllata nuovamente in base a ciò che detiene in quel momento.
Ambito di applicazione | Cosa permette | Kamo autorizzazioni di cui ha bisogno (qualsiasi) |
|---|---|---|
| Leggere i contatti e i loro dettagli | Visualizza i contatti |
| Creare contatti e modificare i loro dettagli | Creare contatti, modificare contatti |
| Leggi i lead che puoi vedere, con il loro stato e la loro cronologia | Visualizza i Leads |
| Crea lead, modificali e spostali attraverso la pipeline | Creare lead, modificare i lead, spostare la fase dei lead |
| Leggi il tuo calendario e i suoi eventi | Visualizza il calendario |
| Creare e modificare eventi nel calendario | Visualizza il calendario |
| Leggi le caselle di posta che puoi aprire in Kamo | Accesso alla posta |
| Scrivere e inviare e-mail dalle caselle di posta che si possono utilizzare | Accesso alla posta |
| Leggere le note e le liste di controllo | Visualizza note, visualizza attività |
| Creare e modificare note ed elenchi di controllo | Creare note, modificare note |
| Leggere i documenti e i file che è possibile aprire | Visualizza i documenti |
| Carica i documenti e modificali | Creare documenti, modificare documenti |
| Leggi gli articoli della knowledge base della tua organizzazione | Visualizza KB Articoli |
| Creare e modificare gli articoli della Knowledge Base | Creare articoli KB, modificare articoli KB |
| Leggi i tuoi incontri e i loro dettagli | Vedi gli incontri |
| Pianificare, modificare e avviare riunioni | Avviare riunioni, gestire riunioni |
La stessa lista, sempre attuale, si trova a https://api.<your domain>/api/security/oidc/scopes. A write Questa autorizzazione consente inoltre all'app di leggere lo stesso tipo di dati.
Un'app può richiedere solo le autorizzazioni che le sono state concesse, che vengono scelte dall'amministratore quando si connette l'app: Cosa può vedere, i dati sottostanti Lavora con Kamo dati, uno Vedi E uno Cambia per tipo di dati, ognuno dei quali mostra il Kamo Chiedete loro di attivare esattamente gli ambiti che avete richiesto; chiedendone uno all'app non è stato dato con successo invalid_scope.
Accedi a qualcuno (codice di autorizzazione con PKCE)
Invia il browser della persona all'indirizzo di autorizzazione con una sfida 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=S256Eseguono l'accesso, vedono ciò che la tua app chiede in parole semplici e premono Consenti. Il tuo indirizzo di reindirizzamento riceve code, state e iss. Scambia il codice per i gettoni:
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_VERIFIERApp che non possono mantenere un segreto (pagina singola, mobile, desktop, riga di comando) client_id=YOUR_CLIENT_ID Al posto di -u. La risposta è access_token (un token portatore), id_token (che ha firmato), refresh_token (solo con offline_access) e scope (quello che il gettone porta realmente).
Chiamare l'API
Invia il token di accesso all'indirizzo API della tua organizzazione:
curl https://api.yourcompany.com/api/contacts -H "Authorization: Bearer ACCESS_TOKEN"- 401 con
WWW-Authenticate: Bearer error="invalid_token": il token è scaduto, è stato revocato o la persona non ha più accesso.Aggiornalo o accedi di nuovo. - 403 con
error="insufficient_scope", scope="contacts.write": il token non contiene l'autorizzazione di cui l'indirizzo ha bisogno. Chiedilo al momento dell'accesso. - Lettura (
GET) ha bisogno delreadPermesso di quel tipo di dati; tutto ciò che cambia le esigenze dei datiwrite.
Lascia che la tua app si registri da sola
Se un amministratore ha attivato Lascia che le app si connettano da sole (vedere l'articolo), un'app può registrarsi senza che nessuno la digiti, utilizzando la richiesta di registrazione standard (RFC 7591).L'indirizzo è nel documento di scoperta come 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" }'La risposta è la tua client_id (e un client_secret per le applicazioni che mantengono uno) e kamo_status. IN ATTESA Significa che un amministratore deve approvarla in Connected Apps prima che chiunque possa accedere; fino a quel momento l'accesso mostra "Questa app è in attesa di approvazione" 404.
Connetti un AI assistente o un client MCP
Il server MCP Kamo si trova a https://api.yourcompany.com/mcpQualsiasi client MCP che supporta l'autorizzazione MCP può connettersi: alla sua prima chiamata ottiene 401 con un WWW-Authenticate Intestazione che punta a https://api.yourcompany.com/.well-known/oauth-protected-resource/mcpIl client quindi si registra (se consentito) o utilizza un ID client fornito dall'amministratore, effettua l'accesso della persona come sopra e invia un messaggio di errore al server di autorizzazione Authorization: Bearer ACCESS_TOKEN Gli strumenti che può usare sono esattamente quelli che le autorizzazioni della persona e gli ambiti del token consentono.
Accedi su una TV o un dispositivo
I dispositivi senza tastiera utilizzano l'accesso al dispositivo (RFC 8628) TV o dispositivo Digitare o attivare l'accesso al dispositivo:
curl -X POST https://login.yourcompany.com/oauth/device_authorization -d client_id=YOUR_CLIENT_ID -d "scope=openid profile"Mostra alla persona il user_code (come WDJB-MJHT) e il verification_uri, quindi sondare ogni interval secondi:
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_IDContinua a sondare finché la risposta è authorization_pending; on slow_down Attendere 5 secondi in più ogni volta. Il codice dura 10 minuti.
Quando qualcuno se ne va
La rimozione dell'accesso di una persona in Kamo termina i suoi token: l'API e il server MCP smettono di rispondere immediatamente (entro un minuto) e l'aggiornamento non riesce Il mio profilo, App con accesso.
Gli articoli correlati
Altre guide che rispondono a domande simili a questa.
Collegare un'app
La connessione di un'app richiede sette brevi passaggi. Apri Impostazioni, allora Sicurezza, scegliere Identità & accesso, allora Le app connesse, e premere Collegare un'app. Hai bisogno del Gestire le app connesse Con…
Lascia che le app si connettano da sole
Alcune app, come AI assistenti che utilizzano MCP e strumenti della riga di comando, possono connettersi automaticamente all'accesso dell'organizzazione invece che essere digitati da un amministratore Registrazione…
Le app connesse
Le App connesse consentono ai tuoi utenti di accedere ad altri siti web e app, come WordPress, Grafana, Moodle, Nextcloud o il tuo sito web, con l'account Kamo che già hanno Accedi con GoogleUn account e una password…
App con accesso
L'organizzazione può consentire di accedere ad altri siti Web e app con l'account dell'organizzazione, ad esempio un blog aziendale, dashboard o un sito di formazione.La prima volta che lo fai, l'app potrebbe chiedere…
Provisioning automatico
Il provisioning automatico consente al tuo provider di identità di mantenere Kamo aggiornato da solo. Quando qualcuno viene aggiunto al tuo provider, viene visualizzato Kamo, una modifica del titolo o del reparto viene…
