Integraciones

Quién la ve

Integraciones se ofrece a un miembro cuyo rol puede gestionar roles y los ajustes de la organización. El mismo permiso lleva Notificaciones y Ajustes.

Dónde está

Bajo Cuenta en el menú. Las direcciones antiguas de Claves de API y Webhooks siguen resolviéndose y abren esta página, porque los tres asuntos viven ahora en ella.

Para qué sirve

La página lo dice en una línea: cómo habla otro sistema con esta organización.

Hay dos direcciones, y las pestañas las separan. Una clave es saliente: el otro sistema nos llama con ella. Un webhook es entrante: nosotros llamamos al otro sistema. Se configuran juntos y se depuran juntos, y por eso comparten página.

Claves de API

123

1. 1Una clave deja que otro sistema nos llame. Un webhook nos deja llamar a otro sistema. Una cuenta de servicio es un miembro máquina.
2. 2Emite una clave. Se muestra una vez y no se puede volver a leer después.
3. 3Cada clave, y cuándo se usó por última vez — que es lo que te dice si sigue haciendo falta.

Create API Key pide un nombre y emite la clave.

La clave se muestra una vez, y el panel lo dice: copia esta clave ahora, no podrás volver a verla. No hay forma de leerla después. Si la pierdes, revócala y haz otra.

La tabla enumera cada clave con Name, Key, Last Used y Created. Last Used es lo que te dice si una clave sigue haciendo falta.

Una clave emitida aquí lleva autoridad sobre los webhooks además de sobre los clientes y la verificación. Una clave, no una por pestaña. Trátala en consecuencia, y da a cada sistema su propia clave para que revocar una no detenga a las demás.

Webhooks

Un webhook nos deja llamar a otro sistema cuando ocurre algo, como que un cliente sea activado, suspendido o revocado.

Añadir un webhook pide una URL del extremo y los Eventos que quieres. Al crearlo se muestra un secreto de firma, una vez, con el mismo aviso que una clave. Ese secreto es lo que usa tu servidor para confirmar que la llamada vino de verdad de nosotros.

Cada webhook muestra su último acierto, cuántos fallos ha tenido, y si está Activo, En pausa o Desactivado.

Enviar una prueba llama a tu extremo ahora mismo e informa de lo que respondió, como código de estado. Úsalo cuando el extremo haya cambiado, antes de esperar a que un evento real te lo diga.

Cuentas de servicio

Una cuenta de servicio es un miembro máquina de esta organización. Ejecuta el cliente de escritorio en un servidor y verifica códigos sin una persona. No tiene buzón y no se le muestra a los demás miembros de una conexión.

Crear una pide un nombre y devuelve el secreto de su código de identidad. Se muestra una vez, como todo lo demás aquí.

Cada cuenta de servicio muestra cuántas conexiones tiene, y lleva su propia lista de claves de API, con Nueva clave y Revocar.

La razón para usar una en lugar de la cuenta de un colega: una verificación automática que corre en un servidor no debería dejar de funcionar cuando una persona se va, ni debería ser visible para las personas del otro lado de una conexión.

Revocar

Todas las claves, los webhooks y las cuentas de servicio se pueden quitar aquí. Revocar una clave detiene de inmediato al sistema que la usa, así que confirma quién la tiene antes de hacerlo.