Профили внешней интеграции

НАЧАЛО >> API ИРБИС 64/128 >> Профили внешней интеграции📄 Скачать в DOCX

Профиль внешней интеграции описывает, как внешняя система будет использовать API-контракт ИРБИС 128. Это metadata-настройка, а не runtime engine синхронизации.

1. Что хранит профиль

Профиль содержит:

стабильный ключ и название;
внешнюю систему или класс интеграции;
направление обмена: входящее, исходящее или двустороннее;
ссылку на API-контракт и его версию;
transport profile;
security subject или сервисную учетную запись;
ссылки на Secrets;
ссылки на mapping profiles, SyncPolicy и базовые mapping metadata;
idempotency policy;
external id policy;
режим dry-run по умолчанию;
безопасные диагностические признаки.

Значения паролей, tokens, private keys и других секретов в профиле хранить нельзя. Для них используются только ссылки на модуль Secrets.

2. Что не входит в профиль

Профиль не реализует двустороннюю синхронизацию, conflict resolution, retry, dead-letter, webhook delivery или бизнес-логику предметного модуля. Для политики синхронизации используются отдельные записи SyncPolicy и ConflictPolicy.

Эти обязанности распределены так:

EventBus владеет событиями, inbox/outbox и доставкой.
Queue владеет фоновым выполнением, retry, timeout и dead-letter.
Security владеет правами и masking.
FieldConfiguration владеет стабильными field keys.
Workflow* владеет статусами и переходами.
Доменные модули применяют изменения и проверяют бизнес-правила.

3. Проверки

Функция API/ValidateAdapterProfile проверяет обязательные поля профиля, направление обмена, ссылку на APIContract, структуру secretRefs и отсутствие secret values.

Функция API/CheckHealth дополнительно проверяет, что профиль ссылается на существующий контракт и не раскрывает секретные значения в export.

Детальный mapping и реестр ExternalId описаны в разделе Mapping и ExternalId. Политики sync/conflict описаны в разделе SyncPolicy и ConflictPolicy.