メインコンテンツまでスキップ

コネクターを管理する

注記:

各コマンドに --path /your/path/to/logto(エイリアス -p)を追加して、Logto インスタンスのパスを指定できます。

Logto プロジェクトのルートで作業ディレクトリがある場合、CLI が自動的に検出するため、--path オプションを使用する必要はありません。

既存のコネクターを一覧表示する

以下のコマンドを使用して、Logto インスタンスに追加された既存のコネクターを一覧表示します:

logto connector list

サンプル出力:

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

コネクターを追加する

公式コネクター

すべての公式コネクターは、@logto/connectors に一覧されています。ただし、テスト目的で connector-mock- で始まる名前は除きます。

コントリビューター募集中!:

すべてのコネクターはデフォルトで Tier 1 Bounty Hunter issue です。興味がある場合は、コネクターを認識するために関連する GitHub issue にコメントしたり作成したりしてください。

公式の Logto リリース(Docker イメージ、Docker Compose、GitHub リリースページからのダウンロード、または CLI 経由での初期化)を使用している場合、公式コネクターを手動で追加する必要はありません。

logto connector add --official

サードパーティコネクター

サードパーティコネクターは、Logto 用に作成されたもので、@logto/connectors には含まれていません。

追加するコネクターは有効な NPM パッケージである必要があり、パッケージ名は connector- または @some-org/connector- で始まる必要があります。例:

logto connector add service-a connector-service-b @org/service-c
# は次と同じです
logto connector add connector-service-a connector-service-b @org/connector-service-c
注意:

コネクターは実行可能なコードです!サードパーティコネクターを使用しようとする場合、潜在的なセキュリティ問題を避けるために、コンパイル済みコード(NPM からダウンロードした内容)を非常に注意深く検査し、レビューしてください。

注記:

変更を反映させるために、Logto インスタンスを再起動することを忘れないでください。

Logto には、Logto インスタンスディレクトリの <logto-root>/packages/connectors に一連の事前構築されたコネクターも付属しています。これらはデフォルトでコアサービスにリンクされていますが、更新のために手動で再リンクすることができます(例:新しいローカルコネクターを追加する)。

logto connector link

このコマンドは、<logto-root>/packages/connectors 内のすべてのコネクターのシンボリックリンクを <logto-root>/packages/core/connectors に作成します。同じ名前のコネクターが packages/core/connectors に既に存在する場合、最初に削除されます。

コネクターを削除する

logto connector remove connector-service-a @org/connector-service-b
注記:

変更を反映させるために、Logto インスタンスを再起動することを忘れないでください。