Gerenciar conectores
Para cada comando, você pode adicionar --path /your/path/to/logto
(alias -p
) para especificar o caminho da instância do Logto.
Se o diretório de trabalho estiver na raiz de um projeto Logto, você pode pular o uso da opção --path
, pois o CLI irá detectá-lo automaticamente.
Listar conectores existentes
Use o comando abaixo para listar os conectores existentes que foram adicionados à sua instância Logto:
- CLI
- Local
- npx
logto connector list
npm run cli connector list
npx @logto/cli connector list
Um exemplo de saída:
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
Adicionar conectores
Conectores oficiais
Todos os conectores oficiais estão listados em @logto/connectors, exceto aqueles nomes que começam com connector-mock-
para fins de teste.
Todo conector é uma Questão de Caçador de Recompensas Nível 1 por padrão. Sinta-se à vontade para comentar ou criar a questão relacionada no GitHub para reconhecer um conector se você estiver interessado.
Se você estiver usando a versão oficial do Logto (imagem Docker, Docker Compose, download da página de lançamento do GitHub ou inicialização via CLI), não há necessidade de adicionar manualmente conectores oficiais.
- CLI
- Local
- npx
logto connector add --official
npm run cli connector add --official
npx @logto/cli connector add --official
Conectores de terceiros
Conectores de terceiros são aqueles feitos para Logto, mas NÃO estão em @logto/connectors.
O conector a ser adicionado deve ser um pacote NPM válido, e o nome do pacote deve começar com connector-
ou @some-org/connector-
. Por exemplo:
- CLI
- Local
- npx
logto connector add service-a connector-service-b @org/service-c
# é igual a
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
# é igual a
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
# é igual a
npx @logto/cli connector add connector-service-a connector-service-b @org/connector-service-c
Conectores são códigos executáveis! Inspecione e revise o CÓDIGO COMPILADO (o conteúdo baixado do NPM) muito, muito cuidadosamente para evitar possíveis problemas de segurança se você estiver tentando usar um conector de terceiros.
Lembre-se de reiniciar sua instância Logto para que as alterações sejam refletidas.
Vincular conectores locais
O Logto também vem com um conjunto de conectores pré-construídos no <logto-root>/packages/connectors
do diretório da sua instância Logto. Eles estão vinculados ao serviço principal por padrão, o que você pode vincular manualmente novamente para atualizações (por exemplo, adicionar um novo conector local).
- CLI
- Local
- npx
logto connector link
npm run cli connector link
npx @logto/cli connector link
Este comando criará links simbólicos de cada conector em <logto-root>/packages/connectors
para <logto-root>/packages/core/connectors
. Se um conector com o mesmo nome já existir em packages/core/connectors
, ele será removido primeiro.
Remover conectores
- 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
Lembre-se de reiniciar sua instância Logto para que as alterações sejam refletidas.