본문으로 건너뛰기

커넥터 관리

노트:

각 명령어에 --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 이슈입니다. 관심이 있다면 관련 GitHub 이슈에 댓글을 달거나 생성하여 커넥터를 인정받으세요.

공식 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 인스턴스를 다시 시작하는 것을 잊지 마세요.