Zum Hauptinhalt springen

Connectors verwalten

hinweis

Für jeden Befehl kannst du --path /your/path/to/logto (Alias -p) anhängen, um den Pfad der Logto-Instanz anzugeben.

Wenn sich das Arbeitsverzeichnis im Stammverzeichnis eines Logto-Projekts befindet, kannst du die Verwendung der --path-Option überspringen, da die CLI es automatisch erkennt.

Vorhandene Connectors auflisten​

Verwende den folgenden Befehl, um vorhandene Connectors aufzulisten, die zu deiner Logto-Instanz hinzugefügt wurden:

logto connector list

Ein Beispielausgabe:

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

DRITTANBIETER
  connector-some-third-party

Connectors hinzufügen​

Offizielle Connectors​

Alle offiziellen Connectors sind in @logto/connectors aufgelistet, außer den Namen, die mit connector-mock- zu Testzwecken beginnen.

Aufruf an Mitwirkende!

Jeder Connector ist standardmäßig ein Tier 1 Bounty Hunter Issue. Fühle dich frei, den entsprechenden GitHub-Issue zu kommentieren oder zu erstellen, um einen Connector anzuerkennen, wenn du interessiert bist.

Wenn du die offizielle Logto-Version verwendest (Docker-Image, Docker Compose, Download von der GitHub-Release-Seite oder Initialisierung über CLI), ist es nicht notwendig, offizielle Connectors manuell hinzuzufügen.

logto connector add --official

Drittanbieter-Connectors​

Drittanbieter-Connectors sind solche, die für Logto erstellt wurden, aber NICHT in @logto/connectors enthalten sind.

Der hinzuzufügende Connector sollte ein gültiges NPM-Paket sein, und der Paketname muss mit connector- oder @some-org/connector- beginnen. Zum Beispiel:

logto connector add service-a connector-service-b @org/service-c
# ist gleichbedeutend mit
logto connector add connector-service-a connector-service-b @org/connector-service-c
vorsicht

Connectors sind ausführbarer Code! Untersuche und überprüfe den KOMPILIERTEN CODE (den Inhalt, der von NPM heruntergeladen wird) sehr, sehr sorgfältig, um potenzielle Sicherheitsprobleme zu vermeiden, wenn du versuchst, einen Drittanbieter-Connector zu verwenden.

hinweis

Denke daran, deine Logto-Instanz neu zu starten, um die Änderungen zu übernehmen.

Lokale Connectors verlinken​

Logto kommt auch mit einer Reihe von vorgefertigten Connectors im <logto-root>/packages/connectors deines Logto-Instanzverzeichnisses. Sie sind standardmäßig mit dem Kerndienst verlinkt, den du manuell erneut verlinken kannst, um Updates vorzunehmen (z. B. einen neuen lokalen Connector hinzufügen).

logto connector link

Dieser Befehl erstellt symbolische Links für jeden Connector in <logto-root>/packages/connectors zu <logto-root>/packages/core/connectors. Wenn ein Connector mit demselben Namen bereits in packages/core/connectors existiert, wird er zuerst entfernt.

Connectors entfernen​

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

Denke daran, deine Logto-Instanz neu zu starten, um die Änderungen zu übernehmen.