<ws2007FederationHttpBinding>

Artikel
07/07/2023

En säker och samverkande bindning som härleds från <wsFederationHttpBinding> och har stöd för federerad säkerhet.

<Konfiguration>
  <system.serviceModel>
    <Bindningar>
      <ws2007FederationHttpBinding>

Syntax

<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 maxArrayLength="Integer"
                  maxBytesPerRead="Integer"
                  maxDepth="Integer"
                  maxNameTableCharCount="Integer"
                  maxStringContentLength="Integer" />
  </binding>
</ws2007FederationHttpBinding>

Attribut och element

I följande avsnitt beskrivs attribut, underordnade element och överordnade element.

Attribut

Attribut	Beskrivning
`bypassProxyOnLocal`	Ett värde som anger om proxyservern ska kringgås för lokala adresser. Standardvärdet är `false`.
`closeTimeout`	Ett TimeSpan värde som anger tidsintervallet för en stängningsåtgärd som ska slutföras. Det här värdet ska vara större än eller lika med Zero. Standardvärdet är 00:01:00.
`hostNameComparisonMode`	Anger det HTTP-värdnamnsjämförelseläge som används för att parsa URI:er. Det här attributet är av typen HostNameComparisonMode, vilket anger om värdnamnet används för att nå tjänsten vid matchning på URI:n. Standardvärdet är StrongWildcard, som ignorerar värdnamnet i matchningen.
`maxBufferPoolSize`	Den maximala buffertpoolstorleken för den här bindningen. Standardvärdet är 524 288 byte (512 * 1024). Många delar av Windows Communication Foundation (WCF) använder buffertar. Att skapa och förstöra buffertar varje gång de används är dyrt, och skräpinsamling för buffertar är också dyrt. Med buffertpooler kan du ta en buffert från poolen, använda den och returnera den till poolen när du är klar. Därmed undviks arbetet med att skapa och förstöra buffertar.
`maxReceivedMessageSize`	Den maximala meddelandestorleken i byte, inklusive rubriker, som kan tas emot på en kanal som konfigurerats med den här bindningen. Avsändaren av ett meddelande som överskrider den här gränsen får ett SOAP-fel. Mottagaren släpper meddelandet och skapar en post för händelsen i spårningsloggen. Standardvärdet är 65536.
`messageEncoding`	Definierar kodaren som används för att koda meddelandet. Giltiga värden omfattar följande: - Text: Använd en textmeddelandekodare. - Mtom: Använd en MTOM-kodare (Message Transmission Organization Mechanism 1.0). Standardvärdet är Text. Det här attributet är av typen WSMessageEncoding.
`name`	Bindningens konfigurationsnamn. Det här värdet ska vara unikt eftersom det används som en identifiering för bindningen. Från och med .NET Framework 4 krävs inte bindningar och beteenden för att ha ett namn. Mer information om standardkonfiguration och namnlösa bindningar och beteenden finns i Förenklad konfiguration och förenklad konfiguration för WCF-tjänster.
`openTimeout`	Ett TimeSpan värde som anger tidsintervallet för en öppen åtgärd som ska slutföras. Det här värdet ska vara större än eller lika med Zero. Standardvärdet är 00:01:00.
`privacyNoticeAt`	En URI där sekretessmeddelandet finns.
`privacyNoticeVersion`	Versionen av det aktuella sekretessmeddelandet.
`proxyAddress`	En URI som anger adressen till HTTP-proxyn. Om `useDefaultWebProxy` är `true`måste den här inställningen vara `null`. Standardvärdet är `null`.
`receiveTimeout`	Ett TimeSpan värde som anger tidsintervallet för en mottagningsåtgärd som ska slutföras. Det här värdet ska vara större än eller lika med Zero. Standardvärdet är 00:10:00.
`sendTimeout`	Ett TimeSpan värde som anger tidsintervallet för en sändningsåtgärd som ska slutföras. Det här värdet ska vara större än eller lika med Zero. Standardvärdet är 00:01:00.
`textEncoding`	Anger teckenuppsättningens kodning som ska användas för att generera meddelanden på bindningen. Giltiga värden omfattar följande: - BigEndianUnicode: Unicode Big Endian kodning. – Unicode: 16-bitars kodning. - UTF8: 8-bitars kodning. Standardvärdet är UTF8. Det här attributet är av typen Encoding.
`transactionFlow`	Ett värde som anger om bindningen stöder flödande WS-Transactions. Standardvärdet är `false`.
`useDefaultWebProxy`	Ett värde som anger om systemets automatiskt konfigurerade HTTP-proxy används. Proxyadressen måste vara `null` (dvs. inte inställd) om det här attributet är `true`. Standardvärdet är `true`.

Underordnade element

Element	Beskrivning
<Säkerhet>	Definierar säkerhetsinställningarna för meddelandet. Det här elementet är av typen WSFederationHttpSecurityElement.
<readerQuotas>	Definierar begränsningarna för komplexiteten i SOAP-meddelanden som kan bearbetas av slutpunkter som konfigurerats med den här bindningen. Det här elementet är av typen XmlDictionaryReaderQuotasElement.
<reliableSession>	Anger om tillförlitliga sessioner upprättas mellan kanalslutpunkter.

Överordnade element

Element	Beskrivning
<Bindningar>	Det här elementet innehåller en samling standardbindningar och anpassade bindningar.

Kommentarer

Federation är möjligheten att dela identiteter över flera företag eller lita på domäner för autentisering och auktorisering. Det använder WS-Trust-protokollet för att mappa identitetsrepresentationen från en förtroendedomän till en annan. Federerad HTTP-bindning stöder SOAP-säkerhet och säkerhet i blandat läge, men den stöder inte transportsäkerhet. Tjänster som konfigurerats med den här bindningen måste använda HTTP-transporten. Mer information finns i <wsFederationHttpBinding>.

Exempel

<configuration>
  <system.ServiceModel>
    <bindings>
      <ws2007FederationHttpBinding>
        <binding bypassProxyOnLocal="false"
                 transactionFlow="false"
                 hostNameComparisonMode="WeakWildcard"
                 maxReceivedMessageSize="1000"
                 messageEncoding="Mtom"
                 proxyAddress="http://www.contoso.com"
                 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="http://localhost/Sts" />
            </message>
          </security>
        </binding>
      </ws2007FederationHttpBinding>
    </bindings>
  </system.ServiceModel>
</configuration>

Dela via