Pular para o conteúdo principal

Gerenciar conectores

nota

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:

logto 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.

Convocação para colaboradores!

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.

logto 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:

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
cuidado

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.

nota

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).

logto 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

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

Lembre-se de reiniciar sua instância Logto para que as alterações sejam refletidas.