Перейти к основному содержимому

Публикация HTTP-сервиса RAT на IIS. Подробная инструкция

Данная инструкция предназначена для тестировщиков и разработчиков, которые впервые работают с публикацией расширений 1С на веб-сервере. Мы рассмотрим весь процесс от установки веб-сервера до проверки работоспособности опубликованного сервиса.

Предварительные требования​

Перед началом работы убедитесь, что у вас есть:

  1. Платформа 1С:Предприятие версии 8.3.20 или выше
  2. Операционная система Windows (для установки IIS)
  3. Права администратора на компьютере
  4. Установленное расширение RAT в информационной базе 1С
  5. Информационная база 1С с установленным расширением

Установка и настройка веб-сервера IIS​

Шаг 1: Установка IIS​

  1. Откройте Панель управления:

    • Нажмите Win + R, введите appwiz.cpl и нажмите Enter
    • Или перейдите в "Панель управления" → "Программы" → "Программы и компоненты"

  2. Включите компоненты Windows:

    • Нажмите "Включение или отключение компонентов Windows" в левой панели
    • Найдите и разверните узел "Службы IIS"

  3. Выберите необходимые компоненты:

    ☑ Службы IIS
  ☑ Веб-сервер
    ☑ Общие функции HTTP
      ☑ Документ по умолчанию
      ☑ Обработка ошибок HTTP
      ☑ Статическое содержимое
    ☑ Разработка приложений
      ☑ CGI
      ☑ ISAPI Extensions
      ☑ ISAPI Filters
    ☑ Безопасность
      ☑ Аутентификация Windows
      ☑ Фильтрация запросов
  ☑ Средства управления
    ☑ Консоль управления IIS

  4. Установите компоненты:

    • Нажмите "ОК" и дождитесь завершения установки
    • Перезагрузите компьютер при необходимости

Шаг 2: Настройка IIS​

  1. Запустите Диспетчер служб IIS:

    • Нажмите Win + R, введите inetmgr и нажмите Enter
    • Или перейдите в "Панель управления" → "Администрирование" → "Диспетчер служб IIS"

  2. Настройте пул приложений:

    • В левой панели разверните узел сервера
    • Выберите "Пулы приложений"
    • Найдите "DefaultAppPool", щелкните правой кнопкой мыши
    • Выберите "Дополнительные параметры"

  3. Установите параметры пула:

    Версия среды .NET Framework: Без управляемого кода
Режим управляемого конвейера: Классический

  4. Настройте сайт по умолчанию:

    • Выберите "Сайты" → "Default Web Site"
    • Щелкните правой кнопкой мыши и выберите "Параметры"
    • Убедитесь, что:
      • Порт: 80
      • IP-адрес: Все не назначенные
      • Путь: C:\inetpub\wwwroot

  5. Проверьте работу IIS:

    • Откройте браузер и перейдите по адресу http://localhost
    • Должна открыться страница приветствия IIS

Установка модуля расширения веб-сервера для 1С​

Шаг 1: Проверка установки компонента​

  1. Запустите установщик 1С:Предприятие
  2. Выберите "Изменить" (если платформа уже установлена)
  3. Убедитесь, что установлен компонент "Модуль расширения веб-сервера": 
    ☑ 1С:Предприятие
  ☑ Сервер 1С:Предприятие
  ☑ Модуль расширения веб-сервера для IIS

Шаг 2: Установка компонента (если не установлен)​

  1. Выберите "Изменить" в установщике 1С
  2. Установите флажок "Модуль расширения веб-сервера для IIS"
  3. Нажмите "Далее" и завершите установку

Публикация расширения RAT на веб-сервере​

Шаг 1: Подготовка к публикации​

  1. Убедитесь, что расширение RAT установлено:

    • Запустите Конфигуратор 1С
    • Перейдите в "Конфигурация" → "Расширения конфигурации"
    • Убедитесь, что расширение "rat" присутствует в списке

  2. Проверьте настройки расширения:

    • Выберите расширение "rat" в списке
    • Убедитесь, что сняты галочки:
      • ❌ Безопасный режим
      • ❌ Защита от опасных действий

Шаг 2: Публикация через Конфигуратор​

  1. Запустите Конфигуратор с правами администратора:

    • Щелкните правой кнопкой мыши на ярлыке Конфигуратора
    • Выберите "Запуск от имени администратора"

  2. Откройте информационную базу с установленным расширением RAT

  3. Перейдите к публикации:

    • В меню выберите "Администрирование" → "Публикация на веб-сервере"

  4. Настройте параметры публикации:

    Имя публикации: rat_service (или любое другое имя латиницей)
Тип веб-сервера: IIS
Каталог: C:\inetpub\wwwroot\rat_service

  5. Установите необходимые флажки:

    ☑ Публиковать доступ для клиентских приложений
☑ Публиковать HTTP сервисы расширений по умолчанию
☑ Публиковать HTTP сервисы расширений

  6. Нажмите "Опубликовать" и дождитесь завершения процесса

Шаг 3: Проверка файлов публикации​

После публикации в каталоге C:\inetpub\wwwroot\rat_service должны появиться файлы:

  • default.vrd - файл настроек публикации

Проверка публикации​

Шаг 1: Проверка веб-клиента​

  1. Откройте браузер и перейдите по адресу:

    http://localhost/rat_service/ru/

  2. Ожидаемый результат:

    • Должна открыться форма авторизации 1С
    • Или веб-клиент 1С (если настроена автоматическая авторизация)

Шаг 2: Проверка HTTP-сервиса RAT​

  1. Проверьте доступность сервиса:

    http://localhost/rat_service/hs/test-api/spec.json

  2. Ожидаемый результат:

    • Должен вернуться JSON с описанием API сервиса
    • Или форма авторизации, если требуется аутентификация

Шаг 3: Проверка через веб-интерфейс спецификации​

  1. Откройте веб-интерфейс спецификации:

    http://localhost/rat_service/hs/test-api/spec-ui

  2. Ожидаемый результат:

    • Должна открыться HTML-страница с документацией API
    • Возможность просмотра всех доступных методов

Устранение типичных проблем​

Проблема 1: Ошибка 500 Internal Server Error​

Причина: Неправильная настройка пула приложений IIS

Решение:

  1. Откройте Диспетчер служб IIS
  2. Выберите пул приложений для вашей публикации
  3. Установите "Версия среды .NET Framework" = "Без управляемого кода"
  4. Перезапустите пул приложений

Проблема 2: Ошибка 404 Not Found​

Причина: Неправильный путь к публикации или отсутствие файлов

Решение:

  1. Проверьте, что файлы публикации находятся в правильном каталоге
  2. Убедитесь, что имя публикации в URL соответствует реальному имени
  3. Проверьте права доступа к каталогу публикации

Проблема 3: Ошибка авторизации​

Причина: Неправильные настройки аутентификации

Решение:

  1. В Диспетчере служб IIS выберите ваш сайт
  2. Дважды щелкните "Аутентификация"
  3. Включите "Анонимная аутентификация"
  4. Убедитесь, что пользователь анонимной аутентификации имеет права на каталог с ИБ

Проблема 4: Сервис недоступен извне​

Причина: Настройки брандмауэра или сетевых параметров

Решение:

  1. Проверьте настройки брандмауэра Windows
  2. Убедитесь, что порт 80 открыт для входящих соединений
  3. Проверьте настройки сетевого адаптера

Безопасность и права доступа​

Настройка прав доступа к каталогу​

  1. Установите права для пользователя анонимной аутентификации:

    Правый клик на каталоге публикации → Свойства → Безопасность
Добавить пользователя: IIS_IUSRS
Права: Чтение и выполнение, Список содержимого папки, Чтение

  2. Настройте права для каталога информационной базы:

    Добавить пользователя: IIS_IUSRS
Права: Полный доступ (для работы с базой данных)

Рекомендации по безопасности​

  1. Используйте HTTPS в продакшн-среде
  2. Настройте аутентификацию для доступа к сервису
  3. Ограничьте доступ по IP-адресам при необходимости
  4. Регулярно обновляйте платформу 1С и расширение RAT
  5. Мониторьте логи веб-сервера и 1С на предмет подозрительной активности

Дополнительные ресурсы​

Примечание: Данная инструкция предназначена для локальной разработки и тестирования. Для продакшн-среды требуются дополнительные настройки безопасности и производительности.