Перейти к содержанию
ERITKOM
ОблакаНовость

AWS Parameter Store добавила 13 типов проверки конфигурации, но API по-прежнему возвращает строки

IP-адреса, номера аккаунтов и JSON можно проверять при записи. Проверка формата не подтверждает существование аккаунта, доступность сервера или соответствие значения правилам приложения.

Существующая иллюстрация замка AJ Ashton как тематический знак защиты конфигурации
AJ Ashton / Open Clip Art Library, Padlock, CC0. Исходник. Тематический знак, не интерфейс AWS. Изменены размер и формат.

Неподходящее значение можно отклонить до чтения

AWS 5 ноября объявила 13 новых типов данных Parameter Store для проверки значений при создании и обновлении параметров. Среди них есть регион, номер аккаунта AWS, логическое значение, число, имя узла и IP-адрес. Ещё три типа — URL, JSON и JSONC — доступны только для advanced-параметров. Поэтому новый перечень не означает одинаковые условия применения для каждого уровня хранилища.

Задача функции — обнаружить неподходящий формат раньше, чем конфигурацию прочитает приложение. Например, строка, не похожая на одиночный IP-адрес, может быть отклонена при записи. Это не заменяет проверку доступности указанного узла, прав на обращение к нему или соответствия адреса окружению production. Структурно допустимое значение и правильное значение для конкретной системы остаются разными понятиями.

Правила проверки зависят от выбранного типа

Документация уточняет несколько неочевидных границ. Тип aws:account:id проверяет двенадцать цифр, но не подтверждает существование аккаунта. integer ограничен знаковым 32-битным целым и не принимает запись с ведущими нулями или знаком плюс. binary здесь обозначает последовательность нулей и единиц, а не произвольные данные в base64. Подобные различия важны для уже накопленной конфигурации.

JSON требует объект или массив верхнего уровня и не допускает повторяющихся ключей. JSONC добавляет комментарии, но не разрешает завершающие запятые; комментарии сохраняются при возврате значения. Простой переход к новому обозначению не делает прежний парсер JSON совместимым с таким содержимым. Таблица ниже показывает несколько границ проверки, а не полный перечень возможных бизнес-ограничений пользовательской конфигурации.

Примеры проверок из документации Parameter Store
ТипПроверяетсяНе подтверждается
aws:account:id Формат из 12 цифр Существование аккаунта
ipv4-address Одиночный IPv4 без CIDR и порта Доступность узла
jsonc Объект/массив JSON с комментариями Поддержка комментариев обычным JSON-парсером

Источник: официальная документация

Тип проверки и способ хранения — разные поля

Контракт PutParameter отдельно содержит Type и DataType. Первое поле относится к String, StringList или SecureString, второе — к семантике проверки значения. Поэтому тип integer не является четвёртым способом хранения наряду с этими тремя. Шифрование SecureString и проверка формата также не заменяют друг друга: можно получить зашифрованную строку, которая одновременно обязана соответствовать заданному правилу.

Для поддерживаемых списковых вариантов проверяется каждый элемент, а ошибка одного элемента отклоняет запрос целиком. Дополнительный AllowedPattern может сужать допустимое множество значений. Проверка встроенного типа и регулярного ограничения в этом случае должна пройти одновременно. Это позволяет выразить часть правил на границе записи, но не доказывает отсутствие ошибок в логике приложения, которое потом использует конфигурацию.

Что именно получает клиент при чтении

В ответе GetParameter значение Value по-прежнему имеет строковый тип. Вместе с ним возвращаются DataType, версия и другие сведения о параметре. Если записано число 443, приложению всё равно необходимо явно преобразовать строковое представление к нужному числовому типу. Новая проверка при записи не меняет автоматически тип переменной в уже работающей программе.

API также позволяет запрашивать конкретную версию или метку параметра, а WithDecryption относится к расшифровке SecureString. Эти возможности чтения существуют отдельно от ноябрьского расширения проверки. Для перехода поэтому существенны оба конца: какие значения хранилище допускает и что с полученной строкой делает клиент. Объявление не означает, что существующие параметры массово получили новые типы или что конфигурация конкретного сервиса уже проверена без его участия.

Источники

Принципы журнала и исправления.

ERITKOM / НОВЫЙ ПРОЕКТ

Расскажите о задаче и оставьте контакты. Мы свяжемся с вами, чтобы обсудить проект.

  1. 01 Контакты
  2. 02 Ваша задача