본문으로 건너뛰기
아우라베이스 로고
아우라베이스

금고

민감한 Aurabase 데이터에 대한 필드 수준 암호화. 레코드 파생 키(HKDF-SHA256)가 있는 AES-256-GCM 또는 프로덕션의 HashiCorp Vault 전송 백엔드 — 동일한 기본 요소가 Edge Functions 비밀 및 내부 플랫폼 비밀을 보호합니다.

설명6분 읽기레벨 중급2026. 8. 15.에 개정됨

이 페이지는 자동으로 번역되었습니다. 영어 버전은 권위가 있습니다.

별도의 상품이 아닌 암호화 서비스#

"Vault"는 게이트웨이의 별도 HTTP 서비스가 아닙니다. 데이터베이스에 쓰기 전에 민감한 데이터(MFA 비밀, OAuth 공급자 토큰, 프로젝트 연결 문자열 및 Edge Functions비밀)를 자동으로 보호하는 필드 수준 암호화 엔진입니다.

개발자로서 실제로 조작하는 것은 함수당 비밀입니다.: CLI 또는 REST API를 통해 정의된 키/값 쌍은 함수를 실행하는 작업자에 환경 변수로 주입됩니다.

정보

"Vault"라는 이름은 또한 이 서비스의 선택적 백엔드(루트 암호화 키 관리, 순환, 제한된 수명의 Postgres 자격 증명 관리)로 프로덕션에 배포된 HashiCorp Vault 인프라 제품을 나타냅니다. 여기에 문서화된 애플리케이션 기본 요소와 이를 지원할 수 있는 인프라 도구라는 두 가지 의미가 공존합니다.

백엔드 2개, 읽기 형식 1개#

쓰기 시 서비스는 백엔드를 선택합니다. 구성된 경우 Vault 전송(선호 - 루트 암호화 키는 Vault를 떠나지 않음), 그렇지 않으면 HKDF-SHA256을 통해 등록하여 파생된 키가 있는 대체 AES-256-GCM 로컬을 선택합니다. 읽을 때 암호문의 형식은 이를 생성한 백엔드를 나타냅니다. 하나에서 다른 것으로 전환하기 위해 강제 마이그레이션이 필요하지 않습니다.

암호문 형식text
vault:v1:AbCdEf...     # 백엔드 전송 — Vault를 통해 해독됨(KEK는 노출되지 않음)
{"key_id":"v1",         # 로컬 AES-256-GCM 백엔드(대체/개발)
 "nonce":"…","data":"…"}
sk_live_51J2x...       # 암호화되지 않은 기록 값(암호화 활성화 전)
팁

파생 컨텍스트(함수 측)는 project_id:function_name입니다. 두 함수에 대해 두 번 암호화된 동일한 비밀은 두 개의 서로 다른 암호문을 생성하고 함수를 제거/이름을 바꾸면 이전 암호문을 구성으로 읽을 수 없게 됩니다.

서비스가 제공하는 것#

  • AES-256-GCM. HKDF-SHA256(컨텍스트 = project_id:function_name)을 통해 등록하여 파생된 32바이트 키입니다. 쓰기당 96비트 nonce.
  • 백엔드 Vault 전송. 프로덕션에서 KEK는 Vault를 떠나지 않습니다: 암호화/암호 해독이 전송/암호화|해독에 위임됨, 버전이 지정된 암호 텍스트 Vault:vN:....
  • 이전 형식을 읽습니다. 복호화는 저장된 형식(vault: → 전송, {...} → 로컬 AES, 일반 텍스트 → 암호화되지 않은 기록)을 감지합니다. 강제 재작성 없이 백엔드 장애 조치를 수행합니다.
  • 기능별 범위. 여기에 문서화된 애플리케이션 비밀은 Deno.env.get('KEY')를 통해 Deno 작업자에 주입되는 함수(project_id + 이름)로 범위가 지정됩니다.
  • 전용 CLI. aura secrets list, set 및 unset는 --function <name>를 사용합니다. list는 일반 텍스트로 값을 표시하지 않습니다.
  • 플랫폼에서 재사용됩니다. 동일한 암호화 서비스는 서버 측에서 MFA 비밀, OAuth 토큰 및 연결 문자열(db_url_encrypted, anon_key_encrypted)도 보호합니다.

세 가지 글쓰기 방식, 한 가지 읽기 방식#

functions/echo.tstypescript
// 일단 작성되면(CLI 또는 REST) 비밀이 변수로 주입됩니다.
// 기능을 실행하는 작업자의 환경.
Deno.serve(async (req) => {
  const cle = Deno.env.get('STRIPE_SECRET_KEY')
  // ...
})
팁

CLI(aura secrets)와 전용 REST 엔드포인트(/env)는 동일한 데이터, 즉 함수의 비밀을 조작하지만 반드시 동일한 쓰기 경로를 통할 필요는 없습니다. 아래 주의점을 참고하세요.

암호화는 사용된 쓰기 경로에 따라 다릅니다.#

aura-functions는 함수의 환경 변수를 수정하는 두 가지 방법, 즉 전용 PUT /v1/functions/:projectId/:nom/env 엔드포인트(쓰기 전에 EncryptionService를 통해 체계적으로 암호화함)와 이 암호화를 거치지 않고 전체 함수(코드, 런타임, env_vars 포함)를 업데이트하는 데 사용되는 일반 PATCH /v1/functions/:projectId/:nom 엔드포인트를 노출합니다.

환경 변수 암호화

/env를 통해 구성된 환경 변수는 저장되기 전에 AES-256-GCM을 통해 저장 시 암호화됩니다. 로컬 개발과 관리되는 프로덕션에서 이 암호화는 개발자에게 투명하게 수행됩니다.

더 나아가려면#