DingTalk 소셜 로그인을 설정하세요 (Set up social login with DingTalk)
웹 앱에서 DingTalk 소셜 로그인을 위한 공식 Logto 커넥터입니다.
이 가이드는 Logto 커넥터에 대한 기본적인 이해를 전제로 합니다. 익숙하지 않은 분들은 커넥터 가이드를 참조하여 시작하세요.
시작하기 (Get started)
DingTalk 웹 커넥터는 데스크톱 웹 애플리케이션을 위해 설계되었습니다. OAuth 2.0 인증 (Authentication) 플로우를 사용합니다.
DingTalk Open Platform에서 웹 앱 생성하기
팁: 이미 완료한 섹션이 있다면 건너뛰어도 됩니다.
DingTalk 개발자 계정 등록하기
DingTalk 개발자 계정이 없다면 DingTalk Open Platform에서 등록하세요.
애플리케이션 생성하기
- DingTalk Open Platform의 "애플리케이션 개발" > "내부 엔터프라이즈 애플리케이션" > "DingTalk 애플리케이션"에서 "애플리케이션 생성"을 클릭하세요.
- 애플리케이션 이름과 설명을 입력한 후 "저장"을 클릭하세요.
- 왼쪽 네비게이션 바에서 "개발 구성" > "보안 설정"을 선택하고, "Redirect URL"에
${your_logto_origin}/callback/${connector_id}
를 입력하세요. 해당 커넥터를 관리 콘솔에서 추가한 후 커넥터 상세 페이지에서connector_id
를 확인할 수 있습니다. - 왼쪽 네비게이션 바에서 "기본 정보" > "자격 증명 및 기본 정보"를 선택하여
Client ID
와Client Secret
을 확인하세요.
권한 구성하기
"개발 구성" > "권한 관리"에서 Contact.User.Read
와 Contact.User.mobile
권한을 선택하고 승인하세요.
애플리케이션 릴리스하기
왼쪽 네비게이션 바에서 "애플리케이션 릴리스" > "버전 관리 및 릴리스"를 선택하여 첫 번째 버전을 생성 및 릴리스하여 Client ID
와 Client Secret
을 활성화하세요.
애플리케이션이 버전을 릴리스하지 않으면, 발급받은 "Client ID"와 "Client Secret"을 사용할 수 없거나 요청이 실패할 수 있습니다.
커넥터 구성하기
이전 섹션에서 OAuth 앱 상세 페이지에서 얻은 *Client ID(이전 AppKey 및 SuiteKey)*와 *Client Secret(이전 AppKey 및 SuiteKey)*를 clientId
와 clientSecret
필드에 입력하세요.
scope
는 현재 두 가지 값을 지원합니다: openid
와 openid corpid
. openid
는 인가 후 사용자의 userid
를 얻을 수 있고, openid corpid
는 로그인 과정에서 선택한 사용자의 id
와 조직의 id
를 모두 얻을 수 있습니다. 값은 공백으로 구분해야 합니다. 참고: URL 인코딩이 필요합니다.
구성 타입
이름 | 타입 |
---|---|
clientId | string |
clientSecret | string |
scope | string |
DingTalk 커넥터 테스트하기
이제 끝입니다. DingTalk 커넥터를 사용할 수 있습니다. 로그인 경험에서 커넥터 활성화하기를 잊지 마세요.
DingTalk 웹 커넥터가 활성화되면, 다시 앱에 로그인하여 정상 동작하는지 확인할 수 있습니다.
개발 과정에서 DingTalk Open Platform의 사용 규정 및 개발 가이드라인을 엄격히 준수해 주세요.
지원
질문이 있거나 추가 지원이 필요하다면 DingTalk 개발자 문서를 방문하거나 DingTalk 기술 지원에 문의하세요.