변수 — 워크스페이스 값과 시크릿

스크립트가 ctx.variables.get(path) 로 읽는 워크스페이스 스코프 값과 시크릿을 콘솔에서 관리한다. 사이드바의 Variables(/w/{workspace}/variables)로 연다.

값과 시크릿

• path 가 식별자다(예: u/me/api_key). 같은 path 로 다시 저장하면 덮어쓴다.
• plain 값은 목록에 그대로 보이고 복사할 수 있다.
• secret 은 저장할 때 워크스페이스 키로 암호화(AES-256-GCM)되어 저장되고 목록에서 •••••• 로 가려진다. Reveal 을 누를 때만 복호해 보여주며(1회성이 아니라 필요할 때마다 다시 볼 수 있다), Hide 로 다시 가린다.

만들기 · 수정 · 삭제

• New variable: path · value · description 와 Secret 토글. Secret 으로 저장하면 암호화·마스킹된다. 인스턴스에 저장 quota 가 설정돼 있으면 한도 초과 시 거부된다(422).
• 수정: Secret 을 편집하면 현재 값을 미리 채워 두므로, 설명만 바꿔도 저장된 값이 지워지지 않는다. path 는 식별자라 수정 중 잠긴다.
• 삭제: 확인 게이트를 거친다 — 그 변수를 읽던 스크립트는 실행 시 실패한다.

권한

API 토큰과 달리 워크스페이스 멤버면 누구나 변수를 관리한다(admin 전용이 아니다). 값 노출은 워크스페이스 경계 안에 머문다.

스크립트에서 쓰기

저장한 변수는 액션 코드에서 잡 토큰으로 콜백해 읽는다. 시크릿은 복호된 값으로 들어온다.

export async function main(ctx) {
  const apiKey = await ctx.variables.get("u/me/api_key")
  // ... apiKey 로 외부 호출
  return { ok: true }
}