---
title: 고객으로 로그인
description: 문제를 재현하기 위해 특정 고객의 권한으로 1시간 동안 고객 포털을 엽니다 — 조건, 보호 조치, 차단 및 기록되는 항목.
url: https://nexcmp.com/ko/docs/customers/login-as/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# 고객으로 로그인 {#log-in-as-a-customer}

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

## 작동 내용 {#what-it-does}

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

## 요구 사항 {#requirements}

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

## 단계 {#steps}

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

![사유 필드가 채워진 Impersonate 대화상자](https://nexcmp.com/ko/docs/images/customers/login-as-01-dialog.webp)

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

## 동작 방식 {#how-it-works}

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를 반환합니다.

## 대리 로그인 세션에서 차단되는 작업 {#what-is-blocked-in-an-impersonated-session}

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

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

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

## 확인 {#verify}

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

## 한도 및 참고 사항 {#limits-notes}

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

## Troubleshooting {#troubleshooting}

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