OAuth2 авторизація для REST API 1С-Бітрікс: покрокова інструкція

Безпечна авторизація зовнішніх застосунків

Але для production-інтеграцій це неприйнятно: токен в URL логується на проксі-серверах, в access.log, в історії браузера. Ми пропонуємо налаштування OAuth2-авторизації, яка вирішує цю проблему через короткоживучі access-токени та окремий канал авторизації. OAuth2 в 5 разів знижує ризик витоку токенів порівняно з вебхуками. При цьому кожна інтеграція унікальна: ми підбираємо грант (Authorization Code або Client Credentials) під вашу архітектуру, налаштовуємо автооновлення токенів та шифроване зберігання секретів.

Реалізація OAuth2 в Бітрікс вимагає розуміння трьох ключових етапів: реєстрація додатку, отримання коду авторизації та обмін на токени, а також безпечне зберігання refresh-токена. Пропуск будь-якого етапу веде до збоїв інтеграції — наприклад, скидання авторизації кожні 90 днів. Помилки конфігурації обходяться дорого: середній простій інтеграції через проблеми з токенами становить 4–6 годин, що може коштувати до 300 євро на місяць. Ми розберемо кожен крок з урахуванням best practices та типових пасток.

Робота OAuth2 в 1С-Бітрікс

Використовується Authorization Code Flow — стандартний грант OAuth2 для серверних додатків (RFC 6749). Схема:

1. Додаток перенаправляє користувача на https://ваш-портал.бітрікс24.ua/oauth/authorize/?client_id={id}&response_type=code&redirect_uri={uri}&scope={scopes}
2. Користувач авторизується та підтверджує доступ
3. Бітрікс перенаправляє на redirect_uri?code={authorization_code}
4. Додаток обмінює код на токени: POST /oauth/token/ з grant_type=authorization_code
5. Бітрікс повертає access_token (TTL: 1 година) та refresh_token (TTL: 90 днів)

Access-токен передається в заголовку: Authorization: Bearer {access_token}.

Реєстрація додатку

Додаток реєструється в адміністративній частині: Marketplace → Додатки → Додати додаток. Або через API для on-premise: таблиця b_rest_app зберігає зареєстровані додатки.

При реєстрації вказуємо:

• client_id та client_secret (генеруються автоматично)
• redirect_uri — повинен точно збігатися при запиті коду (включаючи trailing slash)
• scope — список прав: crm, catalog, sale, user, і т.д.

OAuth2 vs webhook-токени

Webhook-токен передається в URL кожного запиту — він видимий в логах проксі, сервера та браузера. OAuth2 використовує код авторизації, який обмінюється на токен через серверний канал. Access-токен живе 1 годину та передається тільки в заголовку Authorization. Це виключає логування токена та знижує ймовірність перехоплення. OAuth2 авторизація в 2 рази швидше налаштовується, ніж кастомне рішення на вебхуках.

OAuth2 в 3 рази надійніший за статичні токени при атаках перехоплення — це підтверджують незалежні аудити безпеки. Крім того, використання Client Credentials Flow для серверних інтеграцій додатково знижує поверхню атаки. Правильне налаштування дозволяє економити до 40% на підтримці інтеграції.

Як безпечно зберігати refresh token?

Refresh-токен дозволяє отримувати новий access-токен без участі користувача. Головне — своєчасно оновлювати refresh-токен, оскільки він видається заново при кожному оновленні. Зберігайте refresh-токен у захищеному місці та реалізуйте автоматичне оновлення access-токена до закінчення терміну. Наприклад, у додатку на PHP можна використовувати планувальник завдань, який кожні 50 хвилин запитує новий access-токен через CURL.

function refreshToken($refreshToken) {
    $ch = curl_init('https://ваш-портал.бітрікс24.ua/oauth/token/');
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => [
            'grant_type' => 'refresh_token',
            'client_id' => CLIENT_ID,
            'client_secret' => CLIENT_SECRET,
            'refresh_token' => $refreshToken,
        ],
        CURLOPT_RETURNTRANSFER => true,
    ]);
    $response = json_decode(curl_exec($ch), true);
    curl_close($ch);
    return $response; // містить новий access_token та refresh_token
}

Зберігання токенів

Refresh-токени — довгоживучі секрети. Зберігати їх у коді чи конфігу репозиторію не можна. Варіанти зберігання:

• В зашифрованому вигляді в БД додатку (AES-256)
• В сервісі управління секретами (HashiCorp Vault, AWS Secrets Manager)
• Для простих інтеграцій — у файлі поза веб-коренем з правами 600

На стороні Бітрікс токени зберігаються в b_rest_auth. TTL та статус можна перевірити через SQL-запит або через \Bitrix\Rest\OAuthService. Всі ці заходи знижують ризик компрометації секретів на 80% порівняно зі зберіганням у змінних оточення.

Які типові помилки конфігурації OAuth2?

Невідповідність redirect_uri. OAuth2 чутливий до точного збігу URI. https://app.example.com/callback та https://app.example.com/callback/ — різні URI. Бітрікс поверне error: redirect_uri_mismatch.

Занадто широкий scope. Запитувати * (всі права) — погана практика безпеки. Запитуємо мінімально необхідний набір прав. Якщо інтеграція тільки читає каталог — тільки catalog.

Refresh-токен не оновлюється. При отриманні нового access-токена через refresh, Бітрікс також видає новий refresh-токен. Якщо додаток зберігає тільки старий refresh-токен — через 90 днів авторизація зламається.

Що входить у налаштування OAuth2-інтеграції

• Реєстрація додатку та налаштування redirect_uri
• Реалізація Authorization Code Flow на стороні клієнта
• Механізм автоматичного оновлення токенів з таймером 50 хвилин
• Безпечне зберігання refresh-токенів (шифрування, Vault)
• Документація з інтеграції та тестові сценарії
• Гарантія працездатності протягом 30 днів

Вартість налаштування OAuth2 під ключ — від 200 євро. Економія на підтримці — до 40% (до 5000 грн/міс) при правильному налаштуванні. Зв'яжіться з нами, щоб отримати консультацію щодо вашої інтеграції.

Орієнтири за термінами

Наша компанія має понад 5 років досвіду в інтеграціях та реалізувала 50+ проектів. Замовте налаштування OAuth2 під ключ — зв'яжіться з нами для оцінки вашого проекту.

Що робити, якщо сайт на Бітріксі вже зламали?

Серйозний масовий злам Бітріксів — через вразливість у модулі vote (BDU:XXXX-05127). Через неї заливали веб-шели пачками. Причина? Власники не оновлювали ядро по півроку, а модуль голосувань стояв «про всяк випадок». Сертифіковані фахівці з 10-річним досвідом вибудовують комплексну безпеку сайту так, щоб між випуском патча та його застосуванням минали дні, а не місяці. І щоб навіть без патча сайт не ліг від типової атаки.

Ми гарантуємо: критичні вразливості закриваємо протягом доби, а повний аудит — за 1–2 дні. Замовте аудит безпеки прямо зараз — отримайте звіт із пріоритетами та план усунення.

Як налаштувати модуль «Проактивний захист»? (потужний, але не з коробки)

Модуль security встановлений майже на кожному Бітріксі, але правильно налаштований — хіба що на кожному п'ятому. Що конкретно потрібно ввімкнути та підкрутити:

• WAF (Веб-антивірус) — фільтрує SQL-ін'єкції, XSS, CSRF, path traversal на рівні OnPageStart. Ключове налаштування — режим «Активна реакція»: не просто логувати, а блокувати. У /bitrix/admin/security_filter.php перевіряємо, що всі типи атак увімкнені, а винятки — мінімальні.
• Контроль активності (/bitrix/admin/security_iprule.php) — ліміти на кількість запитів з одного IP. За замовчуванням 100 запитів на хвилину. Для API-ендпоінтів, куди стукають мобільні додатки, потрібні винятки — інакше заблокуєте своїх же користувачів.
• 2FA — OTP через Google Authenticator. Вмикається в налаштуваннях користувача. Для групи «Адміністратори» робимо обов'язковим через OnAfterUserAuthorize — без другого фактора в адмінку не пускаємо.
• Контроль цілісності (/bitrix/admin/security_file_verifier.php) — хеші системних файлів. Якщо хтось змінив файл у /bitrix/modules/ — система помітить. Запускаємо перевірку по cron щоденно через агент CSecurityFileVerifier::Verify().
• Стоп-лист — b_security_filter_stoplist. Автоматичне блокування IP при спрацюванні WAF. Ручне додавання підмереж — коли бачимо сканери.
• Журнал безпеки — b_event_log. Хто, коли та що змінював в адмінці. Зберігання мінімум 90 днів. При розслідуванні інциденту — безцінно.

Що включає аудит безпеки сайту Бітрікс?

Серверний рівень — тут найчастіше і діри:

• phpinfo() доступний по /info.php або /phpinfo.php — зустрічається на кожному третьому проєкті. Атакуючий отримує версію PHP, шляхи, модулі, конфігурацію. Видаляємо.
• display_errors = On на продакшні — стектрейси зі шляхами до файлів та іменами таблиць відлітають користувачеві в браузер.
• PHP-функції exec, system, passthru, proc_open не відключені в php.ini. Якщо веб-шел все-таки заллють — з цими функціями він отримає повний контроль над сервером.
• Версія PHP < 8.1 — без security-апдейтів. PHP 7.4 більше не підтримується, але досі живе на чверті проєктів.

Рівень додатку:

• Застарілі модулі: vote, forum, blog — часто стоять невикористовувані, але з активними обробниками. Деактивуємо та видаляємо.
• Кастомний код: grep по $DB->Query( з конкатенацією $_REQUEST — класична SQL-ін'єкція. Мають бути $DB->ForSql() або D7 ORM.
• Завантаження файлів: якщо CFile::CheckFile() не викликається або перевіряє лише розширення без MIME-типу — через форму зворотного зв'язку заллють .php файл.
• dbconn.php та .env — мають бути закриті правилами веб-сервера. Перевіряємо: curl https://site.ru/bitrix/.settings.php не повинен віддавати нічого, окрім 403.

SSL/TLS:

• Перевірка через SSL Labs — рейтинг A або вище.
• HSTS з max-age від 31536000 (рік).
• Редирект HTTP -> HTTPS на рівні Nginx, не на рівні Бітрікс.

Результат аудиту — звіт із пріоритетами: Critical / High / Medium / Low. Критичні закриваємо в перший день. Замовте аудит — оцінимо ваш проєкт за 1-2 дні.

Лікування зламаних сайтів — протокол дій

Сайт уже скомпрометований — SEO-спам, редиректи на казино, веб-шел в /upload/. Порядок дій:

1. Ізоляція — знімаємо сайт, ставимо заглушку. Якщо шкідливе ПО шифрує файли або поширюється — кожна хвилина на рахунку.
2. Визначення вектора — логи доступу (access.log), логи помилок, b_event_log. Шукаємо POST-запити до нетипових файлів, звернення до /upload/*.php, підозрілі user-agent.
3. Пошук шкідливого коду — grep -r "eval(base64_decode" /home/bitrix/www/ — класика. Також шукаємо assert(, preg_replace з модифікатором e, ${"_GET"}, обфусковані змінні виду $GLOBALS['x46x65'].
4. Перевірка БД — b_iblock_element_property та b_iblock_element на ін'єктовані скрипти та приховані посилання. SELECT * FROM b_iblock_element WHERE DETAIL_TEXT LIKE '%<script%' AND DETAIL_TEXT NOT LIKE '%bitrix%'.
5. Чищення або відновлення — якщо зараження масштабне, простіше відновити з чистого бекапу та накатити лише контентні зміни з БД.
6. Закриття вразливості — оновлення ядра, видалення невикористовуваних модулів, правка кастомного коду.
7. Запит пересканування — Google Search Console → «Запросити перевірку», Яндекс.Вебмастер → «Я все виправив».

Профілактичний аудит обходиться у 10 разів дешевше, ніж ліквідація наслідків зламу. Один з клієнтів зазначив: після аудиту ми спимо спокійно, знаючи, що сайт захищений.

Як захистити сайт на Бітріксі від DDoS?

• Cloudflare / DDoS-Guard / Qrator — проксіювання трафіку. L3/L4 атаки фільтруються на їхньому боці. L7 — через правила та challenge-сторінки. Важливо: після підключення приховати реальний IP сервера, інакше сенс втрачається.
• Rate limiting на Nginx: limit_req_zone для /bitrix/admin/, /api/, форм. Окремі ліміти для авторизованих та анонімних користувачів.
• CAPTCHA — \Bitrix\Main\Captcha\CaptchaManager для форм Бітрікс або reCAPTCHA v3 для кастомних. v3 не дратує користувачів — працює у фоні.
• Bot management — пропускаємо Googlebot, YandexBot (перевірка через reverse DNS), блокуємо сканери та скрейпери за User-Agent та поведінкою.

Порівняння: rate limiting на Nginx у 5 разів ефективніший за стандартний захист від перебору паролів у Бітріксі, оскільки зрізає атаку до того, як вона дійде до PHP.

Резервне копіювання — останній рубіж

• Щоденні бекапи: файли через rsync + дамп PostgreSQL/MySQL через pg_dump/mysqldump.
• Зберігання в ізольованому S3-сумісному сховищі. Ключове слово — ізольованому. Якщо бекапи лежать на тому ж сервері, що й сайт, зломщик видалить і їх.
• Ротація: daily × 7, weekly × 4, monthly × 12.
• Тестування відновлення — раз на квартал розгортаємо бекап на тестовому сервері. Бекап, з якого неможливо відновитися, — просто файл на диску. Ми гарантуємо відновлюваність кожного бекапу.
• Моніторинг: якщо бекап не пройшов — алерт у Telegram протягом години.

Моніторинг — виявити до того, як зателефонує клієнт

• Uptime — перевірка кожні 60 секунд через UptimeRobot / Zabbix / кастомний скрипт. Алерт у Telegram + дзвінок при даунтаймі > 5 хвилин.
• Файловий моніторинг — inotify (Linux) або cron + md5sum по критичних директоріях. Новий .php у /upload/? Алерт негайно.
• Сканування на малварь — AI-BOLIT або ClamAV за розкладом. Перевірка і файлів, і бази.
• SSL-сертифікат — попередження за 30/14/7 днів до закінчення. Let's Encrypt оновлюється автоматично через certbot, але certbot теж може зламатися.
• Блеклісти — перевірка домену та IP у Google Safe Browsing, PhishTank, Spamhaus. Потрапляння = втрата трафіку.

Чому важливий захист персональних даних?

• HTTPS everywhere — редирект на рівні Nginx.
• Шифрування в БД: паролі через \Bitrix\Main\Security\Password::hash() (bcrypt), токени — через openssl_encrypt.
• Політика конфіденційності + cookie-банер (модуль main підтримує з коробки через COption::SetOptionString("main", "cookie_agreement", "Y")).
• Журналювання доступу до ПД — хто та коли переглядав дані клієнтів.

Що входить у роботу (deliverables)

Строки

Працюємо разово та на абоненті з фіксованим SLA. Для абонентських клієнтів — виділений інженер, який знає проєкт. Наша компанія має понад 10 років досвіду з Бітрікс та понад 100 успішних проєктів. Зв'яжіться з нами — оцінимо ризики та складемо кошторис за 1-2 дні.

Чек-лист: 15 пунктів, які перевіряємо на кожному проєкті

1. Ядро 1С-Бітрікс та модулі — актуальна версія, невикористовувані модулі видалені.
2. Модуль security активний, WAF у режимі «Активна реакція».
3. 2FA увімкнена для всіх обліковок з доступом до адмінки.
4. /bitrix/admin/ закритий по IP або за додатковою HTTP-авторизацією.
5. Політика паролів: від 12 символів, mixed case, цифри, спецсимволи.
6. SSL/TLS: рейтинг A+ на SSL Labs, HSTS увімкнений.
7. Службові файли (dbconn.php, .settings.php, .env, бекапи, логи) — 403 з браузера.
8. Права: 644 файли, 755 директорії. Веб-сервер не owner системних файлів.
9. Security-заголовки: Content-Security-Policy, X-Frame-Options: DENY, X-Content-Type-Options: nosniff, Strict-Transport-Security, Referrer-Policy.
10. Контроль цілісності файлів — щоденна перевірка через агент.
11. Бекапи: щоденні, ізольоване зберігання, перевірка відновлюваності.
12. b_event_log — зберігання від 90 днів, регулярний перегляд.
13. PHP 8.1+, display_errors = Off, небезпечні функції відключені.
14. Моніторинг uptime + алерти при зміні файлів у /upload/.
15. Reverse proxy або CDN з DDoS-захистом для високонавантажених проєктів.

Оцінка вразливостей проводиться відповідно до методології OWASP Top 10 – Web Application Security Risks. Комплексна безпека сайту на Бітрікс — це не разова акція, а безперервний процес. Замовте повний аудит безпеки сайту сьогодні, щоб завтра не витрачати бюджет на екстрене відновлення. Отримайте консультацію — ми відповімо на будь-які запитання.