Параметр 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
        

        Тип параметра: булево значение.