# 테스트 환경과 계정 설정

> 검증이 어느 주소를 열고, 누구로 로그인할지를 정하는 곳이에요. 테스트할 사이트 주소, 테스트 계정, 안전하게 보관되는 시크릿까지 — 검증을 돌리기 전에 갖춰 둘 것들을 정리했어요.

## 검증엔 "어디를, 누구로"가 필요해요

검증은 실제 브라우저가 진짜 주소를 열고 눌러 보는 일이에요. 그래서 돌리기 전에 두 가지가 정해져 있어야 합니다.

- **어디를** — 테스트할 사이트 주소 (테스트 환경)
- **누구로** — 로그인이 필요한 흐름이라면, 어떤 계정으로 들어갈지 (테스트 계정)

이 두 가지를 정하는 곳이 작업실 보드의 **테스트 환경** 탭이에요. 한 번 갖춰 두면 이후 모든 검증이 이 설정을 따라갑니다.

## 테스트 환경 등록하기

테스트 환경은 "검증이 열 사이트 주소"예요. 테스트 환경 탭에서 이름과 주소만 적으면 등록됩니다.

- **이름** — 구분용 이름 (예: "스테이징", "운영")
- **사이트 주소** — 검증이 여는 프론트 주소 (예: `https://staging.example.com`)

환경은 여러 개 둘 수 있어요. 예를 들어 배포 전 확인용 "스테이징"과 실제 서비스 "운영"을 나란히 두고, 검증할 때 골라 쓰는 식이죠. 그중 하나를 **기본 환경**으로 정해 두면, 따로 고르지 않은 검증은 늘 기본 환경에서 돌아갑니다.

검증 묶음(회차)이 만들어질 때는 그때 고른 환경과 계정이 그 묶음에 **고정돼요.** 그래서 같은 묶음 안에서 다시 검증할 때는 늘 같은 환경·같은 계정으로 돌아가, 결과가 서로 어긋나지 않아요.

> 주소는 Specnote 서버가 접속할 수 있는 곳이어야 해요. 내 PC에서만 도는 `localhost` 주소라면 아래 "내 컴퓨터에서만 도는 앱이라면"을 봐 주세요.

## 테스트 계정 연결하기

"로그인한 회원만 볼 수 있는 화면"을 검증하려면, Specnote가 로그인할 **테스트 계정**이 필요해요. 테스트 환경 탭의 **로그인 계정**에서 아이디(이메일)와 비밀번호를 등록하면 됩니다.

계정은 **환경마다 따로** 둘 수 있어요. 스테이징 계정과 운영 계정이 다른 경우가 많으니까요. 환경을 정하지 않고 등록한 계정은 특정 환경에 묶이지 않고 **어느 환경에서든 쓸 수 있어요.** 환경마다 계정이 달라야 한다면 그때 환경을 지정해서 따로 등록하면 됩니다.

여기서도 원칙은 하나예요. **운영 비밀번호가 아니라 테스트 전용 계정**을 등록해 주세요. 새어 나가도 실제 손해가 없는 계정이면 가장 안심이에요.

테스트마다 "회원으로 볼지, 방문자(로그인 안 함)로 볼지"를 정할 수 있어서, 같은 화면도 두 입장에서 각각 검증할 수 있어요. 예를 들어 "로그인 안 한 사람이 결제 화면에 들어가지지 않는지" 같은 확인이죠.

## 시크릿 — 안전하게 보관돼요

등록한 계정과 키 값은 **등록 즉시 암호화**되어 보관됩니다(KMS라는 전용 보관 장치를 써요). 본인만 열어 볼 수 있고, 화면에서 "값 보기"를 눌러도 5초만 보인 뒤 다시 가려져요.

테스트 계정 말고도, 검증에 필요한 값이 있다면 **시크릿**으로 함께 보관할 수 있어요. 샌드박스(연습용 가짜 결제 환경) 키 같은 것들이요. 운영 비밀과는 완전히 분리되어 있으니, 테스트에 필요한 최소한의 값만 넣으시면 됩니다.

혹시 코드를 연결할 때 코드 안에서 발견된 값이 있으면, Specnote가 "이 값을 시크릿으로 보관할까요?" 하고 물어봐요. 확인 후 보관 여부를 고르면 됩니다.

## 내 컴퓨터에서만 도는 앱이라면 (LOCAL)

아직 배포 전이라 앱이 내 PC(`localhost`)에서만 돌고 있어도 검증할 수 있어요. 환경을 등록할 때 **내 컴퓨터(LOCAL)** 방식을 고르면 됩니다.

로그인이 필요한 검증이라면 흐름이 조금 달라요. Specnote 서버가 내 PC의 로그인 화면에 직접 들어갈 수 없기 때문에, **내가 한 번 로그인해 주는 방식**을 씁니다.

1. 테스트 환경 탭에서 **내 컴퓨터에서 로그인**을 눌러요.
2. 내 컴퓨터에 로그인용 브라우저 창이 곧 열려요.
3. 그 창에서 평소처럼 로그인해요.
4. 화면으로 돌아와 **로그인 완료**를 누르면 끝이에요.

이렇게 한 번 로그인해 두면, Specnote가 그 로그인 상태를 안전하게 이어받아 검증을 진행해요. 브라우저 창이 한참 안 열린다면 화면의 안내에 따라 내 컴퓨터에서 Specnote 도우미를 켜 주면 됩니다.

## AI에게 맡겨도 돼요

이 설정들은 화면에서 직접 해도 되고, 연결해 둔 AI에게 말로 부탁해도 돼요.

> Specnote에 테스트 환경 등록해 줘. 이름은 "스테이징", 주소는 https://staging.example.com 이야. 그리고 테스트 계정 tester@example.com / 비밀번호 ○○○ 도 넣어 줘.

이렇게 말하면 AI가 환경과 계정을 대신 등록합니다. AI 연결이 아직이라면 [내 AI 연결하기 (MCP 설치)](/ko/docs/install-mcp)를 먼저 봐 주세요.

환경과 계정이 갖춰졌다면, 이제 [검증 돌리고 결과 읽기](/ko/docs/running-and-results)로 넘어가 실제로 돌려 보세요. 로그인 단계에서 자꾸 실패한다면 [문제 해결](/ko/docs/troubleshooting)에 짚어 볼 목록이 있어요.

---

Source: https://specnote.io/ko/docs/test-environments