서드파티 로그인
TE3.1 버전부터 AE 슈퍼 관리자는 시스템 관리 기능 모듈에서 서드파티 앱 연동을 설정하여 다음 기능을 사용할 수 있습니다:
- 서드파티 앱의 QR 코드 스캔으로 로그인
- 서드파티 앱 워크벤치에서 원클릭으로 AE에 로그인
- 서드파티 앱으로 AE 알림 수신
주의: 이 가이드는 SaaS 고객 및 LDAP 인증으로 로그인하는 고객에게는 적용되지 않습니다.
위의 모든 기능을 사용하려면 문서의 단계에 따라 작업하십시오.
현재 WeCom, DingTalk, Feishu 앱 연동을 지원합니다. 관련 섹션을 참고하여 앱 연동을 완료하십시오
1. 서드파티 앱 연동
1.1 WeCom
1단계: 앱 생성
WeCom 관리자가 WeCom 관리 콘솔에 진입하여 앱 관리 - 앱 - 자체 개발에서 앱을 생성합니다
- 앱 로고를 업로드합니다. AE 로고를 사용하려면 여기를 클릭하여 다운로드하십시오
- 앱 이름을 입력합니다(예: AE 플랫폼)
- 앱 소개를 입력합니다
- 표시 범위를 선택합니다. 작업자 본인도 표시 범위에 추가해야 하며, 표시 범위 내의 직원만 WeCom 인증으로 AE 플랫폼에 로그인할 수 있습니다
2단계: WeCom 클라이언트에서 AE 플랫폼에 진입하도록 설정
생성한 앱을 클릭하여 들어간 후 페이지 아래쪽의 기능 모듈에서 워크벤치 앱 홈페이지 설정을 클릭하고, 팝업에 앱 홈페이지 주소를 입력합니다: https://프라이빗 클러스터 주소/#/login (예: https://ta.thinkingdata.cn/#/login)
3단계: WeCom 계정 정보 가져오기
페이지 아래쪽의 개발자 인터페이스 → 웹 페이지 인증 및 JS-SDK에서 신뢰할 수 있는 도메인 설정을 클릭하고, 팝업에 신뢰할 수 있는 도메인(프라이빗 클러스터 주소)을 입력합니다. 도메인 소유권 인증이 필요하면 안내에 따라 진행하십시오
4단계: WeCom QR 코드 로그인 활성화
개발자 인터페이스 → WeCom 인증 로그인에서 설정을 클릭합니다
설정 페이지에서 Web 페이지 → 인증 콜백 도메인 설정을 선택합니다. 프라이빗 클러스터 주소를 입력하고 저장을 클릭합니다.
이상으로 WeCom 관리 콘솔의 설정이 완료되었습니다. AE 플랫폼에서 다음 설정을 완료하십시오.
5단계: AE 시스템 관리에서 WeCom 앱 연동
AE 슈퍼 관리자가 시스템 관리 → 일반 관리 → 일반 설정에 진입하여 서드파티 로그인 탭을 열고, 서드파티 플랫폼 관리 리스트에서 WeCom을 선택한 후 연동을 클릭합니다.
- 기업 ID: WeCom 관리 콘솔의 내 기업 - 기업 정보
- AgentId&Secret: 생성한 앱의 첫 페이지
이상으로 AE 시스템과 WeCom의 연동이 완료되었습니다.
1.2 DingTalk
1단계: 앱 생성
DingTalk 기업 관리자가 로그인한 후 DingTalk 오픈 플랫폼에 진입하여 Workbench에서 Self-built App을 클릭합니다
기업 내부 앱을 선택합니다
- 앱 이름: AE 플랫폼 등
- 앱 설명
- 앱 아이콘: AE 로고를 사용하려면 여기를 클릭하여 다운로드하십시오
2단계: DingTalk 클라이언트 워크벤치에서 AE 플랫폼에 진입하도록 설정
생성한 마이크로 앱의 상세 페이지에서 Development Management를 선택하고 다음 내용을 편집한 후 저장합니다
- 개발 모드: 바로 가기 링크
- 앱 홈페이지 주소: https://프라이빗 클러스터 주소/#/login, 예: https://ta.thinkingdata.cn/#/login
- PC 홈페이지 주소: https://프라이빗 클러스터 주소/#/login
3단계: DingTalk 로그인 계정 정보 가져오기
현재 페이지에서 Permission Management를 클릭하여 권한 범위를 설정하고 Member Information Read Permission qyapi_get_member를 추가합니다
4단계: 앱 사용 범위 설정 및 앱 게시
직원을 선택하여 권한을 부여합니다. 사용 범위 내의 직원만 DingTalk 인증으로 AE 플랫폼에 로그인할 수 있습니다
5단계: DingTalk QR 코드 로그인 활성화
왼쪽 내비게이션 바의 Login and Sharing 모듈에서 콜백 도메인을 입력합니다
https://프라이빗 클러스터 주소/v1/sso/thirdLogin/callback
이상으로 DingTalk 관리 콘솔의 설정이 완료되었습니다. 다음 단계는 AE 플랫폼에서의 설정입니다.
6단계: AE 시스템 관리에서 DingTalk 앱 연동
AE 슈퍼 관리자가 시스템 관리 → 일반 관리 → 일반 설정에 진입하여 서드파티 로그인 탭을 열고, 서드파티 플랫폼 관리 리스트에서 DingTalk을 선택한 후 연동을 클릭합니다
- CorpID: DingTalk 개발 플랫폼 첫 페이지에서 확인할 수 있습니다
나머지 정보는 앱 자격 증명에서 확인할 수 있습니다
-
QR 코드 로그인 앱 인증
- appID: AppKey에 해당합니다
- appSecret: AppSecret에 해당합니다
-
H5 마이크로 앱 자격 증명(그림과 동일)
- AgentId
- AppKey
- AppSecret
새 버전 앱이라면 화면 표시가 이전 버전과 다릅니다
-
QR 코드 로그인 앱 인증
- appID: Client ID에 해당합니다
- appSecret: Client Secret에 해당합니다
-
H5 마이크로 앱 자격 증명
- AgentId: 기존 기업 내부 앱의 AgentId에 해당합니다
- AppKey: Client ID에 해당합니다
- AppSecret: Client Secret에 해당합니다
이상으로 AE 시스템과 DingTalk의 연동이 완료되었습니다.
1.3 Feishu
1단계: Feishu 관리자가Feishu 오픈 플랫폼에 진입하여 Custom App을 선택하고 Create Custom App을 클릭합니다
- 앱 유형: 기업 자체 개발 앱
- 앱 이름: AE 플랫폼 등
- 앱 부제목
- 앱 아이콘: AE 로고를 사용하려면 여기를 클릭하여 다운로드하십시오
2단계: Feishu 클라이언트 워크벤치에서 AE 플랫폼에 진입하도록 설정
생성한 앱을 클릭하여 들어간 후 Features → Web App을 클릭합니다:
- 웹 앱 활성화를 클릭합니다
- 데스크톱 홈페이지 설정: https://프라이빗 클러스터 주소/#/login. 예: https://ta.thinkingdata.cn/#/login
- 모바일 홈페이지 설정: https://프라이빗 클러스터 주소/#/login
3단계: 자동 로그인 인증 코드 URL 화이트리스트 설정
Security Settings를 클릭하고 리디렉션 URL을 설정합니다: https://프라이빗 클러스터 주소/v1/sso/thirdLogin/callback
4단계: 메시지 수신 기능 설정
Permissions & Scopes를 클릭하고 Obtain user ID(contact:user.employee_id:readonly), Send messages as an app(im:message:send_as_bot), Send batch messages to multiple users(im:message:send_multi_users)를 추가합니다
Features → Bot을 클릭한 후 Enable Bot을 클릭합니다
5단계: 앱 표시 범위 설정 및 앱 게시
직원을 선택하여 권한을 부여합니다. 표시 범위 내의 직원만 Feishu 인증으로 AE 플랫폼에 로그인할 수 있습니다
인원 권한 변경이 포함된 버전은 Feishu 관리자의 검토가 필요합니다. 검토가 승인되어야 게시한 버전이 적용됩니다.
이상으로 Feishu 오픈 플랫폼의 앱 설정이 완료되었습니다. AE 플랫폼에서 다음 설정을 완료하십시오.
6단계: AE 시스템 관리에서 Feishu 앱 연동
AE 슈퍼 관리자가 시스템 관리 → 일반 관리 → 일반 설정에 진입하여 서드파티 로그인 탭을 열고, 서드파티 플랫폼 관리 리스트에서 Feishu를 선택한 후 연동을 클릭합니다.
- App ID & App Secret: 생성한 앱의 Credentials & Basic Info에서 확인합니다
이상으로 AE 시스템과 Feishu의 연동이 완료되었습니다.
2. AE 계정 연동
슈퍼 관리자가 AE 시스템과 서드파티 앱의 연동을 완료하면 AE 멤버는 개인 계정을 연동할 수 있습니다.
2.1 기존 AE 계정 연동
(1) 로그인 후 개인 설정 페이지에서 연동 완료
AE 멤버는 개인 설정 페이지에 진입하여 개인 계정 연동을 클릭합니다. 개인 설정 페이지에서 연동을 클릭하고 QR 코드를 스캔하면 서드파티 계정과 AE 계정의 연동이 완료됩니다.
- 주의: 앱 표시 범위 내의 멤버만 이 연동을 완료할 수 있습니다
(2) 로그인 페이지에서 연동 완료
AE 로그인 페이지에서 앱 로그인 버튼을 클릭하고 QR 코드를 스캔한 후 AE 계정과 비밀번호를 입력하고 연동을 클릭하면 됩니다
2.2 서드파티 앱을 통한 AE 계정 발급
슈퍼 관리자가 시스템 관리에서 서드파티 앱 연동을 완료하면 유저는 AE 로그인 페이지에서 QR 코드를 스캔하여 AE 계정을 생성할 수 있습니다
- 주의: 앱 표시 범위 내의 멤버만 계정을 생성할 수 있습니다
새로 생성된 계정에는 기본적으로 프로젝트 권한이 없습니다. 관리자에게 연락하여 프로젝트 관리에서 계정을 프로젝트에 추가하고 프로젝트 권한 부여를 완료해야 합니다.
3. 계정 연결 해제
서드파티 계정과 AE 계정은 1:1로 연동됩니다. 연동할 때 계정이 이미 연동되었다는 알림이 표시되어 연동 관계를 바꾸려면, 현재 계정의 연결을 해제한 후 새 계정을 다시 연동할 수 있습니다:
(1) 이미 연동된 계정으로 QR 코드를 스캔하여 로그인
(2) 개인 설정 페이지에 진입하여 현재 연동 해제
- 연결을 해제한 계정은 AE 계정과 비밀번호로만 로그인할 수 있습니다. 이 계정을 계속 사용하려면 계정 이름과 비밀번호를 꼭 기억해 두십시오
(3) 연동할 AE 계정에 로그인하여 다시 연동 완료