Тестування безпеки API починається з незручного питання: скільки кінцевих точок надає доступ ваш додаток сьогодні? Не тих, що у вашій специфікації OpenAPI, а тих, які ваш код фактично обслуговує.
Для більшості команд ці два числа не збігаються. Специфікацію було написано кілька місяців тому, код постійно змінювався, а по дорозі з'являлися внутрішні маршрути, кінцеві точки експорту та старі версії, які ніхто не документував. Це тіньові API, і ви не можете протестувати те, про існування чого ніхто не знає.
TL, д-р
Тестування безпеки API у два шари: інвентаризація з коду, підтвердження під час виконання
Ви не можете захистити API, про які не знаєте. Тестування безпеки API починається з надійної інвентаризації, а найнадійнішим джерелом є сам код, а не специфікація.
- Дрейф запасів: Порівняння коду та специфікації виявляє кінцеві точки, які існують, але не задокументовані (тіньові API), та задокументовані операції, які більше нічим не обслуговуються (осиротілі API), обидва під OWASP API9:2023.
- Недоліки обробника: Багато недоліків API не є помилками ін'єкцій. Це відсутня перевірка власності (BOLA), маршрут адміністратора без перевірки ролі або відповідь, яка повертає більше полів, ніж потрібно. Ви найкраще побачите їх, прочитавши обробник.
- Доказ виконання: Тестування під час виконання підтверджує те, що пропонує код: які кінцеві точки відповідають без автентифікації, де ваш шлюз вже компенсує, і що можна експлуатувати в розгорнутому застосунку.
- Одна знахідка на кожну проблему: Разом ці два рівні надають вам один результат для кожної проблеми, відсортований за даними, які він розкриває (особисті, платіжні, стан здоров'я, облікові дані).
Перший крок: створіть свій інвентар API з коду, порівняйте його зі специфікацією OpenAPI, а потім спрямуйте тести під час виконання на повний каталог, а не лише на задокументовану частину.
Чому типове тестування безпеки API є недостатнім
Більшість команд захищають свої API за допомогою трьох елементів: шлюзу, який забезпечує автентифікацію на периферії, сканера, який перевіряє специфікацію, та ручного тестування на проникнення один або два рази на рік. Усі три елементи допомагають, але мають одну спільну сліпу зону.
Усі вони залежать від того, чи хтось знає, які кінцеві точки існують. Сканер перевіряє лише те, що зазначено в специфікації. Пентест охоплює надану йому область дії. А шлюз забезпечує автентифікацію на периферії, але він не бачить, що обробник ніколи не перевіряє, чи належить замовлення 4512 користувачеві, який його запитує.
Ось чому Топ 10 безпеки OWASP API присвячує цілу категорію неправильному управлінню запасами (API9:2023), і чому його ризик номер один — це пошкоджена авторизація на рівні об’єктів (API1): логічний недолік без підпису та шаблону введення.
Рівень 1: інвентаризація API, побудована з коду
Надійне тестування безпеки API починається з інвентаризації, створеної з одного джерела, яке не дрейфує: коду. Безпека API Xygeni перевіряє ваші маніфести залежностей, виявляє веб-фреймворки, які ви використовуєте, та витягує кожну кінцеву точку, включаючи маршрути, оголошені в кількох файлах.
Він читає популярні веб-фреймворки на основних серверних мовах, таких як Spring Boot, ASP.NET Core, Django, FastAPI, Express та Laravel, а також OpenAPI 3.x та специфікації Swagger 2.x. Результатом є каталог сервісів, модулів та кінцевих точок з їхніми методами, параметрами, тілами запитів та формами відповідей.
Якщо код та специфікація знаходяться поруч, дрейф стає очевидним:
- Тіньові API: кінцеві точки, які обслуговує код, але специфікація їх не документує.
- Сиротські API: специфікаційні операції, які більше не обслуговує жоден обробник.
Якщо ви не готові ввімкнути виявлення, режим виявлення самостійно створює каталог та його прогалини. Це гарний спосіб розпочати розмову з командами розробників, не додаючи шуму з першого дня.
Які недоліки ви виявляєте, читаючи обробник
Багато недоліків API не є помилками ін'єкцій: вони є відсутньою перевіркою. Оскільки Xygeni зчитує маршрути, обробники та специфікації разом, він може виявляти недоліки, які сканери на основі шаблонів не можуть. Кожна знахідка відповідає категорії OWASP API Security Top 10 (2023) та CWE.
Недоліки API, які ви виявляєте, читаючи код
Кожен недолік відповідає своїй категорії в Топ 10 безпеки OWASP API, тож висновки говорять тією ж мовою, що й ваші аудитори та експерти з пентестування.
| Недоліки | Що шукає в коді | Категорія OWASP |
|---|---|---|
| Авторизація на рівні пошкодженого об'єктаБОЛА / ІДОР | Кінцеві точки, які завантажують об'єкт за ідентифікатором із запиту, не перевіряючи його приналежність користувачеві | API1 |
| Надмірне викриття даних | Відповіді, які повертають більше полів, ніж потрібно | API3 |
| Авторизація на рівні пошкодженої функції | Маршрути адміністратора без перевірки ролі | API5 |
| Неавтентифіковані кінцеві точки та масове призначення | Відкривати маршрути та запитувати тіла, які приймають поля, які вони не повинні приймати | API2 та API3 |
| Тіньові та осиротілі API | Різниця між кодом та специфікацією | API9 |
Для BOLA аналіз кожної мови перевіряє власність, область видимості репозиторію та прив'язку ідентифікаторів. Він також вирішує правила авторизації, оголошені централізовано у конфігурації вашої платформи, і ви можете додати назви власних функцій перевірки власності, щоб ще більше зменшити шум. API GraphQL отримують власні специфічні перевірки.
Деталь, яка змінює пріоритезацію: кожне поле позначається як особисті, платіжні, дані про стан здоров'я, облікові дані або криптографічні дані. Неавтентифікована кінцева точка, яка повертає особисті дані, вважається критично важливою, а не губиться в черзі за сотнею незначних знахідок.
Рівень 2: тестування під час виконання
Код показує, що може статися. Тестування під час виконання показує, що відбувається. Для повного тестування безпеки API потрібні обидва представлення, і Xygeni поєднує їх через один і той самий інвентар кінцевих точок на трьох рівнях:
- Перевірка безпеки API в режимі реального часу. Він надсилає один неруйнівний запит на кожну кінцеву точку-кандидат для підтвердження або спростування результатів автентифікації. Якщо середовище відповідає 401 або 403, результат позначається як спростований: доказ того, що ваш шлюз вже компенсує це.
- Ксігені DAST. Він тестує роботу веб-програм та API з підписаного образу Docker, який працює у ваших власних середовищах неперевершеної інтеграції (CI runners) або у внутрішній мережі. У робочому середовищі використовується пасивна інтенсивність, яка не надсилає жодних корисних навантажень атаки. Для активного тестування рекомендується використовувати проміжне середовище з тестовим обліковим записом.
- ШІ-тестування на проникнення. Агент штучного інтелекту планує та виконує нешкідливі атаки проти авторизованих цілей, щоб довести, які результати можна використати, відповідно до топ-10 безпеки OWASP API.
Одна проблема, одна знахідка
Цінність поєднання інвентаризації з тестуванням під час виконання полягає не в більшій кількості сповіщень, а в меншій кількості, але якісніших. AI SAST результати роботи обробника, результати роботи DAST на робочій кінцевій точці та недоліки API корелюють між собою. ASPM Графік ризиків із доданими тегами чутливості.
Інвентаризація API з коду та тестування під час виконання
Жоден із рівнів не замінює інший. Повне тестування безпеки API використовує обидва, підключені через один і той самий інвентар кінцевих точок:
| Розмір | Інвентаризація API з коду | Тестування під час виконання |
|---|---|---|
| Коли воно працює | Перед розгортанням, на кожному pull request | Проти розгорнутої програми (проміжна або пасивна у виробництві) |
| Що воно бачить найкраще | Тіньові API, BOLA, відсутні перевірки ролей, викриття даних | Що насправді відповідає, конфігурація середовища, експлуатаційна спроможність |
| Що це дає іншому шару | Повний каталог кінцевих точок для тестування | Підтвердження або спростування того, що пропонує код |
Недолік в обробнику та відкрита кінцева точка, яка його досягає, — це одна проблема з одним власником. І якщо ви вже запускаєте інший інструмент DAST, Xygeni імпортує його результати в те саме подання ризиків, не просячи вас замінити його.
Хочете побачити, як обидва шари працюють разом? Дивіться нашу сесію Від коду до середовища виконання: чому SAST + DAST є важливими для сучасної безпеки додатків, де ми розглянемо, як результати пошуку коду та тести під час виконання підтверджують одне одного.
Як вписати тестування безпеки API у життєвий цикл розробки
Схема, яка найкраще працює для команд середнього розміру, проста:
- На кожному pull request: Безпека API в CI на зміненому коді, а також інкрементальні сканування DAST.
- Перш ніж commit: як pre-commit гейт на проміжних файлах.
- Щоночі або під час злиття: повне DAST-сканування.
- Перед кожним великим релізом: Тестування на проникнення ШІ проти проміжної обробки для перевірки беклогу та підтвердження того, що кожне виправлення закрило діру.
Сканер безпеки API працює будь-де, включаючи середовища з ізоляцією, та звітує до Xygeni SaaS або вашого on-premise платформа. Результати виходять у форматі JSON, SARIF 2.1.0, CSV та Markdown для pull request коментарів.
Тестування безпеки API та відповідність вимогам
Для команд у банківській справі, страхуванні чи державному секторі тестування безпеки API також є доказом. Кожен результат має теги відповідності для Стаття 32 GDPR, PCI DSS 4.0 (вимоги 3.4, 6.4.3, 7.1, 7.2 та 8) та NIST SP 800-53 (AC-3, AC-6, IA-2, IA-5), видимі на платформі та у виводі JSON та SARIF.
Якщо ваша організація підпадає під ДОРА or NIS2, тестування під час виконання надає вам безперервні докази між ручними тестами на проникнення, які все ще потрібні вашим регуляторам.
Тестуйте API, який ви фактично запускаєте, а не той, який ви задокументували
Тестування безпеки API, яке зчитує лише специфікацію, перевіряє API, який, на вашу думку, у вас є, а не той, який ви фактично запускаєте. Почніть з інвентаризації, створеної з коду, підтвердьте її за допомогою тестування під час виконання та ранжуйте кожен недолік за даними, які надає кінцева точка.
Хочете побачити кожну кінцеву точку, яку надає ваш код? Запишіться на сеанс з інженером, щоб створити інвентаризацію API одного з ваших репозиторіїв та переглянути її результати. Або почніть безкоштовне сканування коду та залежностей вже сьогодні!
Поширені запитання
Чи потрібне мені тестування безпеки API, якщо в мене вже є шлюз API?
Так. Шлюз забезпечує автентифікацію на периферії, але він не може бачити відсутню перевірку власності всередині обробника або відповідь, яка повертає забагато полів. Перевірка в реальному часі Xygeni навіть показує, де ваш шлюз вже компенсує, позначаючи ці висновки як спростовані.
Як знайти тіньові або недокументовані API?
Порівняйте те, що обслуговує ваш код, з тим, що задокументовано у вашій специфікації. Xygeni API Security робить це автоматично: він виявляє кінцеві точки з вихідного коду, позначає ті, що відсутні у вашій специфікації OpenAPI або Swagger, як тіньові API, а операції специфікації без обробника позначає як сироти.
Чи безпечно запускати тести під час виконання в умовах продакшену?
З пасивною інтенсивністю Xygeni DAST, так: він не надсилає корисні навантаження атаки, дозволяє обмежувати кількість запитів та ідентифікує свій трафік за допомогою заголовка X-Xygeni-DAST. Для активного тестування та ШІ-пентестування рекомендується проміжне середовище з тестовим обліковим записом.







