Хранение настроек приложений в отдельных файлах#
По умолчанию настройки подключенных приложений хранятся внутри основного конфигурационного файла blitz.conf в блоке настроек blitz.prod.local.idp.apps. Если планируется подключать к Blitz Identity Provider большое число приложений (сотни приложений), то более предпочтительным может быть настроить хранение настроек приложений в отдельных конфигурационных файлах. Для этого нужно:
В каталоге настроек
/usr/share/identityblitz/blitz-configсоздать корневой каталог для хранения настроек приложений (каталог настроек приложений). По умолчанию используется каталог/usr/share/identityblitz/blitz-config/apps.Внутри каталога настроек приложений создать для каждого приложения свой каталог, соблюдая следующие правила:
имя каталога должно быть создано из идентификатора приложения (
appId);если в идентификаторе приложения был символ
/, то его надо заменить на#;если в идентификаторе приложения был символ
:, то его надо заменить на%.
Примечание
Например, для приложения с идентификатором
https://example.comдолжен быть создан каталог с именемhttps%##example.com.Важно
Обязательно должны быть созданы каталоги для служебных приложений
_blitz_console,_blitz_idp,_blitz_reg,_blitz_recovery,_blitz_profile.Внутри каждого каталога приложения должен быть создан файл с именем
app.conf, содержащий конфигурацию приложения из исходногоblitz.conf. Раздел должен называтьсяapp, а не значениеappId, как было вblitz.conf. Внутри каталога приложения также будет создан скрытый каталог.snapshot, куда будут копироваться предыдущие конфигурации приложений в случае изменения настроек приложения через консоль или API.Пример конфигурационного файла
app.conf:########################################################################################## # version: 822 # modified: 2023-08-20 21:17:27 MSK # author: admin # ip: 127.0.0.1 # user agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 … ########################################################################################## { "app": { "domain": "https://company.com", "name": "test app", "oauth": { … }, … } }После миграции всех существующих настроек приложений из
blitz.confв отдельные файлы настроек задать вblitz.confв блокеblitz.prod.local.idp.apps-sourceрежим чтения настроек приложений из отдельных файлов:"apps-source": { "type": "filesystem", "dir": "apps" }
Перезапустить приложения Blitz Identity Provider и проверить корректность работы входа в приложения. Если все работает корректно, то при желании можно удалить настройки приложений из блока
blitz.prod.local.idp.apps.