Единый security-паттерн для HTTP-интеграций

Директивный

Правило

Новые и переводимые HTTP-интеграции используют один общий reusable-модуль с единым способом аутентификации, интроспекцией токенов и XDTO-валидацией входных параметров. Каждая интеграция не изобретает свою схему авторизации и разбора тела.

Минимальный контракт модуля:

Аутентификация — единая точка: интроспекция/валидация токена (или JWT) до бизнес-логики. Запрос без валидного токена → 401/403, дальше не проходит.
Авторизация — выполнение от технического пользователя с минимальной ролью (Use на конкретный сервис/метод).
Валидация входа — параметры тела проверяются по XDTO-схеме/контракту до использования; невалидное тело → 400, а не исключение в середине обработки.
Идемпотентность — см. обработчики обмена.
Логирование — диагностически значимые события в ЖР, без секретов и чувствительных тел запросов.

Зачем

Разрозненные самописные точки входа — источник дыр в безопасности и неконтролируемого разбора данных. Единый модуль делает поведение всех интеграций одинаковым, проверяемым на ревью и переиспользуемым.

Правильно

// Обработчик HTTP-сервиса: каждая интеграция изобретает свою схему
Функция ЗаказыPOST(Запрос)

    // Разбор тела ДО аутентификации — невалидный JSON уронит обработчик
    Данные = ПрочитатьJSON(Новый ЧтениеJSON(Запрос.ПолучитьТелоКакСтроку()));

    // Самописная «авторизация»: секрет в константе, сравнение строкой
    Если Данные.Токен <> Константы.СекретТокенаЗаказов.Получить() Тогда
        Возврат Новый HTTPСервисОтвет(403);
    КонецЕсли;

    // Дальше бизнес-логика работает с непроверенной структурой
    Возврат ОбработатьЗаказ(Данные);

КонецФункции

// Обработчик HTTP-сервиса: вся защита — в общем модуле, обработчик тонкий
Функция ЗаказыPOST(Запрос)

    // 1. Аутентификация до всего: интроспекция токена, при отказе — 401/403
    Контекст = ИнтеграцииБезопасность.ПроверитьАвторизацию(Запрос, "Заказы.POST");
    Если Не Контекст.Авторизован Тогда
        Возврат ИнтеграцииБезопасность.ОтветОтказ(Контекст); // тело не читалось
    КонецЕсли;

    // 2. Валидация тела по XDTO-контракту, невалидное тело → 400
    Данные = ИнтеграцииБезопасность.ПроверитьТелоXDTO(
        Запрос, "http://schemas.example.org/orders", "Заказ");
    Если Данные = Неопределено Тогда
        Возврат ИнтеграцииБезопасность.Ответ400("Тело не соответствует контракту");
    КонецЕсли;

    // 3. Сюда доходит только авторизованный запрос с валидными данными
    Возврат ОбработатьЗаказ(Данные);

КонецФункции

Общий модуль (ИнтеграцииБезопасность в примере) — один на конфигурацию: новая интеграция подключает его, а не копирует код. Логирование отказов внутри модуля — в ЖР, без токенов и тел запросов.

Когда не применять

Исключений нет: любая точка входа HTTP-интеграции проходит через общий security-контракт. Внутренние вызовы без внешней границы — вне области стандарта.

Единый security-паттерн для HTTP-интеграций

Правило

Зачем

Правильно

Когда не применять

См. также