<security> von <customBinding>

Gibt die Sicherheitsoptionen für eine benutzerdefinierte Bindung an.

<configuration>
  <system.serviceModel>
    <bindings>
      <customBinding>
        <binding>
          <security>

Syntax

<security allowSerializedSigningTokenOnReply="Boolean"
          authenticationMode="AuthenticationMode"
          defaultAlgorithmSuite="SecurityAlgorithmSuite"
          includeTimestamp="Boolean"
          requireDerivedKeys="Boolean"
          keyEntropyMode="ClientEntropy/ServerEntropy/CombinedEntropy"
          messageProtectionOrder="SignBeforeEncrypt/SignBeforeEncryptAndEncryptSignature/EncryptBeforeSign"
          messageSecurityVersion="WSSecurityJan2004/WSSecurityXXX2005"
          requireSecurityContextCancellation="Boolean"
          requireSignatureConfirmation="Boolean"
          securityHeaderLayout="Strict/Lax/LaxTimestampFirst/LaxTimestampLast">
   <issuedTokenParameters />
   <localClientSettings />
   <localServiceSettings />
   <secureConversationBootstrap />
</security>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.

Attribute

authenticationMode-Attribut

defaultAlgorithm-Attribut

Untergeordnete Elemente

Übergeordnete Elemente

Bemerkungen

Weitere Informationen zur Verwendung dieses Elements finden Sie unter SecurityBindingElement Authentication Modes and How to: Create a Custom Binding Using the SecurityBindingElement.

Example

Das folgende Beispiel veranschaulicht, wie Die Sicherheit mithilfe einer benutzerdefinierten Bindung konfiguriert wird. Es zeigt, wie Sie eine benutzerdefinierte Bindung verwenden, um die Sicherheit auf Nachrichtenebene zusammen mit einem sicheren Transport zu ermöglichen. Dies ist nützlich, wenn ein sicherer Transport erforderlich ist, um die Nachrichten zwischen Client und Dienst zu übertragen, und gleichzeitig müssen die Nachrichten auf Nachrichtenebene sicher sein. Diese Konfiguration wird von vom System bereitgestellten Bindungen nicht unterstützt.

Die Dienstkonfiguration definiert eine benutzerdefinierte Bindung, die TCP-Kommunikation mit TLS/SSL-Protokoll und Windows-Nachrichtensicherheit unterstützt. Die benutzerdefinierte Bindung verwendet ein Dienstzertifikat, um den Dienst auf Transportebene zu authentifizieren und die Nachrichten während der Übertragung zwischen Client und Dienst zu schützen. Dies wird durch das <sslStreamSecurity-Bindungselement> erreicht. Das Dienstzertifikat wird mithilfe eines Dienstverhaltens konfiguriert.

Darüber hinaus verwendet die benutzerdefinierte Bindung die Nachrichtensicherheit mit dem Windows-Anmeldeinformationstyp – dies ist der Standardanmeldeinformationstyp. Dies wird durch das Sicherheitsbindungselement erreicht. Client und Dienst werden mithilfe der Sicherheit auf Nachrichtenebene authentifiziert, wenn der Kerberos-Authentifizierungsmechanismus verfügbar ist. Wenn der Kerberos-Authentifizierungsmechanismus nicht verfügbar ist, wird die NTLM-Authentifizierung verwendet. NTLM authentifiziert den Client für den Dienst, authentifiziert den Dienst jedoch nicht für den Client. Das Sicherheitsbindungselement ist für die Verwendung SecureConversation von authenticationType konfiguriert, was zur Erstellung einer Sicherheitssitzung sowohl auf dem Client als auch auf dem Dienst führt. Dies ist erforderlich, um den Duplexvertrag des Diensts für die Arbeit zu aktivieren. Weitere Informationen zum Ausführen dieses Beispiels finden Sie unter Custom Binding Security.

<configuration>
  <system.serviceModel>
    <services>
      <service name="Microsoft.ServiceModel.Samples.CalculatorService"
               behaviorConfiguration="CalculatorServiceBehavior">
        <host>
          <baseAddresses>
            <!-- use following base address -->
            <add baseAddress="net.tcp://localhost:8000/ServiceModelSamples/Service"/>
          </baseAddresses>
        </host>
        <endpoint address=""
                  binding="customBinding"
                  bindingConfiguration="Binding1"
                  contract="Microsoft.ServiceModel.Samples.ICalculatorDuplex" />
        <!-- the mex endpoint is exposed at net.tcp://localhost:8000/ServiceModelSamples/service/mex -->
        <endpoint address="mex"
                  binding="mexTcpBinding"
                  contract="IMetadataExchange" />
      </service>
    </services>
    <bindings>
      <!-- configure a custom binding -->
      <customBinding>
        <binding name="Binding1">
          <security authenticationMode="SecureConversation"
                    requireSecurityContextCancellation="true">
          </security>
          <textMessageEncoding messageVersion="Soap12WSAddressing10"
                               writeEncoding="utf-8" />
          <sslStreamSecurity requireClientCertificate="false" />
          <tcpTransport />
        </binding>
      </customBinding>
    </bindings>
    <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->
    <behaviors>
      <serviceBehaviors>
        <behavior name="CalculatorServiceBehavior">
          <serviceMetadata />
          <serviceDebug includeExceptionDetailInFaults="False" />
          <serviceCredentials>
            <serviceCertificate findValue="localhost"
                                storeLocation="LocalMachine"
                                storeName="My"
                                x509FindType="FindBySubjectName" />
          </serviceCredentials>
        </behavior>
      </serviceBehaviors>
    </behaviors>
  </system.serviceModel>
</configuration>

Siehe auch

• SecurityElement
• SecurityBindingElement
• CustomBinding
• Bindungen
• Erweitern von Bindungen
• Benutzerdefinierte Bindungen
• <Custombinding>
• Vorgehensweise: Erstellen einer benutzerdefinierten Bindung mit dem SecurityBindingElement
• Benutzerdefinierte Bindungssicherheit