コネクターを管理する
各コマンドに --path /your/path/to/logto
(エイリアス -p
)を追加して、Logto インスタンスのパスを指定できます。
Logto プロジェクトのルートで作業ディレクトリがある場合、CLI が自動的に検出するため、--path
オプションを使用する必要はありません。
既存のコネクターを一覧表示する
以下のコマンドを使用して、Logto インスタンスに追加された既存のコネクターを一覧表示します:
- CLI
- Local
- npx
logto connector list
npm run cli connector list
npx @logto/cli 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 経由での初期化)を使用している場合、公式コネクターを手動で追加する必要はありません。
- CLI
- Local
- npx
logto connector add --official
npm run cli connector add --official
npx @logto/cli connector add --official
サードパーティコネクター
サードパーティコネクターは、Logto 用に作成されたもので、@logto/connectors には含まれていません。
追加するコネクターは有効な NPM パッケージである必要があり、パッケージ名は connector-
または @some-org/connector-
で始まる必要があります。例:
- CLI
- Local
- npx
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 run cli connector add service-a connector-service-b @org/service-c
# は次と同じです
npm run cli connector add connector-service-a connector-service-b @org/connector-service-c
npx @logto/cli connector add service-a connector-service-b @org/service-c
# は次と同じです
npx @logto/cli connector add connector-service-a connector-service-b @org/connector-service-c
コネクターは実行可能なコードです!サードパーティコネクターを使用しようとする場合、潜在的なセキュリティ問題を避けるために、コンパイル済みコード(NPM からダウンロードした内容)を非常に注意深く検査し、レビューしてください。
変更を反映させるために、Logto インスタンスを再起動することを忘れないでください。
ローカルコネクターをリンクする
Logto には、Logto インスタンスディレクトリの <logto-root>/packages/connectors
に一連の事前構築されたコネクターも付属しています。これらはデフォルトでコアサービスにリンクされていますが、更新のために手動で再リンクすることができます(例:新しいローカルコネクターを追加する)。
- CLI
- Local
- npx
logto connector link
npm run cli connector link
npx @logto/cli connector link
このコマンドは、<logto-root>/packages/connectors
内のすべてのコネクターのシンボリックリンクを <logto-root>/packages/core/connectors
に作成します。同じ名前のコネクターが packages/core/connectors
に既に存在する場合、最初に削除されます。
コネクターを削除する
- CLI
- Local
- npx
logto connector remove connector-service-a @org/connector-service-b
npm run cli connector remove connector-service-a @org/connector-service-b
npx @logto/cli connector remove connector-service-a @org/connector-service-b
変更を反映させるために、Logto インスタンスを再起動することを忘れないでください。