---
url: https://docs.ogmabox.com/ko/app/environment.md
description: 재전송, 자동화, 워크플로 및 테스트 컨텍스트에서 사용할 Ogma 환경 변수를 관리합니다.
---

# 환경 {#environment}

환경 변수는 재전송, 자동화, 워크플로의 요청에서 참조할 수 있는 재사용 가능한 값을 저장합니다.

## 변수 만들기 및 편집 {#creating-and-editing-variables}

1. 왼쪽 탐색 메뉴에서 **환경**을 엽니다.
2. **새로 만들기**를 클릭합니다.
3. 영문자 또는 밑줄로 시작하고, 이후에는 영문자, 숫자, 밑줄, 하이픈으로 구성되는 이름을 입력합니다(최대 64자).
4. 값을 입력합니다.
5. 값이 민감한 정보(API 키, 토큰, 비밀번호)라면 **비밀 값**을 켭니다. 비밀 값은 UI에서 마스킹되고 AI 컨텍스트에서 제외됩니다.
6. **저장**을 클릭합니다.

기존 변수를 편집하려면 해당 행을 클릭하여 이름이나 값을 수정합니다.

## 요청에서 변수 사용 {#using-variables-in-requests}

`env.` 접두사로 환경 변수를 참조합니다.

```
{{env.VARIABLE_NAME}}
```

예:

* 호스트 필드: {{env.TARGET\_HOST}}(전체 URL이 아니라 호스트 이름을 저장합니다).
* Authorization 헤더: Bearer {{env.AUTH\_TOKEN}}.
* 요청 본문: {"tenant": "{{env.TENANT\_ID}}"}. 본문 내부에서 값을 치환하려면 재전송에서 본문 템플릿 처리를 켭니다.

Ogma는 전송 시 유효한 환경 변수 자리표시자를 해석합니다. 변수가 없으면 미해결 값을 그대로 보내지 않고 오류를 반환합니다. 원문 및 16진수 재전송은 정확한 바이트를 유지하며 자리표시자를 확장하지 않습니다.

## 변수 범위 {#variable-scope}

이 Ogma 작업 공간의 프로젝트가 공유하는 값에는 **전역**을, 현재 프로젝트에 속하는 값에는 **프로젝트**를 선택합니다. 이름이 같으면 프로젝트 값이 전역 값을 덮어씁니다. 재전송에서는 컬렉션과 세션 단위 재정의도 지원합니다. 우선순위는 세션, 컬렉션, 프로젝트, 전역 순입니다.

## 변환과 동적 값 {#transforms-and-dynamic-values}

파이프로 변환을 추가합니다. 예: {{env.AUTH\_TOKEN|base64\_encode}} 또는 {{env.SEARCH|url\_encode}}. 변환은 왼쪽에서 오른쪽 순서로 적용됩니다. 테스트 요청으로 출력을 확인하세요. 알 수 없는 변환 이름은 건너뛰며 오류로 보고되지 않습니다.

내장 값은 변수로 저장할 필요가 없습니다.

| 자리표시자 | 값 |
| --- | --- |
| {{$timestamp}} | 밀리초 단위의 현재 Unix 시각입니다. |
| {{$timestamp\_s}} | 초 단위의 현재 Unix 시각입니다. |
| {{$uuid}} | 새 UUID입니다. |
| {{$random(16)}} | 16바이트의 무작위 값을 16진수로 표현합니다. |
| {{$date(%Y-%m-%d)}} | 날짜 형식 패턴에 따른 현재 UTC 날짜입니다. |

저장된 값은 재귀적으로 확장되지 않습니다. 값에 다른 자리표시자가 들어 있어도 중첩된 텍스트는 그대로 유지됩니다.

## AI 어시스턴트 접근 {#ai-assistant-access}

요청 분석이나 테스트 계획 작성을 부탁하면 AI 어시스턴트는 비밀 값이 아닌 변수의 이름과 값을 읽어 컨텍스트로 활용할 수 있습니다. 비밀 변수는 AI 컨텍스트에 절대 포함되지 않습니다.

## 일반적인 용도 {#common-uses}

| 변수 | 값 예시 |
| --- | --- |
| `BASE_URL` | `https://api.example.com` |
| `AUTH_TOKEN` | `eyJhbGci...`(비밀 값으로 설정) |
| `TARGET_HOST` | `app.example.com` |
| `API_KEY` | `sk-...`(비밀 값으로 설정) |
| `USER_ID` | `12345` |

## 관련 페이지 {#related-pages}

* [재전송](./replay.md)
* [자동화](./automate.md)
* [워크플로](./workflows.md)