WeCom 승인 연동 설정

Markdown으로 보기

WeCom 연동은 연결된 관리자가 승인 페이지에 접근하고 설정에 따라 승인 대기 알림을 받도록 합니다. 앱 생성, 기능 스위치, 사용자 연결, 승인 절차와 실제 알림 전달은 별도 단계입니다. 저장이나 연결 시험 성공만으로 연결 또는 전달 완료를 증명할 수 없습니다.

준비

플랫폼 연동 조회, 설정 및 운영 권한이 있는 관리자 계정을 사용하고 WeCom 및 승인 페이지 관리자와 협의합니다. 승인 페이지가 배포되어 시험 사용자가 접근할 수 있는지 확인합니다.
WeCom 사용자 지정 앱의 기업 ID, AgentID와 해당 Secret, 앱 상태 및 시험 사용자 공개 범위를 준비합니다. Secret은 민감한 자격 정보이므로 승인된 설정란에만 입력하고 문서, 장애 기록이나 대화에 남기지 마십시오.
WeCom 관리 화면의 현재 요구사항에 따라 앱 홈페이지, 신뢰 도메인과 서버의 공인 출구 IP를 준비합니다. Ping64 저장이 WeCom 설정을 자동으로 변경하지 않으므로 양쪽을 확인합니다.

앱 생성 및 설정

다음 명칭은 영어 인터페이스 기준이며 콘솔 언어에 따라 다를 수 있습니다.

시스템 설정의 Platform Integrations에서 WeCom을 열고 기본 정보에서 Add Application을 선택합니다. 앱 이름, 기업 ID, AgentID와 해당 Secret을 입력하고 확인 후 저장합니다. 기존 앱 수정 시 Secret을 비워 두면 유지되고 새 값을 입력해 저장하면 교체됩니다. 기업 ID와 AgentID는 생성 후 변경할 수 없습니다. 실제 기업이나 앱을 변경할 때는 새 앱 구성을 만듭니다.
목록에서 앱을 확인하고 필요하면 활성화합니다. 활성화, 비활성화, 삭제나 연결 관리 전에 앱을 저장해야 합니다. 변경 전 사용자와 승인 업무 영향을 평가합니다. 앱을 비활성화하면 해당 앱으로 로그인한 승인 세션이 무효화되고 해당 앱의 승인 알림이 중단됩니다. 기존 사용자 연결은 유지됩니다.
승인 기능 설정에서 앱을 선택하고 필요에 따라 Allow Sign-in과 Send Approval Notifications를 각각 켭니다. 알림 사용 시 배포된 승인 웹 진입 주소를 Notification Base URL에 입력하고 언어를 선택합니다. 특정 페이지나 쿼리 매개변수는 입력하지 말고 운영 환경에서는 조직이 승인한 HTTPS 주소를 사용합니다.
기능 설정을 저장하고 화면의 홈페이지 참고 링크와 안내에 따라 WeCom 관리 화면을 별도로 설정합니다. 앱 공개 범위, 신뢰 도메인과 실제 공인 출구 IP를 확인합니다.
Test Connection으로 결과를 확인합니다. 시험은 미저장 변경을 저장하거나 앱을 활성화하지 않습니다. 먼저 설정을 저장하고 로그인, 연결과 실제 알림을 각각 검증합니다.

알림 언어는 중국어 간체 또는 영어를 선택할 수 있으며 제목과 버튼 같은 알림의 고정 문구에 적용됩니다. 관리 콘솔 언어는 변경되지 않습니다. 연결 시험에는 입력했지만 아직 저장하지 않은 새 Secret이 사용될 수 있으므로 시험 성공이 Secret 저장을 뜻하지 않습니다. 자격 정보를 변경한 경우 저장 후 다시 시험하고 실제 알림도 확인하십시오.

연결 및 검증

권한 있는 시험 관리자가 WeCom 앱에서 승인 페이지를 열고 안내에 따라 Ping64 계정을 검증하여 연결합니다. 처리 가능한 승인은 업무 권한에 따라 다릅니다.
Bound Users에서 해당 앱의 유효한 연결을 확인합니다. 연결 해제 시 이 앱의 기존 로그인이 무효가 되고 알림이 중단됩니다. 재사용하려면 계정을 다시 검증해야 하며 다른 앱의 연결은 영향을 받지 않습니다.
통제된 승인 절차로 시험 신청을 제출하고 로그인, 알림, 권한 있는 항목의 조회·처리와 최종 업무 결과를 각각 확인한 후 범위를 확대합니다.

문제 해결

생성, 활성화 또는 시험 불가: 연동 권한, 저장 상태, 기업 ID, AgentID, 자격 정보, 앱 상태와 서버 출구 네트워크를 확인합니다. 장애 기록에 자격 정보를 남기지 마십시오.
로그인 또는 연결 불가: 앱 공개 범위, 승인 페이지 접근, 로그인 스위치, 신뢰 도메인과 Ping64 계정 권한을 확인합니다. WeCom 설정은 별도로 완료해야 합니다.
연결 시험은 성공했으나 알림 없음: 알림 스위치, 기본 주소, 앱 상태, 사용자 연결과 승인 대기 상태를 확인하고 시험 신청으로 검증합니다. 연결 시험은 전달을 증명하지 않습니다.

수정일 2026. 11. 15.