Перейти к содержимому
Логотип Аурабаза
аурабаза

Сейф

Шифрование на уровне поля для конфиденциальных данных Aurabase. AES-256-GCM с ключом, полученным из записи (HKDF-SHA256), или транзитный бэкэнд HashiCorp Vault в производстве — один и тот же примитив защищает ваши секреты Edge Functions и внутренние секреты платформы.

Пояснение6 мин читатьУровень среднийПересмотрено 15 авг. 2026 г.

Эта страница была переведена автоматически. Английская версия является авторитетной.

Сервис шифрования, а не отдельный продукт#

«Хранилище» — это не отдельный HTTP-сервис на шлюзе: это механизм шифрования на уровне поля, который автоматически защищает ваши конфиденциальные данные перед записью в базу данных — секреты MFA, токены провайдера OAuth, строки подключения к проекту и секреты вашего Edge Functions.

Как разработчик, на самом деле вы манипулируете секретами для каждой функции.: пары ключ/значение, определенные через CLI или REST API, внедряются как переменные среды в рабочий процесс, выполняющий вашу функцию.

Информация

Название «Хранилище» также относится к инфраструктурному продукту HashiCorp Vault, развернутому в производстве в качестве дополнительного бэкэнда этого сервиса (управление корневым ключом шифрования, ротация, учетные данные Postgres с ограниченным сроком действия). Два значения сосуществуют: описанный здесь примитив приложения и инструмент инфраструктуры, который может его поддерживать.

Два бэкэнда, один формат чтения#

При записи служба выбирает серверную часть: Транзит Vault, если он настроен (предпочтительно — корневой ключ шифрования никогда не покидает Vault), в противном случае — резервный AES-256-GCM, локальный с ключом, полученным путем регистрации через HKDF-SHA256. При чтении формат зашифрованного текста указывает, какой сервер его создал — принудительная миграция для переключения с одного на другой не требуется.

формат зашифрованного текстаtext
vault:v1:AbCdEf...     # внутренний транзит — расшифровывается через Vault (KEK никогда не раскрывается)
{"key_id":"v1",         # локальный бэкэнд AES-256-GCM (резервный/dev)
 "nonce":"…","data":"…"}
sk_live_51J2x...       # незашифрованная историческая ценность (до активации шифрования)
Совет

Контекст деривации (сторона функций) — project_id:function_name — один и тот же секрет, зашифрованный дважды для двух функций, создает два разных зашифрованных текста, а удаление/переименование функции делает старый зашифрованный текст нечитаемым по своей конструкции.

Что предоставляет услуга#

  • AES-256-GCM. 32-байтовый ключ, полученный путем регистрации через HKDF-SHA256 (контекст = идентификатор_проекта:имя_функции). 96-битный одноразовый номер на запись.
  • Транзит Backend Vault. В рабочей среде KEK никогда не покидает Vault: шифрование/дешифрование делегируется транзиту/шифрованию|расшифровке, версионному зашифрованному тексту vault:vN:....
  • Чтение старых форматов. Расшифровка обнаруживает сохраненный формат (хранилище: → транзит, {...} → локальный AES, обычный текст → незашифрованная история): аварийное переключение серверной части без принудительной перезаписи.
  • Область действия по функциям. Секреты приложения, описанные здесь, ограничены функцией (project_id + name), введенной в рабочий процесс Deno через Deno.env.get('KEY').
  • Специальный интерфейс командной строки. 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) и общую конечную точку PATCH /v1/functions/:projectId/:nom, используемую для обновления всей функции — кода, среды выполнения, включая env_vars — без прохождения этого шифрования.

Шифрование переменных среды

Переменные среды, настроенные с помощью /env, перед сохранением шифруются с помощью AES-256-GCM. При локальной разработке, а также при управляемом производстве это шифрование выполняется прозрачно для разработчика.

Чтобы пойти дальше#