# 네이버 클라우드 플랫폼 SMS 설정 가이드

## 1. 네이버 클라우드 플랫폼 설정

### 1.1 네이버 클라우드 플랫폼 가입
- https://www.ncloud.com/ 에서 회원가입
- 본인인증 및 결제 수단 등록

### 1.2 SMS 서비스 활성화
1. 네이버 클라우드 콘솔 접속
2. AI·NAVER API > SENS > SMS 선택
3. SMS 서비스 신청 및 활성화

### 1.3 프로젝트 생성 및 API 키 발급
1. 프로젝트 생성
2. IAM > Access Key Management에서 Access Key 생성
3. Secret Key 확인 (생성 시에만 확인 가능)

### 1.4 SMS 서비스 ID 확인
1. SENS > SMS 서비스에서 Service ID 확인
2. 발신번호 등록 (사전 승인된 번호만 사용 가능)

## 2. 환경 변수 설정

프로젝트 루트에 `.env` 파일을 생성하고 다음 내용을 입력하세요:

```
# 네이버 클라우드 플랫폼 SMS 설정
# 스크린샷에서 확인한 정보를 입력하세요

# Access Key ID (스크린샷의 "Access Key ID" 값)
NAVER_CLOUD_ACCESS_KEY=ncp_iam_BPAMKR1m30ZhNpesC6mm

# Secret Key (스크린샷의 "Secret Key" 보기 버튼 클릭 후 확인한 값)
NAVER_CLOUD_SECRET_KEY=your_secret_key_here

# SMS 서비스 ID (SENS > SMS 서비스에서 확인)
NAVER_CLOUD_SMS_SERVICE_ID=your_service_id_here

# 발신번호 (사전 승인된 번호만 사용 가능)
NAVER_CLOUD_SMS_SENDER_PHONE=your_sender_phone_here

# SMS 인증 설정
SMS_VERIFICATION_TIMEOUT=180
SMS_MAX_RETRY_COUNT=3
```

## 3. 설정 값 설명

- `NAVER_CLOUD_ACCESS_KEY`: 네이버 클라우드 플랫폼에서 발급받은 Access Key
- `NAVER_CLOUD_SECRET_KEY`: 네이버 클라우드 플랫폼에서 발급받은 Secret Key
- `NAVER_CLOUD_SMS_SERVICE_ID`: SMS 서비스 ID (ncp:sms:kr:xxxxx:xxxxx 형식)
- `NAVER_CLOUD_SMS_SENDER_PHONE`: 사전 승인된 발신번호 (예: 01012345678)
- `SMS_VERIFICATION_TIMEOUT`: 인증번호 유효시간 (초, 기본값: 180초)
- `SMS_MAX_RETRY_COUNT`: 최대 재발송 횟수 (기본값: 3회)

## 4. 발신번호 등록

### 4.1 일반 발신번호
- 사업자등록증, 통신사 이용증명서 등 필요
- 승인까지 1-2일 소요

### 4.2 080 번호
- 별도 신청 및 승인 필요
- 더 빠른 승인 가능

## 5. 테스트

설정 완료 후 다음 명령어로 테스트:

```bash
python manage.py runserver
```

회원가입 또는 비밀번호 찾기에서 실제 SMS 발송 테스트

## 6. 주의사항

1. `.env` 파일은 절대 Git에 커밋하지 마세요
2. 실제 운영 환경에서는 환경 변수로 설정하는 것을 권장합니다
3. SMS 발송 비용이 발생합니다 (건당 약 20원)
4. 발신번호는 반드시 사전 승인된 번호만 사용 가능합니다
