Compartilhar via

Método de ConfigurationSetting – CreateSSLCertificateBinding

  • Artigo

Cria uma associação de certificado TLS/SSL.

Sintaxe

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);

Parâmetros

Aplicativo
O nome do aplicativo para o qual a associação de certificado deve ser criada.

CertificateHash
O hash para o certificado. O certificateHash espera um hash em minúsculas. Se o hash contiver caracteres maiúsculos, apresentará falha.

EndereçoIP
O endereço IP para o aplicativo.

Porta
A porta TLS relacionada à associação.

Lcid
A localidade a ser usada para as mensagens de erro retornadas.

Erro
[fora] A descrição dos erros ocorridos.

HRESULT
[out] Valor que indica se a chamada obteve êxito ou falhou.

Valor retornado

Retorna um HRESULT indicando êxito ou falha da chamada do método. Um valor 0 indica que a chamada do método foi bem-sucedida; um código de erro indica que a chamada não foi bem-sucedida.

Comentários

Este método adiciona uma associação a rsreportserver.config para o aplicativo. Caso ainda não exista uma associação em HTTP.SYS, ela será criada ali.

Antes de criar a associação, a chamada de método examina as Reservas de Url referentes ao aplicativo especificado a fim de determinar se a Associação de certificado TLS/SSL é válida.

As seguintes condições são validadas e podem resultar em erros:

  1. O certificado não existe.

  2. O valor IPAddress especificado não corresponde a um IPAddress deste computador.

  3. O IPAddress especificado é um IPAddress DHCP (muda periodicamente) – no lugar dele, use o endereço IP curinga (0.0.0.0).

  4. O IPAddress especificado não corresponde ao endereço IP de uma reserva de URL, tampouco existe uma reserva de URL com nome de host ou curinga.

  5. Uma reserva de URL que especifica que existe um nome de host, mas o nome de host não corresponde ao nome de host do certificado.

Requisitos

Namespace: root\Microsoft\SqlServer\ReportServer\<InstanceName>\v13\Admin

Conteúdo relacionado