Порт, на котором доступен сервис интеграции при работе по протоколу HTTP, задается в параметре WEB_HOST_HTTP_PORT. По умолчанию 27002. Изменять параметры понадобится, например при переносе сервиса на выделенный сервер. Подробнее см. в разделе «Установка сервисов на выделенном сервере».

Максимальное количество конструкций параметров запросов, таких как $filter, $expand, $select и др., задается в параметре MAX_NODE_COUNT. По умолчанию 100. Если нужно использовать большее количество конструкций, то увеличьте значение параметра, чтобы запрос выполнился без ошибок.

По умолчанию браузеры блокируют запросы, отправляемые скриптами от одного домена к другому. Если в одном домене находится сервис интеграции, и к нему нужно обратиться из другого домена, то запрос не выполнится. Чтобы обратиться к сервису интеграции, нужно разрешить в нем такие запросы через механизм CORS. Для этого в Directum Launcher во встроенном редакторе YAML в секцию IntegrationService добавьте параметр CORS_ALLOWED_ORIGINS_LIST и укажите в нем список доменов, с которых разрешено отправлять запросы. Имя каждого домена задается в одинарных кавычках.

Пример настройки:

CORS_ALLOWED_ORIGINS_LIST:

    string:
    -     'http://mydomain1.com'
    -     'http://mydomain2.com'

В конфигураторе Directum Launcher можно выбрать, какие типы аутентификации с сервисом можно использовать, а какие нет:

•AUTH_BASIC_SCHEME_ENABLED – базовая аутентификация;

•AUTH_TOKEN_SCHEME_ENABLED – аутентификация по токенам;

•AUTH_COOKIE_SCHEME_ENABLED – аутентификация на основе Cookies;

•AUTH_NEGOTIATE_SCHEME_ENABLED – аутентификация Kerberos (NTLM).

Если для параметра установлен флажок (true), то тип аутентификации можно использовать, если флажок снят (false) – нельзя.

Пример в config.yml:

AUTH_COOKIE_SCHEME_ENABLED: 'false'

AUTH_TOKEN_SCHEME_ENABLED: 'true'
AUTH_BASIC_SCHEME_ENABLED: 'true'
AUTH_NEGOTIATE_SCHEME_ENABLED: 'false'

При аутентификации с использованием токена необходимо задать сертификат, которым токен будет подписываться. Так сервер сможет проверить, что токен пришел от проверенного источника. Это можно сделать одним из способов:

•Укажите отпечаток сертификата для проверки токена доступа в параметре DATA_PROTECTION_CERTIFICATE_THUMBPRINT.

Пример в config.yml:

DATA_PROTECTION_CERTIFICATE_THUMBPRINT: 'D91C6DB6158213A8DC249AFBDF304115FA9A8591'

•Укажите файл сертификата для проверки токена доступа и пароль к нему. Для этого задайте параметры:

•DATA_PROTECTION_CERTIFICATE_FILE – имя файла сертификата в формате <certificate>.cer;

•DATA_PROTECTION_CERTIFICATE_FILE_PASSWORD – пароль к файлу сертификата.

Пример в config.yml:

DATA_PROTECTION_CERTIFICATE_FILE: 'certificate.cer'

DATA_PROTECTION_CERTIFICATE_FILE_PASSWORD: 'A8DC249AFB'

Помимо сертификата, в в конфигураторе Directum Launcher можно задать параметры:

•AUTHENTICATION_TOKEN_LIFETIME – время жизни выдаваемого токена. Сервер будет считать токен недействительным, когда с момента его выпуска пройдет указанное время. Чем меньше значение параметра, тем меньше времени будет у взломщика, чтобы получить доступ к системе;

•TOKEN_VALIDATION_CLOCK_SKEW – погрешность проверки времени жизни токена. Указанное время добавляется к времени жизни токена и компенсирует разницу системного времени на сервере и клиенте;

•ENCRYPTED_TOKEN – признак необходимости шифрования токена. Используется при выдаче токена сервисом интеграции. Повышает безопасность передачи токена: взломщику придется дешифровать токен перед его изменением;

•TOKEN_VALID_ISSUERS_LIST – список доверенных издателей токенов. Необходимо указывать, если для аутентификации в сервисе используются токены сторонних издателей. Проверку в сервисе пройдут только те токены, издатели которых указаны в списке;

•TOKEN_ADDITIONAL_CERTIFICATES – список сертификатов для проверки токенов от доверенных издателей. Указать сертификат можно одним из способов:

•задайте отпечаток сертификата в параметре CertificateThumbprint;

•задайте файл сертификата и пароль к нему в параметрах CertificateFile и CertificateFilePassword.

Пример в config.yml:

AUTHENTICATION_TOKEN_LIFETIME: '01:00:00:00'

ENCRYPTED_TOKEN: 'true'
TOKEN_VALIDATION_CLOCK_SKEW: value='00:00:10'
TOKEN_VALID_ISSUERS_LIST:
    string:
        - "Codex Team"
        - "GloSign"
TOKEN_ADDITIONAL_CERTIFICATES:
    TokenCertificatesSettings:
        - "@CertificateThumbprint": "d2 5c 6d b6 15 82 13 a8 dc 24 9a fb df 30 41 17 fa 9a 85 91"
        - "@CertificateFile": "cert2.cer"
          "@CertificateFilePassword": "22222"

Для настройки аутентификации доменной учетной записи с использованием протокола LDAP задайте параметры, указанные в разделе «Настройка аутентификации по протоколу LDAP».

Если выполнение прикладного кода с сервиса интеграции передается сервису изолированного кода, то в секции Сервис интеграции (IntegrationService) можно изменить настройки запуска сервиса изолированного кода.

Настройка блокировки IP-адресов

Проверка работоспособности сервисов