Параметр vault#

Последовательность параметров vault предназначена для конфигурирования взаимодействия с Системой управления секретами.

enabled

Включает/отключает работу с Системой управления секретами.

Тип параметра:
- true;
- false.
runtime_update

Включает/отключает обновление секретов профиля из Vault при операциях запуска/перезапуска/reload. По умолчанию директива отключена - секреты подтягиваются только в момент конфигурирования профиля.

Тип параметра:
- true;
- false.
auto_update

Включает/отключает обновление секретов в фоновом режиме.

Тип параметра:
- true;
- false.
auto_update_expire_delta

Задает период времени в секундах до истечения срока действия секрета, при котором необходимо выполнить автоматическое обновление секрета.

Тип параметра: целочисленное значение.

По умолчанию:
```
auto_update_expire_delta: 2678400
```
auto_update_type

Задает тип автоматического обновления.

Тип параметра: текстовое значение.
- «expire» - автоматическое обновление происходит по истечении указанного срока действия;
- «always» - автоматическое обновление происходит всегда.
По умолчанию:
```
auto_update_type: expire
```
url

Тип параметра: текстовое значение.
ssl
- enabled
  
  Включение/отключение проверки серверного сертификата secman по предоставленной CA цепочке сертификатов. По умолчанию включен.
  
  Тип параметра:
  - true;
  - false.
- ca
  
  Список доверенных сертификатов для верификации. Обязателен в случае включения проверки серверного сертификата.
  
  Тип параметра: текстовое значение.
Опциональные параметры:
- certificate
  
  Клиентский сертификат.
  
  Используется в случае:
  - certificate_key is not None
  Тип параметра: текстовое значение.
- certificate_key
  
  Ключ клиентского сертификата.
  
  Используется в случае:
  - certificate is not None
  Тип параметра: текстовое значение.
storages

Тип параметра: последовательность параметров и их значения.
- url
  
  Указывает url хранилища для поиска секретов.
- ssl
  
  Указывает сертификат хранилища для поиска секретов.
- path
  
  Обязательный параметр, указывает имя хранилища для поиска секретов (например, «/DEV/SOWA/CF/KV/»).
  
  Тип параметра: текстовое значение.
- approle_role_id_file
  
  Указывает путь к файлу с идентификатором роли approle.
  
  Обязательно в случае:
  - approle_role_id_file is not None.
  Тип параметра: текстовое значение.
- approle_wrapped_token_file
  
  Указывает путь к файлу с идентификатором секрета approle.
  
  Обязательно в случае:
  - approle_role_id_file is not None.
  Тип параметра: текстовое значение.
- approle_wrapped_token_field
  
  Задает имя ключа json, используемого при unwrap токена, содержащего secret_id.
  
  Используется в случае:
  - approle_wrapped_token_file is not None.
  Тип параметра: текстовое значение.
- approle_namespace
  
  Задает approle namespace.
  
  Обязательно в случае:
  - approle_role_id_file is not None.
  Тип параметра: текстовое значение.
- secrets
  - type
    
    Задает тип секрета. Если параметр не указан, по умолчанию используются KV-секреты.
    
    Тип параметра: текстовое значение.
    - sberca;
    - kv.
    Пример работы с типом секрета SberCA приведен в разделе Работа с системой управления секретами.
    
    Значение по умолчанию:
    type: kv
  - base64_decode
    
    Вкл./Откл. декодирование секрета из base64.
    
    Тип параметра:
    - true;
    - false.
    Значение по умолчанию:
    base64_decode: false
  - name
    
    Обязательный параметр, в значении параметра указывается имя секрета.
    
    Тип параметра: текстовое значение.
  - key
    
    В значении параметра указывается ключ секрета.
    
    Обязательно в случае:
    - type: kv;
    - значение параметра type не указано.
    Тип параметра: текстовое значение.
  - certificate_alias
    
    Указывает алиас для выпущенного через SberCA сертификата.
    
    Обязательно в случае:
    type: sberca
    Тип параметра: текстовое значение.
  - key_alias
    
    Указывает алиас для приватного ключа выпущенного через SberCA сертификата.
    
    Обязательно в случае:
    type: sberca
    и
    format: pem
    Тип параметра: текстовое значение.
  - ca_alias
    
    Указывает алиас для цепочки сертификатов, подписавших выпущенный через SberCA сертификат.
    
    Тип параметра: текстовое значение.
  - format
    
    Задает формат выпускаемого сертификата.
    
    Тип параметра: текстовое значение.
    - «pem»;
    - «pem_bundle»;
    - «jks».
    Обязательно в случае:
    type: sberca
  - email
    
    Тип параметра: текстовое значение.
    
    Используется в случае:
    type: sberca
  - alias
    
    В значении параметра указывается алиас секрета.
    
    Обязательно в случае:
    - type: kv;
    - значение параметра type не указано.
    Тип параметра: текстовое значение.
  - common_name
    
    Обязательно в случае:
    type: sberca
    Тип параметра: текстовое значение.
  - alt_names
    
    Альтернативные имена субъектов. Это могут быть имена хостов или адреса электронной почты.
    
    Используется в случае:
    type: sberca
    Тип параметра: текстовое значение.
  - other_sans
    
    Настраиваемые SAN со строкой OID/UTF8. Формат записи соответствует формату OpenSSL: < oid>;< type>:< value>.
    
    Используется в случае:
    type: sberca
    Тип параметра: последовательность текстовых значений.
  - ip_sans
    
    Указывает запрашиваемые IP Subject Alternative Names. Действителен только в том случае, если роль разрешает IP SAN.
    
    Используется в случае:
    type: sberca
    Тип параметра: последовательность текстовых значений.
  - uri_sans
    
    Указывает запрашиваемые URI Subject Alternative Names.
    
    Используется в случае:
    type: sberca
    Тип параметра: последовательность текстовых значений.
  - exclude_cn_from_sans
    
    Если параметр включен, указанный common_name не будет включен в DNS или Email Subject Alternate Names. Полезно, если CN не имена хостов или адреса электронной почты, а человекочитаемый id.
    
    Используется в случае:
    type: sberca
    Тип параметра: булево значение.