Поделиться через

Метод ConfigurationSetting — CreateSSLCertificateBinding

  • Статья

Создает привязку TLS/SSL-сертификата.

Синтаксис

Public Sub CreateSSLCertificateBinding(ByVal Application As String, _  
    ByVal CertificateHash As String, ByVal IPAddress As String, _  
    ByVal Port As Int32, ByVal lcid As Int32, _  
    ByRef [Error] As String, ByRef HRESULT As Int32)  

public void CreateSSLCertificateBinding(string application,   
    string certificateHash, string IPAddress, int Port,   
    int lcid, out string error, out int HRESULT);

Параметры

Приложение
Имя приложения, для которого следует создать привязку к сертификату.

CertificateHash
Хэш для сертификата. СертификатHash ожидает хэш нижнего регистра. Если хэш содержит прописные символы, он завершается ошибкой.

IPAddress
IP-адрес для приложения.

порт.
Порт TLS, связанный с привязкой.

Код языка
Локаль, используемая для возвращаемых сообщений об ошибке.

Ошибка
[out] Описание случившихся ошибок.

HRESULT
[out] Значение, которое указывает, окончился ли вызов успехом или сбоем.

Возвращаемое значение

Возвращает значение HRESULT , являющееся признаком успешного или неуспешного завершение вызова метода. Значение 0 указывает, что вызов метода выполнен успешно; Код ошибки указывает, что вызов не был успешным.

Замечания

Этот метод позволяет добавить привязку приложения в файл rsreportserver.config. Если привязка еще не существует в HTTP.SYS, она создается там.

Перед созданием привязки вызов метода проверяет резервирования URL-адресов для указанного приложения, чтобы определить, допустима ли привязка СЕРТИФИКАТА TLS/SSL.

Выполняется проверка следующих условий, результатом которой могут стать ошибки.

  1. Сертификат не существует.

  2. Указанный IPAddress не соответствует IPAddress этого компьютера.

  3. Указанное значение параметра IPAddress является адресом категории DHCP IPAddress (изменение которого происходит периодически). Рекомендуется вместо указанного адреса использовать IP-адрес с подстановочными символами (0.0.0.0).

  4. Указанный IPAddress не соответствует IP-адресу резервирования URL-адресов, а подстановочный знак или резервирование URL-адресов узла отсутствуют.

  5. Резервирование URL-адресов, указывающее имя узла, существует, но имя узла не соответствует имени узла сертификата.

Требования

Пространство имен: root\Microsoft\SqlServer\ReportServer\<InstanceName>\v13\Admin

Связанный контент

элементы MSReportServer_ConfigurationSetting