<transport> av <netHttpBinding>

Artikel
06/08/2023

Definierar egenskaper som styr autentiseringsparametrar för HTTP-transporten.

<Konfiguration>
  <system.serviceModel>
    <Bindningar>
      <netHttpBinding>
        <Bindande>
          <Säkerhet>
            <Transport>

Syntax

<netHttpBinding>
  <binding>
    <security mode="None|Transport|Message|TransportWithMessageCredential|TransportCredentialOnly">
      <transport clientCredentialType="None|Basic|Digest|Ntlm|Windows"
                 proxyCredentialType="None|Basic|Digest|Ntlm|Windows"
                 realm="string">
        <extendedProtectionPolicy policyEnforcement="Never|WhenSupported|Always"
                                  protectionScenario="TransportSelected|TrustedProxy">
          <customServiceNames>
          </customServiceNames>
        </extendedProtectionPolicy>
      </transport>
    </security>
  </binding>
</netHttpBinding>

Attribut och element

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

Attribut

Attribut	Beskrivning
clientCredentialType	– Anger vilken typ av autentiseringsuppgifter som ska användas vid klientautentisering med HTTP-autentisering. Standardvärdet är `None`. Det här attributet är av typen HttpClientCredentialType.
proxyCredentialType	– Anger vilken typ av autentiseringsuppgifter som ska användas vid klientautentisering inifrån en domän med hjälp av en proxy via HTTP. Det här attributet gäller endast när `mode` attributet för det överordnade `security` elementet är `Transport` eller `TransportCredentialsOnly`. Det här attributet är av typen HttpProxyCredentialType.
Sfären	En sträng som anger sfären som används av HTTP-autentiseringsschemat för sammanfattad eller grundläggande autentisering. Standardvärdet är en tom sträng.
policyEnforcement	Den här uppräkningen anger när ExtendedProtectionPolicy ska tillämpas. 1. Aldrig – Principen tillämpas aldrig (utökat skydd är inaktiverat). 2. WhenSupported – Principen framtvingas endast om klienten stöder utökat skydd. 3. Always – Principen tillämpas alltid. Klienter som inte stöder Utökat skydd kan inte autentiseras.
protectionScenario	Den här uppräkningen anger det skyddsscenario som tillämpas av principen.

clientCredentialType-attribut

Värde	Beskrivning
Ingen	Meddelanden skyddas inte under överföringen.
Basic	Anger grundläggande autentisering.
Sammandrag	Anger sammanfattad autentisering.
Ntlm	Anger NTLM-autentisering när det är möjligt och om Windows-autentiseringen misslyckas.
Windows	Anger windowsintegrerad autentisering.

proxyCredentialType-attribut

Värde	Beskrivning
Ingen	– Meddelanden skyddas inte under överföringen.
Basic	Anger grundläggande autentisering enligt definitionen i RFC 2617 – HTTP-autentisering: Grundläggande och sammanfattad autentisering.
Sammandrag	Anger sammanfattad autentisering enligt definitionen i RFC 2617 – HTTP-autentisering: Grundläggande och sammanfattad autentisering.
Ntlm	Anger NTLM-autentisering när det är möjligt och om Windows-autentiseringen misslyckas.
Windows	Anger windowsintegrerad autentisering.
Certifikat	Utför klientautentisering med ett certifikat. Det här alternativet fungerar bara om `Mode` attributet för det överordnade `security` elementet är inställt på Transport och inte fungerar om det är inställt på TransportCredentialOnly.

Underordnade element

Ingen

Överordnade element

Element	Beskrivning
<Säkerhet>	Definierar säkerhetsfunktionerna <för netHttpBinding>.

Exempel

I följande exempel visas användningen av SSL-transportsäkerhet med den grundläggande bindningen. Som standard stöder den grundläggande bindningen HTTP-kommunikation.

<system.serviceModel>
  <services>
    <service type="Microsoft.ServiceModel.Samples.CalculatorService"
             behaviorConfiguration="CalculatorServiceBehavior">
      <endpoint address=""
                binding="netHttpBinding"
                bindingConfiguration="Binding1"
                contract="Microsoft.ServiceModel.Samples.ICalculator" />
    </service>
  </services>
  <bindings>
    <netHttpBinding>
      <!-- Configure basicHttpBinding with Transport security -->
      <!-- mode and clientCredentialType set to None. -->
      <binding name="Binding1">
        <security mode="Transport">
          <transport clientCredentialType="None"
                     proxyCredentialType="None">
            <extendedProtectionPolicy policyEnforcement="WhenSupported"
                                      protectionScenario="TransportSelected">
              <customServiceNames>
              </customServiceNames>
            </extendedProtectionPolicy>
          </transport>
        </security>
      </binding>
    </netHttpBinding>
  </bindings>
</system.serviceModel>

Dela via