금고
민감한 Aurabase 데이터에 대한 필드 수준 암호화. 레코드 파생 키(HKDF-SHA256)가 있는 AES-256-GCM 또는 프로덕션의 HashiCorp Vault 전송 백엔드 — 동일한 기본 요소가 Edge Functions 비밀 및 내부 플랫폼 비밀을 보호합니다.
별도의 상품이 아닌 암호화 서비스#
"Vault"는 게이트웨이의 별도 HTTP 서비스가 아닙니다. 데이터베이스에 쓰기 전에 민감한 데이터(MFA 비밀, OAuth 공급자 토큰, 프로젝트 연결 문자열 및 Edge Functions비밀)를 자동으로 보호하는 필드 수준 암호화 엔진입니다.
개발자로서 실제로 조작하는 것은 함수당 비밀입니다.: CLI 또는 REST API를 통해 정의된 키/값 쌍은 함수를 실행하는 작업자에 환경 변수로 주입됩니다.
"Vault"라는 이름은 또한 이 서비스의 선택적 백엔드(루트 암호화 키 관리, 순환, 제한된 수명의 Postgres 자격 증명 관리)로 프로덕션에 배포된 HashiCorp Vault 인프라 제품을 나타냅니다. 여기에 문서화된 애플리케이션 기본 요소와 이를 지원할 수 있는 인프라 도구라는 두 가지 의미가 공존합니다.
백엔드 2개, 읽기 형식 1개#
쓰기 시 서비스는 백엔드를 선택합니다. 구성된 경우 Vault 전송(선호 - 루트 암호화 키는 Vault를 떠나지 않음), 그렇지 않으면 HKDF-SHA256을 통해 등록하여 파생된 키가 있는 대체 AES-256-GCM 로컬을 선택합니다. 읽을 때 암호문의 형식은 이를 생성한 백엔드를 나타냅니다. 하나에서 다른 것으로 전환하기 위해 강제 마이그레이션이 필요하지 않습니다.
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)도 보호합니다.
세 가지 글쓰기 방식, 한 가지 읽기 방식#
// 일단 작성되면(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을 통해 저장 시 암호화됩니다. 로컬 개발과 관리되는 프로덕션에서 이 암호화는 개발자에게 투명하게 수행됩니다.