README_PATCH.md

Версия модуля: 1.20.0
Дата патча: 2025-11-14
Автор: Claude Code
Проект: pim-drupal

🎯 Проблема

Модуль CML Exchange не работает с Basic Authentication когда Drupal находится за reverse proxy (Nginx → Apache → PHP).

Причина:
Модуль ожидает переменные $_SERVER['PHP_AUTH_USER'] и $_SERVER['PHP_AUTH_PW'], но при работе через Nginx/Apache эти переменные не устанавливаются. Вместо этого доступна только $_SERVER['HTTP_AUTHORIZATION'] с закодированными credentials.

✅ Решение

Модифицирован метод baseAuthUser() в файле src/Service/CheckAuth.php для поддержки парсинга заголовка HTTP_AUTHORIZATION.

Исправленный код

private function baseAuthUser() {
  $user = FALSE;

  // Парсинг HTTP_AUTHORIZATION заголовка
  if (isset($_SERVER['HTTP_AUTHORIZATION'])) {
    $auth = [];
    if (preg_match('/Basic\s+(.*)$/i', $_SERVER['HTTP_AUTHORIZATION'], $auth)) {
      [$auth_name, $auth_pass] = explode(':', base64_decode($auth[1]));
      $user = [
        'name' => $auth_name,
        'pass' => $auth_pass,
      ];
    }
  }

  return $user;
}

📦 Установка патча

Вариант 1: Применить вручную

nano web/modules/contrib/cmlexchange/src/Service/CheckAuth.php

drush cr

Вариант 2: Использовать готовый патченный модуль

cp -r cmlexchange-patched /path/to/drupal/web/modules/contrib/cmlexchange

drush cr

🔧 Настройка интеграции

1. Конфигурация модуля

drush config:set cmlexchange.settings auth 1 -y
drush config:set cmlexchange.settings auth-user '1c_exchange' -y
drush config:set cmlexchange.settings auth-pass '1C_Exchange_2025_Strong' -y
drush config:set cmlexchange.settings cmlmigrations 1 -y
drush config:set cmlexchange.settings debug 1 -y
drush cr

2. Создание пользователя Drupal

drush user:create 1c_exchange \
  --mail='1c@0kt.ru' \
  --password='1C_Exchange_2025_Strong'

drush user:role:add administrator 1c_exchange

3. Настройка Nginx (если используется)

location / {
    proxy_pass http://backend;
    proxy_set_header Authorization $http_authorization;
    proxy_pass_header Authorization;
}

sudo nginx -t
sudo systemctl reload nginx

🧪 Тестирование

Тест 1: CheckAuth

curl -u "1c_exchange:1C_Exchange_2025_Strong" \
  "https://your-domain.com/cmlexchange?type=catalog&mode=checkauth"

success
catalog
<UUID>

Тест 2: Список сессий

curl -u "1c_exchange:1C_Exchange_2025_Strong" \
  "https://your-domain.com/cmlexchange?type=catalog&mode=init"

zip=no
file_limit=95000000
sessid=<SESSION_ID>
version=3.1

📋 Полная конфигурация CML Exchange

Сохранённая конфигурация находится в файле cmlexchange_config.yaml:

auth: 1                                    # Аутентификация включена
debug: 1                                   # Debug режим
auth-user: 1c_exchange                     # Логин
auth-pass: 1C_Exchange_2025_Strong         # Пароль
auth-ip: ''                                # IP фильтр (пусто = все)
zip: 0                                     # ZIP сжатие отключено
file-path: cml                             # Папка для файлов
file-limit: 95000000                       # Лимит размера файла (95MB)
cmlmigrations: 1                           # Миграции включены

🔗 Интеграция с 1С УНФ 3

Настройки в 1С

Путь:
Главное → Интеграция → Обмен с сайтом

URL (изменения):  https://your-domain.com/cmlexchange
URL (полная):     https://your-domain.com/cmlexchange/full
Логин:            1c_exchange
Пароль:           1C_Exchange_2025_Strong

Процесс обмена

📁 Структура файлов модуля

cmlexchange-patched/
├── README_PATCH.md                          # Эта документация
├── cmlexchange_config.yaml                  # Конфигурация
├── src/
│   └── Service/
│       └── CheckAuth.php                    # ✅ ИСПРАВЛЕН
├── cmlexchange.info.yml
├── cmlexchange.routing.yml
└── ...

🔄 Обновление модуля

ВНИМАНИЕ: При обновлении модуля через Composer патч будет перезаписан!

Как сохранить патч при обновлении:

cd web/modules/contrib/cmlexchange
git diff > /path/to/library/drupal/cmlexchange-http-auth.patch

cd web/modules/contrib/cmlexchange
patch -p1 < /path/to/library/drupal/cmlexchange-http-auth.patch

{
  "extra": {
    "patches": {
      "drupal/cmlexchange": {
        "Fix HTTP_AUTHORIZATION parsing": "patches/cmlexchange-http-auth.patch"
      }
    }
  }
}

🆘 Troubleshooting

Ошибка: "auth error"

Решение:
1. Проверьте Nginx конфигурацию (proxy_set_header Authorization)
2. Проверьте что патч применён (см. код метода baseAuthUser)
3. Проверьте логи: drush watchdog:show

Ошибка: "No session id"

chmod 777 web/sites/default/files/cml
chown www-data:www-data web/sites/default/files/cml

Ошибка при импорте

drush en cmlmigrations -y
drush cmlmigrations:rebuild
drush cr

📊 История изменений

📞 Поддержка

Дата	Версия	Описание
2025-11-14	1.0	Первая версия патча для HTTP_AUTHORIZATION

Проект: pim-drupal
Workspace: /opt/claude-workspace
Документация: projects/pim-drupal/management/

CML Exchange Module - Патч для Basic Auth