Gewusst wie: Angeben der Clientanmeldeinformationswerte

Artikel
09/12/2008

Wenn Sie Windows Communication Foundation (WCF) verwenden, können Sie angeben, wie ein Client für den Dienst authentifiziert wird. Sie können beispielsweise festlegen, dass der Client mit einem Zertifikat für den Dienst authentifiziert wird. In diesem Beispiel wird der Sicherheitsmodus wird auf "Transport" und der Clientanmeldeinformationstyp wird auf "Certificate" eingestellt.

Der Vorgang erfolgt in drei Schritten:

Der Entwickler des Dienstes bestimmt den Anmeldeinformationstyp, den der Client angeben muss.
Der Entwickler des Clients verwendet das ServiceModel Metadata Utility Tool (Svcutil.exe), um die Metadaten des Dienstes (Dienstclientcode und Konfigurationsdatei) abzufragen.
Der Entwickler des Clients erstellt die Clientanwendung und stellt einen Anmeldeinformationswert im Code oder in der Konfiguration bereit, der mit dem Anmeldeinformationstyp (gemäß Metadaten) übereinstimmt.

Dienstcode

So legen Sie den Clientanmeldeinformationstyp für den Dienst im Code fest

Fügen Sie dem Code die folgenden Verweise hinzu.
Erstellen Sie eine Instanz einer Bindung. In diesem Beispiel wird der Wert NetTcpBinding verwendet.
Legen Sie wie erforderlich den Sicherheitsmodus fest. In diesem Beispiel wird der Modus auf Transport festgelegt.
Legen Sie wie erforderlich den ClientCredentialType auf eine Anmeldeinformation fest. In diesem Beispiel wird der Typ auf ein Zertifikat festgelegt.
Erstellen Sie mit dem Diensttyp im Konstruktor eine Instanz von ServiceHost. Der Einfachheit halber wird der Code, der die Dienstschnittstelle und die Implementierung zeigt, hier nicht dargestellt.
Legen Sie den Anmeldeinformationswert für den Dienst fest. In diesem Beispiel wird die SetCertificate-Methode der X509CertificateRecipientServiceCredential-Klasse verwendet.

So legen Sie den Clientanmeldeinformationstyp für den Dienst in der Konfiguration fest

Fügen Sie dem <bindings>-Element eine entsprechende Bindung hinzu. In diesem Beispiel wird die Datei <netTcpBinding Element> verwendet.
Fügen Sie der Bindung eine <security> of <netTcpBinding> hinzu. Achten Sie darauf, für das erforderliche name-Attribut einen geeigneten Wert festzulegen.
Legen Sie für das mode-Attribut einen geeigneten Wert fest. In diesem Beispiel wird der Modus "Message" verwendet.
Fügen Sie wie erforderlich ein Transport- oder Nachrichtenelement zur Sicherheitsbindung hinzu. In diesem Beispiel wird die Datei <message> element of <netTcpBinding> verwendet.

Legen Sie das clientCredential-Attribut auf den gewünschten Anmeldeinformationstyp fest. In diesem Beispiel wird "Certificate" verwendet.

<bindings>
  <netTcpBinding>
    <binding name="TcpBindingWithCredential">
      <security mode="Message">
        <message clientCredentialType="Certificate" />
      </security>
    </binding>
  </netTcpBinding>
</bindings>

Wenn Sie das Endpunktelement erstellen, verwenden Sie den bindingConfiguration-Attributswert, um die Bindungskonfiguration wie im folgenden Code dargestellt festzulegen.

<endpoint address="myEndpointAddress"
          binding="netTcpBinding"
          bindingConfiguration="TcpBindingWithCredential"
             name="netTcpBinding_ICalculator"
          contract="Microsoft.ServiceModel.Samples.ICalculator" />

Clientcode

Die folgenden Vorgänge zeigen, wie Sie den Clientanmeldeinformationswert für den Client im Code und in der Konfiguration festlegen können. Dabei wird davon ausgegangen, dass Sie das ServiceModel Metadata Utility Tool (Svcutil.exe) verwendet haben, um die Metadaten (Code und Konfiguration) vom Dienst zurückzugeben. Weitere Informationen finden Sie unter Gewusst wie: Erstellen eines Windows Communication Foundation-Clients.

So legen Sie den Clientanmeldeinformationswert für den Client im Code fest

Verwenden Sie das ServiceModel Metadata Utility Tool (Svcutil.exe), um den Code und die Konfiguration aus dem Dienst zu generieren.
Erstellen Sie mit dem generierten Code eine Instanz des WCF-Clients.
Legen Sie für die Clientklasse die ClientCredentials-Eigenschaft der ClientBase-Klasse auf einen geeigneten Wert fest. In diesem Beispiel wird die Eigenschaft auf ein X.509-Zertifikat mit der SetCertificate-Methode der X509CertificateInitiatorClientCredential-Klasse festgelegt.

Sie können jede beliebige Enumeration der X509FindType-Klasse verwenden. Der Betreffname wird hier verwendet, für den Fall, dass das Zertifikat (aufgrund des Ablaufdatums) geändert wird. Anhand des Betreffnamens kann die Infrastruktur das Zertifikat wieder suchen.

So legen Sie den Clientanmeldeinformationswert für den Client in der Konfiguration fest

Fügen Sie dem <behaviors>-Element ein <behavior> of <endpointBehaviors>-Element hinzu.
Fügen Sie dem <behaviors>-Element ein <serviceCredentials>-Element hinzu. Achten Sie darauf, für das erforderliche name-Attribut einen geeigneten Wert festzulegen.
Fügen Sie dem <clientCredentials>-Element ein <clientCertificate> of <serviceCredentials>-Element hinzu.

Legen Sie für die folgenden Attribute geeignete Werte fest: storeLocation, storeName, x509FindType und findValue, wie im folgenden Code dargestellt. Weitere Informationen zu Zertifikaten finden Sie unter Verwenden von Zertifikaten.

<behaviors>
   <endpointBehaviors>
      <behavior name="endpointCredential">
        <clientCredentials>
          <clientCertificate findValue="Contoso.com" 
                             storeLocation="LocalMachine"
                             storeName="TrustedPeople"
                             x509FindType="FindBySubjectName" />
        </clientCredentials>
      </behavior>
   </endpointBehaviors>
</behaviors>

Wenn Sie den Client konfigurieren, legen Sie das Verhalten fest, indem Sie das behaviorConfiguration-Attribut des <endpoint>-Elements festlegen, wie im folgenden Code dargestellt. Das Endpunktelement ist dem <client>-Element untergeordnet. Geben Sie auch den Namen der Bindungskonfiguration an, indem Sie das bindingConfiguration-Attribut auf die Bindung für den Client festlegen. Wenn Sie eine generierte Konfigurationsdatei verwenden, wird der Name der Bindung automatisch erstellt. In diesem Beispiel lautet der Name "tcpBindingWithCredential".
```
<client>
  <endpoint name =""
            address="net.tcp://contoso.com:8036/aloha"
            binding="netTcpBinding"
            bindingConfiguration="tcpBindingWithCredential"
            behaviorConfiguration="credentialBehavior" />
</client>
```

Siehe auch

Freigeben über

Gewusst wie: Angeben der Clientanmeldeinformationswerte

Dienstcode

So legen Sie den Clientanmeldeinformationstyp für den Dienst im Code fest

So legen Sie den Clientanmeldeinformationstyp für den Dienst in der Konfiguration fest

Clientcode

So legen Sie den Clientanmeldeinformationswert für den Client im Code fest

So legen Sie den Clientanmeldeinformationswert für den Client in der Konfiguration fest

Siehe auch

Aufgaben

Referenz

Konzepte

Weitere Ressourcen

Zusätzliche Ressourcen