Керування скануванням AI для репозиторіїв через REST API у публічному прев'ю
Головне за 30 секунд
- Додано налаштування repository_scan до існуючих кінцевих точок AI Scan для роботи через REST API.
- Функція дозволяє розгортати сканування за допомогою сценаріїв та інфраструктури як код.
- Налаштування працює за аналогією до параметру pr_scan та споживає кредити GitHub Code Security AI.
Зміст
Нові можливості REST API для AI Scan
GitHub оголосив про вихід публічного прев'ю, яке дозволяє вмикати або вимикати сканування AI для репозиторіїв на рівнях організації та окремих репозиторіїв за допомогою REST API. Це дозволяє автоматизувати розгортання за допомогою сценаріїв та інфраструктури як код замість зміни налаштувань вручну.
Для керування використовується нова властивість repository_scan у кінцевих точках активації AI Scan:
- GET та PATCH /orgs/{org}/code-scanning/ai-scan
- GET та PATCH /repos/{owner}/{repo}/code-scanning/ai-scan
Умови роботи та правила успадкування налаштувань
Нове налаштування функціонує аналогічно до існуючої опції pr_scan для сканування запитів на злиття. Якщо організація вимикає сканування AI для репозиторіїв, її репозиторії не можуть його активувати. Якщо організація вмикає цю функцію, репозиторії успадковують налаштування з можливістю індивідуальної відмови.
У разі, якщо політика підприємства забороняє AI Scan, запити на його активацію повертають помилку 422. Користувачі можуть оновлювати pr_scan та repository_scan в одному запиті; якщо будь-яка зміна блокується, запит повертає помилку 422, і жодне налаштування не змінюється.
Активація AI Scan для репозиторіїв не запускає сканування автоматично. Користувачі з правами на запис продовжують запускати сканування на вимогу, і кожне сканування витрачає кредити GitHub Code Security AI.
Доступність та обмеження функції
Керувати налаштуваннями на рівні організації можуть власники організацій та менеджери з безпеки. Адміністратори репозиторіїв можуть вимикати функцію для окремих репозиторіїв. Функція доступна для публічних репозиторіїв організацій, а також для приватних чи внутрішніх репозиторіїв з GitHub Code Security або GitHub Advanced Security.
Власники підприємств повинні попередньо дозволити AI Scan у політиці підприємства. Сервер GitHub Enterprise Server наразі не підтримується.
Що це означає на практиці
Для розробників та спеціалістів з безпеки це оновлення спрощує масове керування налаштуваннями сканування через REST API та інфраструктуру як код. Варто перевірити поточні політики підприємства та організацій перед масовим впровадженням і стежити за подальшими оновленнями платформи щодо розширення підтримки.
