Sichern von Clients

In Windows Communication Foundation (WCF) schreibt der Dienst die Sicherheitsanforderungen für Clients vor, d. h. der Dienst legt fest, welcher Sicherheitsmodus verwendet wird und ob der Client Anmeldeinformationen angeben muss oder nicht. Der Sicherungsvorgang an einem Client ist also unkompliziert: Man verwendet einfach die vom Dienst erhaltenen Metadaten (sofern diese veröffentlicht wurden) und erstellt einen Client. Die Metadaten geben an, wie der Client konfiguriert wird. Wenn der Dienst erfordert, dass der Client Anmeldeinformationen angibt, müssen Sie Anmeldeinformationen erhalten, die die Anforderung erfüllen. Dieses Thema beschreibt den Vorgang im Detail. Weitere Informationen über zum Erstellen eines sicheren Diensts erhalten Sie unter Sichern von Diensten.

Der Dienst legt die Sicherheit fest

Standardmäßig weisen WCF-Bindungen aktivierte Sicherheitsfunktionen auf. (Die Ausnahme ist BasicHttpBinding.) Wenn der Dienst also über WCF erstellt wird, ist die Wahrscheinlichkeit größer, dass er Sicherheitsmaßnahmen umsetzt, um Authentifizierung, Vertraulichkeit und Integrität zu gewährleisten. In diesem Fall geben die vom Dienst bereitgestellten Metadaten an, was für den Aufbau eines sicheren Kommunikationskanals erforderlich ist. Wenn die Dienstmetadaten keine Sicherheitsanforderungen enthalten, gibt es keine Möglichkeit, einem Dienst ein Sicherheitsschema wie Secure Sockets Layer (SSL) über HTTP aufzuerlegen. Wenn jedoch der Dienst erfordert, dass der Client Anmeldeinformationen liefert, muss der Entwickler, Bereitsteller oder Administrator des Clients genau diejenigen Anmeldeinformationen liefern, die der Client zur Authentifizierung gegenüber dem Dienst nutzen wird.

Erlangen von Metadaten

Beim Erstellen eines Clients besteht der erste Schritt darin, die Metadaten für den Dienst zu erlangen, die der Client für die Kommunikation nutzen wird. Dazu gibt es zwei Möglichkeiten. Erstens: Wenn der Dienst einen Metadatenaustauschendpunkt (MEX-Endpunkt) veröffentlicht oder seine Metadaten über HTTP oder HTTPS zur Verfügung stellt, können Sie die Metadaten mit dem ServiceModel Metadata Utility-Tool (Svcutil.exe) herunterladen, das sowohl Codedateien für einen Client als auch eine Konfigurationsdatei erstellt. (Weitere Informationen über zur Verwendung des Tools finden Sie unter Zugreifen auf Dienste mithilfe eines WCF-Clients.) Wenn der Dienst keinen MEX-Endpunkt veröffentlicht und keine Metadaten über HTTP oder HTTPS zur Verfügung stellt, müssen Sie den Dienstersteller um Dokumentation bitten, die die Sicherheitsanforderungen und die Metadaten beschreibt.

Hinweis:

Sie sollten darauf achten, dass die Metadaten von einer vertrauenswürdigen Quelle stammen und dass sie nicht manipuliert wurden. Über das HTTP-Protokoll abgerufene Metadaten werden im Klartext gesendet und können manipuliert werden. Wenn der Dienst die Eigenschaften HttpsGetEnabled und HttpsGetUrl verwendet, verwenden Sie den URL, den der Dienstersteller geliefert hat, um die Daten über das HTTPS-Protokoll herunterzuladen.

Überprüfen von Sicherheit

Metadatenquellen können in zwei grundlegende Kategorien aufgeteilt werden: vertrauenswürdige Quellen und nicht vertrauenswürdige Quellen. Wenn Sie einer Quelle vertrauen und den Clientcode und andere Metadaten vom sicheren MEX-Endpunkt der Quelle heruntergeladen haben, können Sie den Client erstellen, ihm die korrekten Anmeldeinformationen zuweisen und ihn ohne Bedenken ausführen.

Wenn Sie sich jedoch für ein Herunterladen eines Clients und von Metadaten von einer Quelle entscheiden, über die Sie nur wenig wissen, sollten Sie die vom Code verwendetenSicherheitsmaßnahmen überprüfen. Sie dürfen beispielsweise nicht einfach einen Client erstellen, der Ihre persönlichen oder finanziellen Daten an einen Dienst sendet, sofern der Dienst nicht zumindesten Vertraulichkeit und Integrität erfordert. Sie sollten dem Besitzer des Diensts soweit vertrauen, dass Sie bereit sind, Daten dieser Art an ihn weiterzugeben, da er auf sie zugreifen kann.

Als Regel sollten Sie daher, wenn Sie Code und Metadaten von einer nicht vertrauenswürdigen Quelle verwenden, den Code und die Metadaten überprüfen, um sicherzustellen, dass sie das von Ihnen benötigte Sicherheitsniveau erfüllen.

Festlegen von Clientanmeldeinformationen

Das Festlegen von Clientanmeldeinformationen auf einem Client erfolgt in zwei Schritten:

1. Bestimmen Sie den Typ der Clientanmeldeinformationen, den der Dienst erfordert. Dies wird durch eine der folgenden beiden Methoden erreicht. Erstens: Wenn Sie Dokumentation vom Dienstersteller besitzen, sollte diese den Typ der Clientanmeldeinformation (sofern vorhanden) angeben, der vom Dienst gefordert wird. Zweitens: Wenn Sie nur eine vom Svcutil.exe-Tool erstellte Konfigurationsdatei besitzen, können Sie die einzelnen Bindungen untersuchen, um herauszufinden, welcher Typ von Anmeldeinformationen benötigt wird.

2. Geben Sie tatsächliche Clientanmeldeinformationen an. Die tatsächlichen Clientanmeldeinformationen werden als Wert der Clientanmeldeinformationen bezeichnet, um sie vom Typ zu unterscheiden. Wenn der Typ der Clientanmeldeinformationen beispielsweise ein Zertifikat angibt, müssen Sie ein X.509-Zertifikat bereitstellen, das von einer Zertifizierungsstelle ausgestellt wurde, der der Dienst vertraut.

Bestimmen des Typs der Clientanmeldeinformationen

Wenn Sie die vom Svcutil.exe-Tool erstellte Konfigurationsdatei besitzen, können Sie den Abschnitt <bindings> untersuchen, um festzustellen, welcher Typ von Clientanmeldeinformationen benötigt wird. Innerhalb des Abschnitts befinden sich Bindungselemente, die die Sicherheitsanforderungen angeben. Untersuchen Sie besonders das <Sicherheitselement> jeder Bindung. Zu diesem Element gehört das Attribut mode, das Sie auf einen von drei möglichen Werten festlegen können (Message, Transport oder TransportWithMessageCredential). Der Wert des Attributs bestimmt den Modus, und der Modus legt fest, welches der untergeordneten Elemente von Bedeutung ist.

Das Element <security>``<transport> kann entweder ein <message> - oder ein -Element oder beides enthalten. Das bedeutende Element ist dasjenige, das dem Sicherheitsmodus entspricht. Der folgende Code gibt beispielsweise an, dass der Sicherheitsmodus "Message" und der Typ der Clientanmeldeinformationen für das Element <message> "Certificate" ist. In diesem Fall kann das Element <transport> ignoriert werden. Das Element <message> legt jedoch fest, dass ein X.509-Zertifikat angegeben werden muss.

<wsHttpBinding>
    <binding name="WSHttpBinding_ICalculator">
       <security mode="Message">
           <transport clientCredentialType="Windows" 
                      realm="" />
           <message clientCredentialType="Certificate" 
                    negotiateServiceCredential="true"
                    algorithmSuite="Default" 
                    establishSecurityContext="true" />
       </security>
    </binding>
</wsHttpBinding>

Wenn das Attribut clientCredentialType auf "Windows" festgelegt ist (siehe folgendes Beispiel), müssen Sie keinen tatsächlichen Wert der Anmeldeinformationen liefern. Dies liegt daran, dass die in Windows integrierte Sicherheit die tatsächlichen Anmeldeinformationen (ein Kerberos-Token) der Person liefert, die den Client ausführt.

<security mode="Message">
    <transport clientCredentialType="Windows " 
        realm="" />
</security>

Festlegen des Werts der Clientanmeldeinformationen

Wenn bestimmt wird, dass der Client Anmeldeinformationen liefern muss, müssen Sie die richtige Methode zum Konfigurieren des Clients verwenden. Wenden Sie z. B. zum Festlegen eines Clientzertifikats die Methode SetCertificate an.

Eine gebräuchliche Form von Anmeldeinformationen ist das X.509-Zertifikat. Sie können die Anmeldeinformationen auf zwei Arten bereitstellen:

• Durch Programmieren in Ihren Clientcode (über die Methode SetCertificate).

Durch Hinzufügen eines <behaviors>-Abschnitts für den Client in der Konfiguration und Verwenden des clientCredentials-Elements (siehe unten).

Festlegen eines <clientCredentials->-Werts im Code

Zum Festlegen eines <clientCredentials>-Werts im Code müssen Sie auf die Eigenschaft ClientCredentials der Klasse ClientBase zugreifen. Die Eigenschaft gibt ein ClientCredentials-Objekt zurück, das Zugriff auf verschiedene Typen von Anmeldeinformationen zulässt (siehe Tabelle unten).

Festlegen eines <clientCredentials->-Werts in der Konfiguration

Werte für die Anmeldeinformationen werden angegeben, indem man ein Endpunktverhalten als untergeordnetes Element des <clientCredentials>-Elements verwendet. Das verwendete Element hängt vom Typ der Clientanmeldeinformationen ab. Das folgende Beispiel zeigt beispielsweise die Konfiguration zur Festlegung eines X.509-Zertifikats mit <clientCertificate> of <clientCredentials> Element.

<configuration>
  <system.serviceModel>
    <behaviors>
      <endpointBehaviors>
        <behavior name="myEndpointBehavior">
          <clientCredentials>
            <clientCertificate findvalue="myMachineName" 
            storeLocation="Current" X509FindType="FindBySubjectName" />
          </clientCredentials>
        </behavior>            
    </behaviors>
  </system.serviceModel>
</configuration>

Zum Festlegen der Clientanmeldeinformationen in der Konfiguration, fügen Sie der Konfigurationsdatei ein <endpointBehaviors>-Element hinzu. Zusätzlich muss das hinzugefügte Verhaltenselement über das behaviorConfiguration-Attribut des <endpoint>-Elements mit dem Endpunkt des Diensts verknüpft werden (siehe Beispiel unten). Der Wert des behaviorConfiguration-Attributs muss dem Wert des Verhaltensattributs name entsprechen.

<configuration>

<system.serviceModel>

<client>

<endpoint address="https://localhost/servicemodelsamples/service.svc"

binding="wsHttpBinding"

bindingConfiguration="Binding1"

behaviorConfiguration="myEndpointBehavior"

contract="Microsoft.ServiceModel.Samples.ICalculator" />

</client>

</system.serviceModel>

</configuration>

Hinweis:
Einige der Werte der Clientanmeldeinformationen können nicht über Anwendungskonfigurationsdateien festgelegt werden, u. a. der Benutzername und das Kennwort oder die Werte für den Windows-Benutzer und das Windows-Kennwort. Solche Werte für die Anmeldeinformationen können nur im Code angegeben werden.

Weitere Informationen über zum Festlegen der Clientanmeldeinformationen finden Sie unter Gewusst wie: Angeben der Clientanmeldeinformationswerte.

Hinweis:
ClientCredentialType wird ignoriert, wenn SecurityMode auf "TransportWithMessageCredential" festgelegt wird (siehe Beispielkonfiguration unten).

<wsHttpBinding>
    <binding name="PingBinding">
        <security mode="TransportWithMessageCredential"  >
           <message  clientCredentialType="UserName" 
               establishSecurityContext="false"  
               negotiateServiceCredential="false" />
           <transport clientCredentialType="Certificate"  />
         </security>
    </binding>
</wsHttpBinding>

Siehe auch

Aufgaben

Gewusst wie: Angeben der Clientanmeldeinformationswerte
Vorgehensweise: Angeben des Typs von Clientanmeldeinformationen

Verweis

ClientCredentials
ClientBase
ClientCredentials
HttpsGetEnabled
HttpsGetUrl

Konzepte

Configuration Editor-Tool (SvcConfigEditor.exe)
Sichern von Diensten
Zugreifen auf Dienste mithilfe eines WCF-Clients
ServiceModel Metadata Utility-Tool (Svcutil.exe)

Weitere Ressourcen

<bindings>