Сейф
Шифрование на уровне поля для конфиденциальных данных Aurabase. AES-256-GCM с ключом, полученным из записи (HKDF-SHA256), или транзитный бэкэнд HashiCorp Vault в производстве — один и тот же примитив защищает ваши секреты Edge Functions и внутренние секреты платформы.
Сервис шифрования, а не отдельный продукт#
«Хранилище» — это не отдельный HTTP-сервис на шлюзе: это механизм шифрования на уровне поля, который автоматически защищает ваши конфиденциальные данные перед записью в базу данных — секреты MFA, токены провайдера OAuth, строки подключения к проекту и секреты вашего Edge Functions.
Как разработчик, на самом деле вы манипулируете секретами для каждой функции.: пары ключ/значение, определенные через CLI или REST API, внедряются как переменные среды в рабочий процесс, выполняющий вашу функцию.
Название «Хранилище» также относится к инфраструктурному продукту HashiCorp Vault, развернутому в производстве в качестве дополнительного бэкэнда этого сервиса (управление корневым ключом шифрования, ротация, учетные данные Postgres с ограниченным сроком действия). Два значения сосуществуют: описанный здесь примитив приложения и инструмент инфраструктуры, который может его поддерживать.
Два бэкэнда, один формат чтения#
При записи служба выбирает серверную часть: Транзит Vault, если он настроен (предпочтительно — корневой ключ шифрования никогда не покидает Vault), в противном случае — резервный AES-256-GCM, локальный с ключом, полученным путем регистрации через HKDF-SHA256. При чтении формат зашифрованного текста указывает, какой сервер его создал — принудительная миграция для переключения с одного на другой не требуется.
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).
Три способа письма, один способ чтения#
// После записи (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. При локальной разработке, а также при управляемом производстве это шифрование выполняется прозрачно для разработчика.
Чтобы пойти дальше#
- Edge Functions
Среды выполнения, вызовы, разрешения — где живут ваши функции и их секреты.
- Крон
Запускайте функцию (и, следовательно, ее секреты) по расписанию.
- Безопасность и RBAC
Роли, политики RLS, аудит — остальная часть модели безопасности Aurabase.
- ОТДЫХ API
Необработанная поверхность HTTP, аутентификация по сервисному ключу.