Saltar al contenido principal

Gestionar conectores

nota

Para cada comando, puedes añadir --path /your/path/to/logto (alias -p) para especificar la ruta de la instancia de Logto.

Si el directorio de trabajo está en la raíz de un proyecto Logto, puedes omitir el uso de la opción --path ya que el CLI lo detectará automáticamente.

Listar conectores existentes​

Usa el siguiente comando para listar los conectores existentes que se han añadido a tu instancia de Logto:

logto connector list

Un ejemplo de salida:

OFICIAL
  @logto/connector-alipay-native
  @logto/connector-aliyun-dm
  @logto/connector-aliyun-sms
  @logto/connector-apple
  @logto/connector-azuread

TERCEROS
  connector-some-third-party

Añadir conectores​

Conectores oficiales​

Todos los conectores oficiales están listados en @logto/connectors, excepto aquellos nombres que comienzan con connector-mock- para propósitos de prueba.

¡Llamado a contribuyentes!

Cada conector es un problema de Cazador de Recompensas de Nivel 1 por defecto. Siéntete libre de comentar o crear el problema relacionado en GitHub para reconocer un conector si estás interesado.

Si estás utilizando la versión oficial de Logto (imagen de Docker, Docker Compose, descarga desde la página de lanzamientos de GitHub, o inicialización a través de CLI), no es necesario añadir manualmente los conectores oficiales.

logto connector add --official

Conectores de terceros​

Los conectores de terceros son aquellos hechos para Logto pero NO en @logto/connectors.

El conector a añadir debe ser un paquete NPM válido, y el nombre del paquete debe comenzar con connector- o @some-org/connector-. Ejemplo:

logto connector add service-a connector-service-b @org/service-c
# es igual a
logto connector add connector-service-a connector-service-b @org/connector-service-c
precaución

¡Los conectores son código ejecutable! Inspecciona y revisa el CÓDIGO COMPILADO (el contenido descargado de NPM) muy, muy cuidadosamente para evitar posibles problemas de seguridad si estás intentando usar un conector de terceros.

nota

Recuerda reiniciar tu instancia de Logto para que los cambios se reflejen.

Enlazar conectores locales​

Logto también viene con un conjunto de conectores preconstruidos en <logto-root>/packages/connectors de tu directorio de instancia de Logto. Están enlazados al servicio principal por defecto, lo que puedes enlazar manualmente de nuevo para actualizaciones (por ejemplo, añadir un nuevo conector local).

logto connector link

Este comando creará enlaces simbólicos de cada conector en <logto-root>/packages/connectors a <logto-root>/packages/core/connectors. Si ya existe un conector con el mismo nombre en packages/core/connectors, se eliminará primero.

Eliminar conectores​

logto connector remove connector-service-a @org/connector-service-b
nota

Recuerda reiniciar tu instancia de Logto para que los cambios se reflejen.