# API02010: 인증 필요

## 이것이 의미하는 바[​](#what-this-means "이것이 의미하는 바으로 직접 링크")

당신이 시도하고 있는 작업은 인증을 요구하지만, 현재 로그인되어 있지 않습니다. POS는 이 리소스에 접근하기 위한 유효한 인증 정보가 필요합니다.

## 일반적인 원인[​](#common-causes "일반적인 원인으로 직접 링크")

* **로그인하지 않음** — 아직 인증하지 않았습니다
* **세션 클리어됨** — 세션이 지워지거나 만료되었습니다
* **보호된 리소스 접근** — 해당 리소스는 인증을 요구합니다
* **앱 데이터 클리어됨** — 저장된 인증 정보가 삭제되었습니다

## 서버 오류 매핑[​](#server-error-mapping "서버 오류 매핑으로 직접 링크")

서버가 반환할 때 이 오류 코드가 발생합니다:

| 서버 코드                 | 출처                  |
| ------------------------- | --------------------- |
| `rest_login_required`     | WordPress REST API    |
| `jwt_auth_no_auth_header` | JWT 인증 플러그인     |
| HTTP 401                  | 모든 서버 응답 (대체) |

## 해결 방법[​](#how-to-fix "해결 방법으로 직접 링크")

### 1. 로그인[​](#1-log-in "1. 로그인으로 직접 링크")

로그인하지 않았다면:

1. POS 로그인 화면을 엽니다
2. WordPress 인증 정보를 입력합니다
3. 인증 과정을 완료합니다

### 2. 세션 상태 확인[​](#2-check-session-status "2. 세션 상태 확인으로 직접 링크")

로그인했다고 생각했다면:

* 세션이 만료되었을 수 있습니다
* 더 많은 세부정보를 위해 [API02002](/ko/error-codes/API02002.md) (토큰 만료)를 확인하세요
* 접근을 복원하기 위해 다시 로그인하세요

### 3. 서버 구성 확인[​](#3-verify-server-configuration "3. 서버 구성 확인으로 직접 링크")

API 엔드포인트가 올바르게 구성되어 있는지 확인하세요:

* WooCommerce REST API가 활성화되어 있어야 합니다
* WCPOS 플러그인이 활성화되어 있어야 합니다
* 인증 엔드포인트에 접근할 수 있어야 합니다

### 4. 브라우저/앱 문제 확인[​](#4-check-for-browserapp-issues "4. 브라우저/앱 문제 확인으로 직접 링크")

예상치 못하게 로그아웃되는 경우:

* 브라우저 캐시를 지우세요 (웹 버전을 사용하는 경우)
* 쿠키/로컬 스토리지가 차단되는지 확인하세요
* 앱이 데이터를 저장할 권한이 있는지 확인하세요

## 인증이 필요한 것[​](#what-requires-authentication "인증이 필요한 것으로 직접 링크")

대부분의 POS 작업은 인증이 필요합니다:

* 제품 및 고객 보기
* 주문 생성 및 편집
* 결제 처리
* 보고서 접근

초기 로그인 화면만 인증 없이 접근할 수 있습니다.

## 관련 오류[​](#related-errors "관련 오류으로 직접 링크")

* [API02001](/ko/error-codes/API02001.md) — 잘못된 인증 정보
* [API02002](/ko/error-codes/API02002.md) — 토큰 만료