跳到主要内容

管理连接器

备注:

对于每个命令,你可以添加 --path /your/path/to/logto(别名 -p)来指定 Logto 实例路径。

如果工作目录位于 Logto 项目的根目录,可以省略使用 --path 选项,因为 CLI 会自动检测。

列出现有连接器

使用以下命令列出已添加到 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 上发表评论或创建 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 实例以使更改生效。