고객으로 로그인

관리자 위치: Customers › Customers › List › a customer › header button Impersonate(/customers/<id>).

작동 내용

Impersonate(로그인 대행) 기능을 사용하면 지원 관리자가 고객의 시점에서 포털을 정확히 확인하여 문제를 재현하거나 주문을 도울 수 있습니다. 세션은 1시간 동안 지속되며 일반 세션과 명확히 구분됩니다. 계정에 대한 지속적인 접근을 부여할 수 있는 모든 작업은 차단되며, 모든 사용 내역은 기록됩니다.

요구 사항

항목	요구 사항
역할	관리 콘솔에 로그인한 관리자.
Customer	계정은 반드시 활성 상태여야 합니다. 잠기거나 삭제된 계정은 "계정이 활성화되지 않았습니다"(HTTP 409)를 반환합니다.
사유	사유는 필수이며 감사 로그에 기록됩니다.
브라우저	관리자 주소에 대한 팝업을 허용하세요. 포털이 새 창으로 열립니다.

단계

1. Customers › List를 열고 고객을 클릭합니다.
2. Impersonate를 클릭합니다. 고객의 사이트가 1시간 동안 고객 권한으로 열리며 모든 작업이 감사된다는 내용의 대화상자가 표시됩니다.
3. 사유(예: "티켓 1234 — VM을 생성할 수 없음")를 입력하고 Open app을 클릭합니다.
4. 고객의 사이트에 ?impersonated=1이(가) 포함된 대시보드가 새 창으로 열립니다. 브라우저에서 창을 차단한 경우 팝업을 허용하고 다시 클릭하세요.

리셀러의 고객인 경우, 링크는 고객의 자체 사이트에서만 작동하므로 창은 리셀러의 고유 도메인에서 열립니다.

동작 방식

1. 관리자 작업은 1시간 동안 유효한 일회용 토큰을 생성하고 감사 로그에 customer.login_as(관리자, IP, 사유, 사이트)을 기록합니다.
2. 새 창이 https://<site>/v1/portal/impersonate/<token>(으)로 열립니다. 첫 번째 요청은 작은 페이지만 표시하고 토큰을 소모하지 않으며(브라우저 프리페칭으로 인해 토큰이 소모되는 것 방지), 이후 페이지가 POST로 확인합니다.
3. POST 요청 시 토큰이 소모됩니다. 두 번째로 사용하거나 1시간 후에 사용하는 경우 "가장(Impersonation) 링크가 만료되었거나 이미 사용되었습니다"라는 메시지가 반환됩니다.
4. NexCMP는 1시간 동안 지속되는 고객 세션을 생성하고(일반 세션은 30일 지속), 로그인 방법 impersonate(으)로 로그인 항목을 기록하며, customer.login_as.used을(를) 로그에 남깁니다.
5. 이 토큰은 고객의 자체 사이트에서만 작동하며, 다른 호스트에서는 404를 반환합니다.

대리 로그인 세션에서 차단되는 작업

1시간을 초과하는 권한을 부여하거나 고객의 보안을 변경하는 모든 작업은 HTTP 403 impersonate_forbidden 오류를 반환합니다.

차단됨	이유
비밀번호, TOTP 변경, Google/GitHub 연동 또는 해제, 패스키 편집	고객 본인의 자격 증명
계정 삭제	복구 불가
API keys 생성 또는 편집	장기 지속 액세스
CLI, 데스크톱 또는 MCP 로그인 승인 (디바이스 링크)	장기 지속 액세스
Kubernetes 액세스, S3 keys, SSH keys, 루트 비밀번호, 콘솔 공유 링크, VPN 또는 프록시 자격 증명 생성	세션 종료 후에도 유지되는 보안 정보
충전 코드 사용	금전 관련 캠페인
제휴 수수료 인출 또는 정산 변경	시스템 외부로 자금 유출
AI keys, 예산 또는 알림 e-mail 편집	고객 설정

그 외의 모든 기능은 정상 작동합니다. 페이지 조회, VM 생성 및 관리, 주문 등을 수행할 수 있습니다. 작업은 고객의 신원과 잔액으로 실행되며, 관리자가 세션 배후에 있었다는 사실은 앞서 언급한 감사 로그에 기록됩니다.

확인

1. 테스트 고객으로 대리 로그인합니다. 포털이 열리며 해당 고객의 데이터가 표시됩니다.
2. 비밀번호 변경을 시도하면 "forbidden" (대리 로그인) 오류가 발생합니다.
3. System › Logs › Admin actions에서 관리자 이름, 사유, 사이트가 포함된 customer.login_as 항목과 그 뒤의 customer.login_as.used 항목을 확인합니다.
4. 창을 닫고 동일한 링크를 다시 열면 "link expired or already used" 메시지가 표시됩니다.

한도 및 참고 사항

• 1시간 제한은 고정되어 있습니다 (3600초). 계속하려면 다시 대리 로그인하세요.
• 조회 및 재현 위주로 진행하고, 고객의 요청이 없는 한 비용이 발생하는 작업은 피하세요.
• 고객 페이지의 Revoke sessions을 사용하여 세션을 조기에 취소하세요 (고객 세션도 함께 로그아웃됩니다).
• 리셀러는 리셀러 메뉴에서 자체 Sign in to partner console 대리 로그인(60분)을 사용할 수 있습니다. Resellers를 참조하세요.

Troubleshooting

증상	원인	해결 방법
"계정이 활성화되지 않았습니다"	계정 잠김 또는 삭제됨	먼저 잠금을 해제하거나 고객 페이지를 직접 확인하세요.
브라우저에서 창 차단	팝업 차단기	관리자 주소에 대한 팝업을 허용하고 다시 시도하세요.
"링크가 만료되었거나 이미 사용되었습니다"	1시간 제한 초과 또는 재사용	다시 대리 로그인하세요.
"Not found" 열림	잘못된 호스트에서 링크가 사용됨	대화상자가 연 창을 사용하고, 다른 곳에 링크를 붙여넣지 마세요.
작업 중 "forbidden" 오류 발생	대리 로그인 세션에서 차단됨	고객에게 직접 요청하거나 관리자 화면을 사용하세요.