Esta página es para desarrolladores. El inicio de sesión de su organización es un estándar OAuth 2.0 y OpenID Connect El servidor MCP es un proveedor, por lo que cualquier aplicación o herramienta puede iniciar sesión con sus Kamo cuentas y, con su permiso, trabajar con sus Kamo datos a través de la API y el servidor Kamo MCP.No hay nada aquí que sea específico de un proveedor o un tipo de aplicación.
Antes de empezar
- Un administrador abre Configuración, entonces Seguridad, Identidad & inicio de sesión, Aplicaciones conectadas, y conecta su aplicación (consulte Conectar una aplicación). Se les da un ID de cliente, y para un sitio web a El cliente secreto, mostrado una vez.
- Su aplicación lee todo lo demás desde el Dirección de descubrimiento en la tarjeta de la aplicación, por ejemplo
https://login.yourcompany.com/.well-known/openid-configuration. Las organizaciones sin su propia dirección web tienen una comohttps://login.kamouniverse.com/o/<organization number>/.well-known/openid-configuration. Todas las demás direcciones de esta página comienzan con esa misma letra emisor.
Permisos (ámbito de aplicación)
Una aplicación pide permisos con scope. Los permisos de inicio de sesión son openid (siempre es necesario), profile, email, phone, kamo.org, kamo.roles y offline_access (permanecer conectado con un token de actualización).
Los siguientes permisos de datos permiten que una aplicación use la API en nombre de otra persona, y cada uno representa Kamo permisos que la persona ya tiene. Una aplicación nunca puede hacer más de lo que la persona podría hacer en Kamo ellos mismos: cuando se emite un token, solo lleva los permisos de datos cuyos Kamo permisos tiene la persona en ese momento, y cada llamada se comprueba de nuevo con lo que tiene en ese momento.La eliminación nunca está disponible para una aplicación.
A. Alcance | Lo que permite | Kamo permiso que necesita (cualquiera de) |
|---|---|---|
| Leer contactos y sus detalles | Ver los contactos |
| Crear contactos y editar sus datos | Crear contactos, editar contactos |
| Lee los leads que puedes ver, con su estado e historial | Ver los Leads |
| Crear clientes potenciales, editarlos y moverlos a través del embudo | Crear clientes potenciales, editar clientes potenciales, mover la etapa de clientes potenciales |
| Leer el calendario y sus eventos | Ver el calendario |
| Crear y cambiar eventos en el calendario | Ver el calendario |
| Lee los buzones que puedes abrir en Kamo | Acceder al correo |
| Escribe y envía correos desde los buzones que puedes usar | Acceder al correo |
| Lee tus notas y listas de comprobación | Ver notas, ver tareas |
| Crear y editar notas y listas de comprobación | Crear notas, editar notas |
| Leer los documentos y archivos que puede abrir | Ver los documentos |
| Sube documentos y edítalos | Crear documentos, editar documentos |
| Lea los artículos de la base de conocimientos de su organización | Ver artículos de KB |
| Crear y editar artículos de la base de conocimientos | Crear artículos de la KB, editar artículos de la KB |
| Lee tus reuniones y sus detalles | Ver las reuniones |
| Programar, cambiar e iniciar reuniones | Iniciar reunión, Gestionar reuniones |
La misma lista, siempre actualizada, está en https://api.<your domain>/api/security/oidc/scopes. A write Este permiso también permite a la aplicación leer el mismo tipo de datos.
Una aplicación solo puede solicitar los permisos que se le han otorgado, que el administrador elige al conectar la aplicación: los de inicio de sesión bajo Lo que puede ver, los datos de los que se trata Trabajar con Kamo datos, uno See y uno Cambio Cambiar por tipo de datos, cada uno mostrando el Kamo Pídales que enciendan exactamente los alcances que usted solicite; pedir uno que no se le haya dado a la aplicación fallará con la mayoría de las aplicaciones invalid_scope.
Iniciar sesión de alguien (código de autorización con PKCE)
Envíe el navegador de la persona a la dirección de autorización con un desafío 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=S256Inician sesión, ven lo que su aplicación solicita en palabras sencillas y presionan Permitir. Su dirección de redirección recibe code, state y iss. Intercambiar el código por fichas:
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_VERIFIERAplicaciones que no pueden mantener un secreto (de una sola página, móviles, de escritorio, de línea de comandos) client_id=YOUR_CLIENT_ID en lugar de -u. La respuesta tiene access_token (un token al portador), id_token (quien firmó), refresh_token (solo con offline_access) y scope (lo que el token realmente lleva).
Llame a la API
Envíe el token de acceso a la dirección de API de su organización:
curl https://api.yourcompany.com/api/contacts -H "Authorization: Bearer ACCESS_TOKEN"- 401 con
WWW-Authenticate: Bearer error="invalid_token": el token ha caducado, se ha revocado o la persona ya no tiene acceso, actualícelo o vuelva a iniciar sesión. - 403 con
error="insufficient_scope", scope="contacts.write": el token no tiene el permiso que necesita la dirección, pídelo al iniciar sesión. - Reading (
GET) necesita elreadcualquier cosa que cambie las necesidades de los datoswrite.
Deje que su aplicación se registre por sí misma
Si un administrador ha activado Deja que las aplicaciones se conecten a sí mismas (ver ese artículo), una aplicación puede registrarse sin que nadie la escriba, utilizando la solicitud de registro estándar (RFC 7591).La dirección está en el documento de descubrimiento como 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 respuesta está en ti client_id (y un client_secret para las aplicaciones que mantienen uno) y kamo_status. PENDING significa que un administrador debe aprobarlo en Aplicaciones conectadas antes de que cualquiera pueda iniciar sesión; hasta entonces, al iniciar sesión se muestra "Esta aplicación está esperando aprobación" 404.
Conectar un AI asistente o cliente MCP
El servidor Kamo MCP está en https://api.yourcompany.com/mcpCualquier cliente MCP que admita la autorización MCP puede conectarse: en su primera llamada obtiene 401 con un WWW-Authenticate Encabezado apuntando a https://api.yourcompany.com/.well-known/oauth-protected-resource/mcpA continuación, el cliente se registra a sí mismo (si está permitido) o utiliza un ID de cliente que le ha proporcionado el administrador, inicia sesión en la persona como se ha indicado anteriormente y envía un mensaje de error al servidor de autorización Authorization: Bearer ACCESS_TOKEN Las herramientas que puede usar son exactamente las que permiten los permisos de la persona y los alcances del token.
Iniciar sesión en un televisor o dispositivo
Los dispositivos sin teclado utilizan el inicio de sesión del dispositivo (RFC 8628) TV o dispositivo Escriba, o el inicio de sesión del dispositivo está activado:
curl -X POST https://login.yourcompany.com/oauth/device_authorization -d client_id=YOUR_CLIENT_ID -d "scope=openid profile"Muéstrele a la persona user_code (como WDJB-MJHT) y el verification_uri, luego sondee cada interval segundos:
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_IDSigue encuestando mientras la respuesta es authorization_pending; uno slow_down Espere 5 segundos más cada vez. El código dura 10 minutos.
Cuando alguien se va
Al quitar el acceso de una persona en Kamo, se terminan sus tokens: la API y el servidor MCP dejan de responder por ellos de inmediato (dentro de un minuto), y la actualización falla Ver mi perfil, Aplicaciones con acceso.
Otros artículos relacionados
Otras guías que responden preguntas similares a esta.
Conectar una aplicación
Conectar una aplicación requiere siete pasos cortos. Abrir Configuración, entonces Seguridad, elija Identidad & inicio de sesión, entonces Aplicaciones conectadas, y pulse Conectar una aplicación. Usted necesita el…
Deja que las aplicaciones se conecten a sí mismas
Algunas aplicaciones, como AI asistentes que usan MCP y herramientas de línea de comandos, pueden conectarse a sí mismos al inicio de sesión de tu organización en lugar de que un administrador los escriba Registro…
Aplicaciones conectadas
Las aplicaciones conectadas permiten a tus usuarios iniciar sesión en otros sitios web y aplicaciones, como WordPress, Grafana, Moodle, Nextcloud o tu propio sitio web, con la cuenta Kamo que ya tienen Iniciar sesión…
Aplicaciones con acceso
Su organización puede permitirle iniciar sesión en otros sitios web y aplicaciones con su cuenta de organización, como un blog de la empresa, paneles de control o un sitio de capacitación.La primera vez que lo haga, la…
Aprovisionamiento automático
El aprovisionamiento automático permite que tu proveedor de identidades mantenga Kamo actualizado por sí solo. Cuando alguien se agrega a tu proveedor, aparece en Kamo, un cambio en su cargo o departamento le sigue y…
