Delen via

Methode ConfigurationSetting - CreateSSLCertificateBinding

Hiermee maakt u een TLS/SSL-certificaatbinding.

Syntaxis

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

Parameterwaarden

Application
De naam van de toepassing waarvoor de certificaatbinding moet worden gemaakt.

CertificateHash
De hash voor het certificaat. Het certificaatHash verwacht een hash in kleine letters. Als de hash hoofdletters bevat, mislukt deze.

IPAddress
Het IP-adres voor de toepassing.

port
De TLS-poort die is gekoppeld aan de binding.

Lcid
De landinstelling die moet worden gebruikt voor de geretourneerde foutberichten.

Error
[uit] De beschrijving van de fouten die zijn opgetreden.

HRESULT
[uit] Waarde die aangeeft of de aanroep is geslaagd of mislukt.

Retourwaarde

Hiermee wordt een HRESULT geretourneerd die aangeeft dat de methodeaanroep is geslaagd of mislukt. Een waarde van 0 geeft aan dat de methode-aanroep is geslaagd; een foutcode geeft aan dat de aanroep niet is geslaagd.

Opmerkingen

Met deze methode wordt een binding toegevoegd aan rsreportserver.config voor de toepassing. Als er nog geen binding bestaat in HTTP.SYS, wordt er een gemaakt.

Voordat de binding wordt gemaakt, onderzoekt de methode-aanroep de URL-reserveringen voor de opgegeven toepassing om te bepalen of de TLS/SSL-certificaatbinding geldig is.

De volgende voorwaarden worden gevalideerd en kunnen leiden tot fouten:

  1. Het certificaat bestaat niet.

  2. Het opgegeven IPAddress komt niet overeen met een IPAddress van deze computer.

  3. Het opgegeven IPAddress is een DHCP IPAddress (wijzigingen periodiek) - gebruik in plaats daarvan het IP-adres met jokertekens (0.0.0.0).

  4. Het opgegeven IPAddress komt niet overeen met het IP-adres van een URL-reservering EN een jokerteken of een hostnaam-URL-reservering.

  5. Er bestaat een URL-reservering die een hostnaam opgeeft, maar de hostnaam komt niet overeen met de hostnaam van het certificaat.

Requirements

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

Verwante inhoud

  • Last updated on