Postman 환경 변수 설정

현재 v12 데스크톱의 환경 변수 설정을 다룹니다. 프로그램 선택·Desktop/Web/Agent 차이가 필요하면 Postman 제품 안내에서 확인하세요. 과거 화면이나 VS Code 확장의 두 값 입력 칸을 현재 데스크톱과 같은 절차로 적용하지 않습니다.

첫 연습에는 API 키나 운영 서버를 넣을 필요가 없습니다. 공식 Postman Echo의 GET 예시를 열고 브라우저 주소에서 마지막 /get을 제외한 기본 주소를 base_url의 값으로 사용하세요. 요청에는 {{base_url}}/get를 넣습니다.

1. 사이드바의 + → Environments를 선택하거나 오른쪽 위 환경 selector의 +로 새 환경을 만듭니다. 이름은 연습용임을 알아볼 수 있게 정합니다.
2. Items → Environments에서 해당 환경을 열고 변수 이름 base_url과 Value를 입력합니다. 현재 변수 변경은 자동 저장됩니다.
3. 오른쪽 위 환경 selector에서 그 환경을 선택해 활성화합니다. 환경을 만들기만 한 상태로 요청을 보내지 않습니다.

한 번에 활성화할 수 있는 환경은 하나입니다. 환경 이름이 기대한 대상인지 확인한 뒤 요청 편집기로 돌아가세요. 팀 환경의 공유 값을 편집하는 권한과 자기 로컬 값을 바꾸는 권한도 구분해야 합니다.

현재 메뉴와 환경 편집의 권한은 공식 환경 관리 문서에서 확인할 수 있습니다.

GET 연습 요청의 URL을 {{base_url}}/get로 구성합니다. 이름의 대소문자·밑줄이 환경 변수와 같아야 하며 중괄호는 양쪽 두 개씩입니다. 주소 값에 마지막 /get까지 넣으면 요청의 경로와 중복되므로 기본 주소와 요청 경로를 나눕니다.

• URL의 변수 위에 마우스를 올려 해석되는 로컬 값을 확인합니다. 정의되지 않은 이름이나 예상과 다른 주소면 아직 보내지 않습니다.
• workbench의 Variables를 열어 활성 환경의 로컬 값을 확인합니다. 환경 이름만 같다고 실제 값까지 같다고 판단하지 않습니다.
• 공식 Echo로 만든 빈 GET 연습에서는 요청 경로가 /get으로 끝나고 변수 자리에 기본 주소가 들어가는지 대조합니다. 필요한 경우 그 GET 응답으로 기본 연결만 확인합니다.

변수 참조와 hover 확인은 공식 변수 사용 문서를 기준으로 합니다.

같은 이름이 여러 범위에 있으면 더 좁은 범위의 값이 선택됩니다. 넓은 쪽부터 global → collection → environment → data → local 순입니다. 환경 값은 collection·global을 덮어쓰지만 data·local 값이 있으면 다시 덮어쓰일 수 있습니다.

줄이 그어진 변수는 다른 범위에 덮어써진 값일 수 있습니다. 예를 들어 collection과 environment에 base_url이 각각 있고 더 좁은 변수가 없다면 활성 환경 값이 적용됩니다. 기대와 다르면 같은 이름의 data·local 값부터 확인하세요.

환경 변수의 로컬 값(local value)은 자기 Postman 인스턴스에 보관된 값이라는 뜻입니다. local scope는 요청·컬렉션 실행에 쓰는 임시 범위입니다. 두 표현의 local이 같아도 같은 개념이 아닙니다.

범위와 보관 상태의 차이는 공식 변수 범위·값 설명에서 확인할 수 있습니다.

현재 기본 Value는 자기 Postman의 로컬 값이고 Postman Cloud에 동기화하지 않습니다. Share를 실행하면 그 시점의 값을 바탕으로 별도의 공유 값이 생깁니다. 이후 로컬 값을 수정해도 공유 값이 자동으로 바뀌지는 않습니다.

팀원이 쓰는 기본값이나 Cloud에서 실행하는 monitor·예약 실행 등에 필요한 공유 값은 별도 조건입니다. 개인 요청이 안 된다고 Share나 Share all부터 누르지 마세요. 먼저 활성 환경·참조 이름·우선순위를 확인합니다.

v12 데스크톱에서는 과거 Initial/Current 두 칸을 독립적으로 관리하는 방식 대신 로컬 Value와 공유 동작을 구분합니다. VS Code 확장에는 Initial/Current가 지원된다는 예외가 있어 이전 글의 화면을 그대로 대입하면 헷갈릴 수 있습니다.

공유 범위·권한과 중단 방법은 공식 변수 공유 문서에서 확인하세요.

API 키·토큰을 저장할 때는 단순 주소 예시와 다르게 처리해야 합니다. 현재 Secure는 화면에서 값을 가리는 표시만이 아니라 Local Vault 키를 사용하는 AES-256 암호화입니다. Editor 접근과 Local Vault 키 설정 조건을 확인하세요.

Secure 변수는 기본 로컬입니다. 팀·Cloud 기능에서 쓰려면 Shared Vault와 변수 자체의 공유 조건을 확인해야 합니다. Shared Vault에 secret을 보관한 것만으로 그 secret을 참조하는 변수까지 공유되지는 않습니다.

Secure 설정·이전 방식의 차이는 공식 Secure 변수 설명을 확인하세요. 이 가이드는 Vault 전체 구성이나 팀 보안 정책 설정까지 다루지 않습니다.

다시 검수할 때는 활성 환경 이름 → 변수 참조 → 해석값 → 동명 변수/실행 데이터 순으로 확인합니다. 자신의 요청에 기대한 값이 보이는지와 팀/Cloud 공유값이 맞는지는 별개의 점검입니다. 주소 해석이 맞더라도 서버 접근·인증·응답 오류까지 모두 해결된 것은 아닙니다.