Aller au contenu principal

Gérer les connecteurs

remarque

Pour chaque commande, vous pouvez ajouter --path /your/path/to/logto (alias -p) pour spécifier le chemin de l'instance Logto.

Si le répertoire de travail est à la racine d'un projet Logto, vous pouvez ignorer l'utilisation de l'option --path car le CLI le détectera automatiquement.

Lister les connecteurs existants​

Utilisez la commande ci-dessous pour lister les connecteurs existants qui ont été ajoutés à votre instance Logto :

logto connector list

Un exemple de sortie :

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

3RD-PARTY
  connector-some-third-party

Ajouter des connecteurs​

Connecteurs officiels​

Tous les connecteurs officiels sont listés dans @logto/connectors, sauf ceux dont les noms commencent par connector-mock- à des fins de test.

Appel aux contributeurs !

Chaque connecteur est par défaut un problème de chasseur de primes de niveau 1. N'hésitez pas à commenter ou à créer le problème GitHub lié pour reconnaître un connecteur si vous êtes intéressé.

Si vous utilisez la version officielle de Logto (image Docker, Docker Compose, téléchargement depuis la page de version GitHub, ou initialisation via CLI), il n'est pas nécessaire d'ajouter manuellement les connecteurs officiels.

logto connector add --official

Connecteurs tiers​

Les connecteurs tiers sont ceux créés pour Logto mais NON dans @logto/connectors.

Le connecteur à ajouter doit être un package NPM valide, et le nom du package doit commencer par connector- ou @some-org/connector-. Par exemple :

logto connector add service-a connector-service-b @org/service-c
# est équivalent à
logto connector add connector-service-a connector-service-b @org/connector-service-c
attention

Les connecteurs sont du code exécutable ! Inspectez et examinez très, très attentivement le CODE COMPILÉ (le contenu téléchargé depuis NPM) pour éviter les problèmes de sécurité potentiels si vous essayez d'utiliser un connecteur tiers.

remarque

N'oubliez pas de redémarrer votre instance Logto pour que les modifications soient prises en compte.

Lier les connecteurs locaux​

Logto est également livré avec un ensemble de connecteurs préconstruits dans le répertoire <logto-root>/packages/connectors de votre instance Logto. Ils sont liés au service principal par défaut, que vous pouvez relier manuellement pour les mises à jour (par exemple, ajouter un nouveau connecteur local).

logto connector link

Cette commande créera des liens symboliques de chaque connecteur dans <logto-root>/packages/connectors vers <logto-root>/packages/core/connectors. Si un connecteur portant le même nom existe déjà dans packages/core/connectors, il sera d'abord supprimé.

Supprimer des connecteurs​

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

N'oubliez pas de redémarrer votre instance Logto pour que les modifications soient prises en compte.