Dela via

Exchange-protokoll för kontext

  • Artikel

I det här avsnittet beskrivs det protokoll för kontextutbyte som introducerades i Windows Communication Foundation-versionen (WCF) .NET Framework version 3.5. Med det här protokollet kan klientkanalen acceptera en kontext som tillhandahålls av en tjänst och tillämpa den på alla efterföljande begäranden till den tjänsten som skickas via samma klientkanalinstans. Implementeringen av protokollet för kontextutbyte kan använda någon av följande två mekanismer för att sprida kontexten mellan servern och klienten: HTTP-cookies eller ett SOAP-huvud.

Protokollet för kontextutbyte implementeras i ett anpassat kanallager. Kanalen kommunicerar kontexten till och från programskiktet med hjälp av en ContextMessageProperty egenskap. För överföring mellan slutpunkter serialiseras värdet för kontexten antingen som en SOAP-rubrik på kanallagret eller konverteras till eller från meddelandeegenskaperna som representerar en HTTP-begäran och ett HTTP-svar. I det senare fallet förväntas ett av de underliggande kanalskikten konvertera egenskaperna http-begäran och svarsmeddelande till respektive från HTTP-cookies. Valet av den mekanism som används för att utbyta kontexten görs med hjälp av ContextExchangeMechanism egenskapen på ContextBindingElement. Giltig värden är HttpCookie och SoapHeader.

På klienten kan en instans av en kanal fungera i två lägen baserat på inställningarna för kanalegenskapen . Enabled

Läge 1: Kanalkontexthantering

Det här är standardläget där Enabled är inställt på true. I det här läget hanterar kontextkanalen kontexten och cachelagrar kontexten under dess livslängd. Kontext kan hämtas från kanalen via kanalegenskapen IContextManagerGetContext genom att anropa metoden. Kanalen kan också initieras i förväg med specifik kontext innan den SetContext öppnas genom att anropa metoden på kanalegenskapen. När kanalen har initierats med kontext kan den inte återställas.

Följande är en lista över invarianter i det här läget:

  • Alla försök att återställa kontexten med när SetContext kanalen har öppnats genererar en InvalidOperationException.

  • Alla försök att skicka kontext med hjälp ContextMessageProperty av i ett utgående meddelande genererar en InvalidOperationException.

  • Om ett meddelande tas emot från servern med en specifik kontext, när kanalen redan har initierats med en specifik kontext, resulterar detta i en ProtocolException.

    Kommentar

    Det är lämpligt att ta emot en inledande kontext från servern endast om kanalen öppnas utan någon uttrycklig kontextuppsättning.

  • Det ContextMessageProperty inkommande meddelandet är alltid null.

Läge 2: Programkontexthantering

Det här är läget när Enabled är inställt på false. I det här läget hanterar kontextkanalen inte kontexten. Det är programmets ansvar att hämta, hantera och tillämpa kontext med ContextMessagePropertyhjälp av . Alla försök att anropa GetContext eller SetContext resulterar i en InvalidOperationException.

Oavsett vilket läge som väljs stöder IRequestChannelklientkanalfabriken mönster för , IRequestSessionChanneloch IDuplexSessionChannel meddelandeutbyte.

I tjänsten ansvarar en instans av kanalen för att konvertera kontexten som tillhandahålls av klienten på inkommande meddelanden till ContextMessageProperty. Meddelandeegenskapen kan sedan nås av programlagret eller andra kanaler längre upp i anropsstacken. Tjänstkanalerna tillåter också att programskiktet anger ett nytt kontextvärde som ska spridas tillbaka till klienten genom att koppla ett ContextMessageProperty till svarsmeddelandet. Den här egenskapen konverteras till SOAP-huvudet eller HTTP-cookien som innehåller kontexten, vilket beror på bindningens konfiguration. Lyssnaren för tjänstkanalen stöder IReplyChannelmönster för , IReplySessionChanneloch IReplySessionChannel meddelandeutbyte.

Protokollet för kontextutbyte introducerar en ny wsc:Context SOAP-rubrik som representerar kontextinformationen när HTTP-cookies inte används för att sprida kontexten. Schemat för kontextrubriken tillåter valfritt antal underordnade element, var och en med en strängnyckel och stränginnehåll. Följande är ett exempel på en kontextrubrik.

<Context xmlns="http://schemas.microsoft.com/ws/2006/05/context">

<property name="myContext">context-2</property>

</Context>

HttpCookie I läget anges cookies med hjälp av SetCookie rubriken. Cookienamnet är WscContext. Värdet för cookien är Base64-kodningen för wsc:Context rubriken. Det här värdet omges av citattecken.

Värdet för kontexten måste skyddas från ändring under överföring av samma anledning som WS-Adresseringshuvuden skyddas – huvudet används för att avgöra var begäran ska skickas till i tjänsten. Huvudet wsc:Context måste därför vara digitalt signerat eller signerat och krypterat på antingen SOAP- eller transportnivå när bindningen erbjuder meddelandeskyddskapacitet. När HTTP-cookies används för att sprida kontext bör de skyddas med hjälp av transportsäkerhet.

Tjänstslutpunkter som kräver stöd för kontextutbytesprotokollet kan göra det explicit i den publicerade principen. Två nya principkontroller har införts för att representera kravet på att klienten ska stödja protokollet för kontextutbyte på SOAP-nivå eller för att aktivera STÖD för HTTP-cookie. Genereringen av dessa intyg i principen för tjänsten styrs av värdet för ContextExchangeMechanism egenskapen enligt följande:

  • För ContextSoapHeadergenereras följande försäkran:

    <IncludeContext
xmlns="http://schemas.microsoft.com/ws/2006/05/context"  
protectionLevel="Sign" />

  • För HttpCookiegenereras följande försäkran:

    <HttpUseCookie xmlns="http://schemas.xmlsoap.org/soap/http"/>

Se även