| Предыдущая версия справа и слева Предыдущая версия | |
| product:settings:system:vault [19.11.2024 07:51] – [Изменения в конфигурационном файле] ekaterina.menkhuzina | product:settings:system:vault [19.11.2024 10:23] (текущий) – [Примеры фрагментов из конфигурационного файла] ekaterina.menkhuzina |
|---|
| * ''path'' - обязательный параметр, путь к секретам. | * ''path'' - обязательный параметр, путь к секретам. |
| ===== Примеры фрагментов из конфигурационного файла ===== | ===== Примеры фрагментов из конфигурационного файла ===== |
| При наличии секции ''<add id=″dbPasswords" version=″″ mountPoint=″″ path=″″/>'' пароли будут считаны из хранилища секретов. При этом названия ключей в хранилище должны соответствовать параметру ''name'' в секции ''connectionStrings''. | В конфигурационном файле ''client.config'' выполняется поиск ключей вида ''{$key$}'' и замена их на значения ''keyValue'', полученные из ''Vault''. |
| |
| При отсутствии ключа какой-либо ''connectionString'', пароль для этой строки подключения считан из хранилища не будет. Пароль, указанный в ''connectionString'', будет заменен паролем из хранилища. Если пароль в ''connectionString'' не задан, то он будет добавлен в строку подключения. | При наличии в секции ''<configuration>'' секции ''<hashiCorpVault address=″″ roleId=″″ secretId=″″ version=″″ mountPoint=″″ path=″″/>'', пароли будут считаны из хранилища секретов как названия ключей и их значений (пары ''key'', ''keyValue''), для последующей замены. |
| | |
| | <callout type="info" icon="true"> Названия ключей в хранилище секретов должны соответствовать всем ''{$key$}'' в заменяемых фрагментах.</callout> |
| | |
| | Проверяются на наличие строк шаблона разделы файла конфигурации: |
| | * настройки приложения - секция ''<appSettings>'', атрибут ''value''; |
| | * настройки [[product:settings:system:active_directory|Active Directory]] - секция ''<adDomains>''/''<domains>'', атрибуты: ''login'', ''password'', ''ldappath''; |
| | * настройки [[product:settings:system:open_id|openIdConnect]] - секция ''<openIdConnect>''/''<providers>'', атрибут ''clientSecret''. |
| |
| Пример фрагмента из ''client.config'': | Пример фрагмента из ''client.config'': |
| <code csharp> | <code csharp> |
| <add id="dbPasswords" version="V2" mountPoint="kv-v2" path="dbPasswords"/> | <configuration> |
| | <hashiCorpVault address="https://vault.yourcompany.ru:8200" roleId="roleId" secretId="secretId" version="V2" mountPoint="kv-v2" path="dbPasswords"/> |
| | …………. |
| | </configuration> |
| ………….. | ………….. |
| <connectionStrings> | <connectionStrings> |
| | <add name="db" providerName="System.Data.SqlClient" connectionString="Server=localhost;Database=b-stable;User ID=SL_APP;Password={$db$};Pooling=true;Max Pool Size=4000; TrustServerCertificate=True" /> |
| <add name="db" providerName="System.Data.SqlClient" connectionString="Server=localhost;Database=b-stable;User ID=SL_APP;Password=123;Pooling=true;Max Pool Size=4000; TrustServerCertificate=True"/> | <add name="dbCubes" providerName="System.Data.SqlClient" connectionString="Server=localhost;Database=b-stable;User ID={$busDB$};Password={$dbCubes$};Pooling=true;Max Pool Size=4000; TrustServerCertificate=True" /> |
| | |
| <add name="dbCubes" providerName="System.Data.SqlClient" connectionString="Server=localhost;Database=b-stable;User ID=SL_APP;Pooling=true;Max Pool Size=4000; TrustServerCertificate=True"/> | |
| </connectionStrings> | </connectionStrings> |
| </code> | </code> |
| |
| <callout type="info" icon="true"> В примере для ''connectionString'' name=″db″, пароль '123', указанный в конфигурации, будет заменен на пароль из хранилища секретов. \\ К остальным строкам подключения будет добавлен пароль из хранилища секретов.</callout> | <callout type="info" icon="true"> В примере для двух ''connectionString'' name=''″db″'' и ''″dbCubes″'', размещены ключи: ''{$db$}'', ''{$busDB$}'', ''{$dbCubes$}'' - они будут заменены на их значения из хранилища секретов.</callout> |
| | |
| При наличии секции ''<add id=″adDomainPasswords″ version=″″ mountPoint=″″ path=″″/>'' пароли будут считаны из хранилища секретов, но выполняется она не при старте приложения, а при действиях, для которых необходима учетная запись [[product:settings:system:active_directory|Active Directory]]. При этом названия ключей в хранилище должны соответствовать параметру name в секции ''domains''. | |
| | |
| Пример фрагмента из ''client.config'': | |
| <code csharp> | |
| <add id="adDomainPasswords" version="V2" mountPoint="kv-v2" path="adDomainPasswords"/> | |
| ……………. | |
| <adDomains> | |
| | |
| <domains> | |
| | |
| <add name="DOMAIN_NAME" login="login" password="password" ldappath="LDAP://DC=domain_name,DC=local"/>; | |
| | |
| </domains> | |
| | |
| </adDomains> | |
| </code> | |
| |
| <callout type="info" icon="true"> В примере для ''domain name''=''″DOMAIN_NAME″'', пароль '''password''' указанный в конфигурации будет заменен на пароль из хранилища секретов.</callout> | |