Настройка OAuth2 для REST API 1С-Битрикс: безопасная интеграция

Безопасная авторизация внешних приложений

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

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

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

Используется Authorization Code Flow — стандартный грант OAuth2 для серверных приложений (RFC 6749). Схема:

1. Приложение перенаправляет пользователя на https://your-portal.ru/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 в 3 раза надёжнее статичных токенов при атаках перехвата — это подтверждают независимые аудиты безопасности. Кроме того, использование Client Credentials Flow для серверных интеграций дополнительно снижает поверхность атаки. Правильная настройка позволяет экономить до 40% на поддержке интеграции.

Управление жизненным циклом токенов

Refresh-токен позволяет получать новый access-токен без участия пользователя. Главное — своевременно обновлять refresh-токен, так как он выдаётся заново при каждом обновлении. Храните refresh-токен в защищённом месте и реализуйте автоматическое обновление access-токена до истечения срока. Например, в приложении на PHP можно использовать планировщик задач, который каждые 50 минут запрашивает новый access-токен через CURL.

function refreshToken($refreshToken) {
    $ch = curl_init('https://your-portal.ru/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% по сравнению с хранением в переменных окружения.

Типичные ошибки конфигурации

Несовпадение 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 дней

Экономия на поддержке — до 40% при правильной настройке. Свяжитесь с нами, чтобы получить консультацию по вашей интеграции.

Ориентиры по срокам

Стоимость настройки OAuth2 под ключ — от 15 000 до 30 000 рублей в зависимости от сложности. Закажите настройку OAuth2 под ключ — свяжитесь с нами для оценки вашего проекта.

Безопасность сайта на 1С-Битрикс: аудит, защита, мониторинг

Последний серьёзный массовый взлом Битриксов — через уязвимость в модуле vote (BDU:2022-05127). Через неё заливали веб-шеллы пачками. Причина? Владельцы не обновляли ядро по полгода, а модуль голосований стоял «на всякий случай». С тех пор мало что изменилось в подходе: Битрикс выпускает патч, а его ставят через три месяца. Мы выстраиваем комплексную безопасность сайта так, чтобы между выходом патча и его применением проходили дни, а не месяцы. И чтобы даже без патча сайт не лёг от типовой атаки.

Закажите аудит безопасности сайта — получите отчёт с приоритетами и план закрытия уязвимостей за 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 → «Запросить проверку», Яндекс.Вебмастер → «Я всё исправил».

Средняя стоимость восстановления после взлома — от 40 000 до 100 000 руб., а профилактический аудит обходится в 2-3 раза дешевле. Вложив 30 000 руб. в аудит, вы можете сэкономить до 200 000 руб. на ликвидации последствий.

Как защитить сайт на Битриксе от 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. Попадание = потеря трафика.

152-ФЗ и персональные данные

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

Что входит в работу (deliverables)

Сроки

Работаем разово и на абоненте с фиксированным SLA. Для абонентских клиентов — выделенный инженер, который знает проект. Получите консультацию — оценим риски и составим смету за 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 (см. Wikipedia). Комплексная безопасность сайта на Битрикс — это не разовая акция, а непрерывный процесс. Закажите полный аудит безопасности сайта сегодня, чтобы завтра не тратить бюджет на экстренное восстановление. Получите консультацию — мы ответим на любые вопросы.