환경

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

변수 만들기 및 편집

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

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

요청에서 변수 사용

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

{{env.VARIABLE_NAME}}

예:

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

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

변수 범위

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

변환과 동적 값

파이프로 변환을 추가합니다. 예: {{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 어시스턴트는 비밀 값이 아닌 변수의 이름과 값을 읽어 컨텍스트로 활용할 수 있습니다. 비밀 변수는 AI 컨텍스트에 절대 포함되지 않습니다.

일반적인 용도

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

관련 페이지

• 재전송
• 자동화
• 워크플로