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 Administrar aplicaciones conectadas Permiso.
Nada se guarda hasta que Conectar la aplicación En el paso 6, y nadie se ve afectado hasta que alguien inicia sesión en la aplicación.
Conectar una aplicación
A la derecha de los pasos 2, 4 y 6, verás una imagen de la página que verán los usuarios la primera vez que inicien sesión, basada en las opciones que hayas elegido.
Paso 1: Elige lo que vas a conectar
Elige el producto: WordPress, Grafana, Discurso, Moodle, Nextcloud, Mattermost, Zapier o MarcaKamo entonces conoce su dirección de retorno, los permisos que normalmente necesita y los pasos exactos para terminar en ella.
¿No está en la lista? Elegir Sitio web personalizado para un sitio web con su propio servidor, Aplicación de página única para una aplicación web que se ejecuta en el navegador (React, Vue, etc.), Aplicación de móvil para iPhone, Android o una aplicación de escritorio, TV o dispositivo para un televisor, una pantalla de sala de reuniones o una herramienta de línea de comandos, o Aplicación de SAML Para una aplicación que inicia sesión con inicio de sesión único SAML. Servicio de Back-End, para un programa que inicia sesión como él mismo, vendrá más adelante.
Una aplicación de TV o dispositivo y una aplicación SAML siguen pasos ligeramente diferentes, que se describen a continuación.
Paso 2: Nombre y logotipo
El nombre y el logotipo que los usuarios ven en las páginas de inicio de sesión y de permisos, para que sepan qué aplicación está solicitando permisos. El logotipo es opcional: proporciona la dirección https:// de una imagen cuadrada o déjalo en blanco para usar la marca propia del producto.
Paso 3: Direcciones de devolución
Después de que alguien inicia sesión, Kamo lo envía de vuelta a la aplicación, pero solo a una de las direcciones que aparecen aquí, comparadas letra por letra, lo que evita que alguien pretenda ser tu aplicación y atrape un inicio de sesión en el camino.
Las direcciones deben comenzar con https://. Las aplicaciones móviles y de escritorio también pueden usar su propia dirección, como com.yourcompany.app:/callback, o http://127.0.0.1 en cualquier puerto.
Dirección de su sitio
Para WordPress, Grafana, Discourse, Moodle, Nextcloud y Mattermost, escribe la dirección que usan las personas para llegar al producto, por ejemplo https://blog.yourcompany.com. Kamo Para Make no hay nada que escribir. Para Make no hay nada que escribir Zapier, un sitio web personalizado, una aplicación de una sola página o una aplicación móvil, pega la dirección de retorno que te proporciona la aplicación o el desarrollador.
Puede agregar más direcciones, por ejemplo, para una copia de prueba del sitio.
Direcciones de salida
Bajo Más ajustes de cierre de sesión: a dónde pueden ser enviadas las personas después de cerrar sesión a través de la aplicación. Déjalo en blanco si la aplicación no cierra la sesión de Kamo.Para Grafana, Kamo lo rellena por ti.
Notificaciones de cierre de sesión
También bajo Más ajustes de cierre de sesión, para sitios web: cuando alguien cierra sesión en Kamo, Kamo puede indicarlo a la aplicación en esta dirección para que también cierre la sesión de esa persona Salida de back-channel; la mayoría no, y está bien dejarlo vacío.
Iniciar sesión en un televisor o dispositivo
En la parte inferior del paso 3, para un sitio web, una aplicación de una sola página o una aplicación móvil: activa Iniciar sesión en un televisor o dispositivo Para permitir que las personas también inicien sesión en la misma aplicación en un televisor, una pantalla o una herramienta de línea de comandos, apruebe un código corto en su teléfono.Omita esta opción a menos que el desarrollador de la aplicación se lo pida Iniciar sesión en un televisor o dispositivo por lo que la gente ve.
Cómo la aplicación envía su secreto
Para los sitios web: cómo la aplicación demuestra quién es cuando recopila un inicio de sesión Básico, a menos que las instrucciones de la aplicación digan "publicación secreta del cliente".
Paso 4: Lo que la aplicación puede ver
Cada interruptor es una cosa que la aplicación puede aprender sobre la persona que inicia sesión:
- Iniciar sesión: que sea la misma persona cada vez. Siempre encendido.
- Nombre y perfil: su nombre, nombre de usuario, zona horaria e idioma.
- Correo electrónicoLa mayoría de las aplicaciones lo necesitan para reconocer a las personas que ya tienen una cuenta allí.
- Teléfono: el número de teléfono en su perfil.
- Organización: a qué organización pertenecen, y si son parte de su equipo o un cliente.
- Funciones y equipos: sus funciones, departamento, cargo y equipos, para que la aplicación pueda darles el acceso correcto.
- Manténgase conectado: la aplicación puede seguir funcionando para ellos cuando están fuera, hasta que se les retire el acceso. Zapier, Hacer y aplicaciones móviles lo necesitan.
Las personas ven esta lista la primera vez que inician sesión en la aplicación, por lo que debes darle solo lo que necesita.
Trabajar con Kamo datos
Bajo los permisos de inicio de sesión, Trabajar con Kamo datos Permite a la aplicación leer o cambiar Kamo datos de la persona que inició sesión, a través de la Kamo API o un AI asistente.Es opcional; la mayoría de las aplicaciones que solo inician sesión no necesitan esto.Cada tipo de datos (contactos, clientes potenciales, calendario, correo electrónico, notas y listas de comprobación, documentos, la base de conocimientos y reuniones) tiene un nombre de usuario y una contraseña See Interruptor y un Cambio y cada uno dice qué Kamo permiso necesita una persona, por ejemplo Necesidades Ver contactos.
- Una aplicación nunca puede hacer más de lo que la persona podría hacer en Kamo.Alguien sin el permiso simplemente no le da a la aplicación esa parte, y nada se rompe.
- Si alguien pierde un Kamo permiso más tarde, la aplicación también lo pierde.
- Una aplicación nunca puede borrar nada.
Los desarrolladores encontrarán la lista completa de estos permisos, con sus nombres técnicos, en Cree una aplicación en el inicio de sesión de su organización.
Aplicaciones de TV o dispositivo
A/HRC/WG.1/WG.2/WP.29 TV o dispositivo La aplicación no tiene direcciones de retorno: nadie escribe una contraseña en el dispositivo, muestra un código corto y una dirección; la persona abre la dirección en su teléfono u ordenador, comprueba el código y pulsa Permitir, y el dispositivo termina de iniciar sesión por sí mismo. Su paso 3 es Cómo se inicia sesión, que muestra la dirección en la que la gente escribe el código.
Las personas siempre ven la pantalla de verificación de código, incluso para una aplicación que aprueba previamente, por lo que nadie puede ser engañado para aprobar un dispositivo que no tiene.
¿Puede el dispositivo mantener un secreto?
La mayoría de los televisores y las herramientas de línea de comandos no pueden mantener una caja fuerte secreta, porque cualquier persona con el dispositivo podría leerla No, no puede Para aquellos. Elegir Sí, en el encabezado (o Sí, en la forma, si el software del dispositivo dice "publicación secreta del cliente") solo para un dispositivo que controles y que almacene un secreto de forma segura.
Aplicaciones de SAML
A/HRC/WG.1/WG.2/WP.29 Aplicación de SAML Tiene su Configuración de SAML Copia lo que necesita de la página de configuración de SAML o de inicio de sesión único de la propia aplicación:
- Escriba los detalles: la aplicación ID de entidad (también llamado Audiencia, Emisor o ID de Entidad de SP) y su Dirección de respuesta (URL de ACS), que debe comenzar con https://. Puedes añadir hasta diez.
- O Pegar los metadatos de la aplicación (ver más abajo).
- Identificar a las personas por: Dirección de correo electrónico (lo que la mayoría de las aplicaciones quieren), Persistente, No especificado o Transient.
- Atributos: los datos que recibe la aplicación, cada uno bajo el nombre que espera la aplicación.Nuevas aplicaciones envían correo electrónico, nombre, apellido y nombre de pantalla.
- Firmar la respuesta completa (en) y Se puede abrir desde un lanzador de aplicaciones (apagado), abajo.
Quién puede usarla, y preguntar primero o pre-aprobar, funcionan como para cualquier aplicación.El último paso muestra qué darle a la aplicación; vea Utilice su organización como proveedor de identidad SAML.
Pegar los metadatos de la aplicación
Muchas aplicaciones ofrecen su configuración SAML como un archivo de metadatos o texto XML.Pega todo y Kamo lee el ID de entidad, las direcciones de respuesta y el certificado de firma de la aplicación de él.Cuando cambies una aplicación más tarde, deja el cuadro en blanco para mantener lo que tiene.
Identificar a las personas por
Lo que la aplicación recibe como identificador de la persona. Dirección de correo electrónico es el correo electrónico de la persona; Persistente es un número que nunca cambia para esa persona y esa aplicación; No especificado envía el correo electrónico para las aplicaciones que no les importa el formato; Transient Es un nuevo número en cada inicio de sesión.
Atributos
Cada fila es un hecho que la aplicación recibe: Nombre en la aplicación (sin espacios, exactamente como dice la documentación de la aplicación) y Lo que lleva (correo electrónico, nombre, apellido o nombre completo, número de miembro, departamento, cargo, funciones, equipos o nombre de su organización). Volver a los cuatro habituales Restaura los valores predeterminados.
Firmar la respuesta completa
Cada Kamo que se envía al iniciar sesión se firma. Con esta opción activada, toda la respuesta también se firma, lo que la mayoría de las aplicaciones esperan.
Se puede abrir desde un lanzador de aplicaciones
Por lo general, las personas comienzan en la aplicación, que las envía a Kamo para iniciar sesión.Activa esto para permitir que las personas abran la aplicación desde un enlace o un iniciador en su lugar, utilizando su Dirección de lanzamiento, y elija un Página de aterrizaje predeterminada Deja esta opción desactivada a menos que la documentación de la aplicación te lo pida.
Paso 5: Quién puede usarlo
Para tu equipo, elige Todo el mundo, Algunas personas o Nobody. With Algunas personas, elegir departamentos, cargos y equipos, y añadir personas por nombre; alguien puede usar la aplicación si coinciden con cualquiera de ellos.
Clientes
Los clientes son las personas a las que su organización presta servicios y que no forman parte de su equipo, como los prestatarios o los pacientes No hay clientes. Elegir una opción Para todos los clientes o Algunos de los clientes para una aplicación pensada para ellos, como un portal de clientes.
Paso 6: Pregunte primero o apruebe previamente
Pregúntale a cada persona primero Muestra a las personas lo que la aplicación aprenderá y les permite decir no, la primera vez. Pre-aprobar para todos Pre-apruebe las herramientas de su propia empresa; pregunte primero por todo lo que los clientes usan, ya que es una decisión que usted ha tomado por todos.
Un número de miembro privado
Normalmente, cada aplicación ve el mismo número para una persona. Activar Dar a esta aplicación un número de miembro privado Y esta aplicación obtiene su propio número para cada persona en su lugar, por lo que dos aplicaciones no pueden coincidir con la misma persona.La mayoría de las aplicaciones no lo necesitan.
Prensa Conectar la aplicación (o Guardar los cambios cuando esté editando).
Paso 7: Terminar en la aplicación
La aplicación está conectada. La última pantalla muestra:
- The Identificación del cliente, que nombra tu app como Kamo. No es secreto.
- The Secreto del cliente para un sitio web (ver más abajo).
- Los pasos exactos para finalizar en el producto, con cada valor rellenado y un botón de copia al lado de cada uno.
- Muestras de código En Node, Python y PHP (y el navegador, para una aplicación de una sola página) para un sitio web o una aplicación propia; para una aplicación de TV o dispositivo, el inicio de sesión de código en la línea de comandos y en Node.
- Para una aplicación SAML, en lugar de un ID de cliente y un código: la dirección de metadatos y otros detalles para dar a la aplicación, y su certificado de firma.
El secreto del cliente
El secreto es la contraseña de la aplicación, y se muestra Solo por ahora. Cópielo en la aplicación o descargue el archivo .env antes de cerrar la ventana, luego marque He guardado el secreto. Si se pierde, utilice Girar el secreto Las aplicaciones de una sola página y las aplicaciones móviles no tienen ningún secreto, pero es importante saber cómo hacerlo.
El archivo .env
Descargar archivo .env guarda un pequeño archivo de texto con todos los valores que la aplicación necesita (la dirección de inicio de sesión, la dirección de descubrimiento, el identificador del cliente, el secreto, la dirección de retorno y los permisos) en el formato que la mayoría de los marcos de trabajo lee.Manténgalo fuera del control de fuente: contiene el secreto.
Muestras de código
Cada ejemplo lee el archivo .env, por lo que el mismo archivo funciona con todos ellos.Usan bibliotecas de código abierto bien conocidas: openid-client para Node, Authlib para Python y OpenID Connect PHP para PHP.Crear un código de inicio de sesión para un sitio web o una aplicación propia.
Otros artículos relacionados
Otras guías que responden preguntas similares a esta.
Cree una aplicación en el inicio de sesión de su organización
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…
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…
Identidad e inicio de sesión
Su organización tiene su propia página de inicio de sesión, en Iniciar sesión. Esta página decide qué ofrece la página de inicio de sesión: qué formas de entrar, qué cuentas pueden traer las personas con ellas y qué tan…
Utilice su organización como proveedor de identidad SAML
Algunas de las aplicaciones que usa tu equipo (wikis, mesas de ayuda, plataformas de aprendizaje, paneles) permiten que los usuarios inicien sesión con Inicio de sesión único SAML Kamo puede ser el proveedor de…
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 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…
Iniciar sesión en un televisor o dispositivo
Algunas aplicaciones se ejecutan en pantallas en las que escribir una contraseña es incómodo, como un televisor en el vestíbulo, una pantalla en una sala de reuniones, una impresora, una consola de juegos o una…
