<ws2007FederationHttpBinding>

Artikel
09/12/2008

Eine sichere und vollständig kompatible Bindung, die von <<wsFederationHttpBinding>> abgeleitet ist und Verbundsicherheit unterstützt.

<<system.serviceModel>>
<bindings>
<ws2007FederationHttpBinding>

<ws2007FederationHttpBinding>
    <binding 
        bypassProxyOnLocal="Boolean"
        closeTimeout="TimeSpan" 
        hostNameComparisonMode="StrongWildcard/Exact/WeakWildcard"
        maxBufferPoolSize="integer"
        maxReceivedMessageSize="integer"
        messageEncoding="Text/Mtom" 
                name="string"
        openTimeout="TimeSpan" 
        privacyNoticeAt="Uri"
        privacyNoticeVersion="Integer"
        proxyAddress="Uri" 
        receiveTimeout="TimeSpan"
        sendTimeout="TimeSpan"
        textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/ Utf8TextEncoding"
        transactionFlow="Boolean"
        useDefaultWebProxy="Boolean">
        <security mode="None/Message/TransportWithMessageCredential">
           <message negotiateServiceCredential="Boolean"
                algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/ Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"
                issuedTokenType="string"
                issuedKeyType="SymmetricKey/PublicKey"
           </message>
        </security>
        <reliableSession ordered="Boolean"
           inactivityTimeout="TimeSpan"
           enabled="Boolean" />
        <readerQuotas maxDepth="integer" 
           maxStringContentLength="integer"
           maxByteArrayContentLength="integer"
           maxBytesPerRead="integer"
           maxNameTableCharCount="integer" />
    </binding>
</ws2007FederationBinding>

Attribute und Elemente

Attribute

Attribut	Beschreibung
bypassProxyOnLocal	Ein Wert, der angibt, ob der Proxyserver bei lokalen Adressen umgangen werden soll. Die Standardeinstellung lautet false.
closeTimeout	Ein TimeSpan-Wert, der das Zeitintervall für den Abschluss eines Schließvorgangs angibt. Dieser Wert muss größer oder gleich Zero sein. Der Standardwert ist 00:01:00.
hostnameComparisonMode	Gibt den HTTP-Hostnamen-Vergleichsmodus an, der verwendet wird, um URIs zu analysieren. Dieses Attribut ist vom Typ HostnameComparisonMode und gibt an, ob beim Abgleich des URI der Hostname zum Erreichen des Diensts verwendet wird. Der Standardwert lautet StrongWildcard, wodurch der Hostname beim Abgleich ignoriert wird.
maxBufferPoolSize	Die maximale Pufferpoolgröße dieser Bindung. Der Standardwert ist 524.288 Byte (512 * 1024). Viele Teile von Windows Communication Foundation (WCF) verwenden Puffer. Es ist aufwändig, Puffer bei jeder Verwendung zu erstellen und zu löschen, und die Garbage Collection für Puffer ist ebenfalls aufwändig. Bei Pufferpools können Sie einen zu verwendenden Puffer aus dem Pool nehmen und ihn nach der Verwendung wieder dem Pool zuführen. Auf diese Weise wird der mit dem Erstellen und Zerstören von Puffern verbundene Aufwand vermieden.
maxReceivedMessageSize	Die maximale Nachrichtengröße in Byte einschließlich Header, die in einem für diese Bindung konfigurierten Kanal beim Nachrichtenempfang zulässig ist. Der Absender einer Nachricht, die diesen Grenzwert überschreitet, erhält einen SOAP-Fehler. Der Empfänger verwirft die Nachricht und erstellt im Ablaufverfolgungsprotokoll einen Eintrag zu diesem Ereignis. Der Standardwert ist 65536.
messageEncoding	Definiert den Encoder, der verwendet wird, um die SOAP-Nachricht zu codieren. Folgende Werte sind gültig: Text: Verwenden Sie einen Textnachrichtenencoder. Mtom: Verwendung eines MTOM-Encoders (Message Transmission Organisation Mechanism 1.0). Der Standardwert ist Text. Dieses Attribut ist vom Typ WSMessageEncoding.
name	Der Konfigurationsname der Bindung. Dieser Wert sollte eindeutig sein, da er von der Bindung zur Identifizierung verwendet wird.
openTimeout	Ein TimeSpan-Wert, der das Zeitintervall für den Abschluss eines Öffnungsvorgangs angibt. Dieser Wert muss größer oder gleich Zero sein. Der Standardwert ist 00:01:00.
privactyNoticeAt	Ein URI, an dem sich der Datenschutzhinweis befindet.
privactyNoticeVersion	Die Version des aktuellen Datenschutzhinweises.
proxyAddress	Ein URI, der die Adresse des HTTP-Proxys angibt. Wenn useDefaultWebProxy true ist, muss diese Einstellung NULL lauten. Der Standardwert ist NULL.
receiveTimeout	Ein TimeSpan-Wert, der das Zeitintervall für den Abschluss eines Empfangsvorgangs angibt. Dieser Wert muss größer oder gleich Zero sein. Der Standardwert ist 00:10:00.
sendTimeout	Ein TimeSpan-Wert, der das Zeitintervall für den Abschluss eines Sendevorgangs angibt. Dieser Wert muss größer oder gleich Zero sein. Der Standardwert ist 00:01:00.
textEncoding	Legt die Zeichensatzcodierung fest, die zum Ausgeben von Nachrichten über die Bindung verwendet werden soll. Folgende Werte sind gültig: BigEndianUnicode: Unicode BigEndian-Codierung. Unicode: 16-Bit-Codierung. UTF8: 8-Bit-Codierung. Der Standard ist UTF8. Dieses Attribut ist vom Typ Encoding.
transactionFlow	Ein Wert, der angibt, ob die Bindung geleitete WS-Transaktionen unterstützt. Die Standardeinstellung ist false.
useDefaultWebProxy	Ein Wert, der angibt, ob der automatisch konfigurierte HTTP-Proxy des Systems verwendet wird. Die Proxyadresse muss NULL sein (das heißt, sie ist nicht festgelegt), wenn dieses Attribut den Wert true hat. Die Standardeinstellung ist true.

Untergeordnete Elemente

Element	Beschreibung
<security> von <wsFederationHttpBinding>	Definiert die Sicherheitseinstellungen für die Nachricht. Dieses Element ist vom Typ WSFederationHttpSecurityElement.
<readerQuotas>	Definiert die Beschränkungen der Komplexität von SOAP-Nachrichten, die von Endpunkten verarbeitet werden können, die mit dieser Bindung konfiguriert wurden. Dieses Element ist vom Typ XmlDictionaryReaderQuotasElement.
<reliableSession>-Element	Gibt an, ob zuverlässige Sitzungen zwischen Kanalendpunkten aufgebaut werden.

Übergeordnete Elemente

Element	Beschreibung
<bindings>	Dieses Element enthält eine Auflistung von standardmäßigen und benutzerdefinierten Bindungen. Jeder Eintrag wird durch seinen name identifiziert. Dienste verwenden Bindungen, indem sie sie mithilfe des name verknüpfen.

Hinweise

Ein Verbund zeichnet sich durch die Möglichkeit aus, Identitäten in mehreren Unternehmen oder vertrauenswürdigen Domänen für Authentifizierung und Autorisierung freizugeben. Er verwendet das WS-Trust-Protokoll, um die Identitätsdarstellung von einer vertrauenswürdigen Domäne zu einer anderen zuzuordnen. Eine verbundene HTTP-Bindung unterstützt sowohl SOAP-Sicherheit als auch Sicherheit im gemischten Modus, jedoch keine Transportsicherheit. Mit dieser Bindung konfigurierte Dienste müssen den HTTP-Transport verwenden. Weitere Informationen finden Sie unter <<wsFederationHttpBinding>>.

Beispiel

<configuration>
<system.ServiceModel>
<bindings>
<ws2007FederationHttpBinding>
    <binding name="test"
        bypassProxyOnLocal="false"
        transactionFlow="false"
        hostNameComparisonMode="WeakWildcard"
        maxReceivedMessageSize="1000"
        messageEncoding="Mtom" 
        proxyAddress="http://foo/bar" 
        textEncoding="Utf16TextEncoding"
        useDefaultWebProxy="false">
        <reliableSession ordered="false"
            inactivityTimeout="00:02:00" enabled="true" />
        <security mode="None">
           <message negotiateServiceCredential="false"
                algorithmSuite="Aes128"
                issuedTokenType="http://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#SAMLV1.1" 
                issuedKeyType="PublicKey">
               <issuer address="https://localhost/Sts" />
           </message>
        </security>
    </binding>
</ws2007FederationBinding>
</bindings>
</system.ServiceModel>
</configuration>

Siehe auch

Referenz

<<wsFederationHttpBinding>>
WS2007FederationHttpBinding
WS2007FederationHttpBindingElement

Konzepte

Weitere Ressourcen

Windows Communication Foundation Bindings
Configuring System-Provided Bindings
Using Bindings to Configure Services and Clients

Freigeben über