<peerAuthentication-element>

Artikel
06/08/2023

Anger autentiseringsalternativ för peer-to-peer-klienter.

Mer information om peer-to-peer-programmering finns i Peer-to-Peer-nätverk.

<Konfiguration>
  <system.serviceModel>
    <Beteenden>
      <endpointBehaviors>
        <Beteende>
          <clientCredentials>
            <Peer>
              <peerAuthentication>

Syntax

<peerAuthentication customCertificateValidatorType="namespace.typeName, [,AssemblyName] [,Version=version number] [,Culture=culture] [,PublicKeyToken=token]"
                    certificateValidationMode="ChainTrust/None/PeerTrust/PeerOrChainTrust/Custom"
                    revocationMode="NoCheck/Online/Offline"
                    trustedStoreLocation="CurrentUser/LocalMachine" />

Attribut och element

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

Attribut

Attribut	Beskrivning
`customCertificateValidatorType`	Valfri sträng. En typ och sammansättning som används för att verifiera en anpassad typ. Det här attributet måste anges när `certificateValidationMode` är inställt på `Custom`.
`certificateValidationMode`	Valfri uppräkning. Anger ett av tre lägen som används för att verifiera autentiseringsuppgifter. Om värdet är `Custom`måste ett `customCertificateValidator` också anges. Standardvärdet är `ChainTrust`.
`revocationMode`	Valfri uppräkning. Ett av de lägen som används för att söka efter en återkallad certifikatlista (CRL). Standardvärdet är `Online`.
`trustedStoreLocation`	Valfri uppräkning. En av de två systemlagringsplatserna: `LocalMachine` eller `CurrentUser`. Det här värdet används när ett tjänstcertifikat förhandlas till klienten. Verifieringen utförs mot det betrodda Personer arkivet på den angivna lagringsplatsen. Standardvärdet är `CurrentUser`.

customCertificateValidatorType-attribut

Värde	Beskrivning
Sträng	Anger typnamnet och sammansättningen och andra data som används för att hitta typen. Minst ett namnområde och ett typnamn krävs. Valfri information omfattar: sammansättningsnamn, versionsnummer, kultur och token för offentlig nyckel.

certificateValidationMode-attribut

Värde	Beskrivning
Uppräkning	Ett av följande värden: `None`, `PeerTrust`, `ChainTrust`, `PeerOrChainTrust`, , `Custom`. Standardvärdet är `ChainTrust`. Mer information finns i Arbeta med certifikat.

revocationMode-attribut

Värde	Beskrivning
Uppräkning	Ett av följande värden: `NoCheck`, `Online`, `Offline`. Standardvärdet är `Online`. Mer information finns i Arbeta med certifikat.

trustedStoreLocation-attribut

Värde	Beskrivning
Uppräkning	Något av följande värden: `LocalMachine` eller `CurrentUser`. Standardvärdet är `CurrentUser`. Om klientprogrammet körs under ett systemkonto är certifikatet vanligtvis under `LocalMachine`. Om klientprogrammet körs under ett användarkonto finns certifikatet vanligtvis i `CurrentUser`.

Underordnade element

Inga.

Överordnade element

Element	Beskrivning
<Peer>	Anger en autentiseringsuppgift som används för att autentisera klienten till en peer-tjänst.

Kommentarer

Elementet <authentication> motsvarar X509PeerCertificateAuthentication klassen . Det här elementet anger en validerare som anropas under autentiseringen från granne till granne i nätet. När en ny peer försöker upprätta en grannanslutning skickar den sina egna autentiseringsuppgifter till den svarande peern. Valideraren för svararen anropas för att verifiera fjärrpartens autentiseringsuppgifter. När en peer-anslutning upprättas i nätet autentiseras båda peer-datorerna ömsesidigt, vilket innebär att validerare i båda ändar anropas.

Exempel

Följande kod anger certifikatverifieringsläget till PeerOrChainTrust.

<behaviors>
  <endpointBehaviors>
    <behavior name="MyEndpointBehavior">
      <clientCredentials>
        <peer>
          <certificate findValue="www.contoso.com"
                       storeLocation="LocalMachine"
                       x509FindType="FindByIssuerName" />
          <peerAuthentication certificateValidationMode="PeerOrChainTrust" />
          <messageSenderAuthentication certificateValidationMode="None" />
        </peer>
      </clientCredentials>
    </behavior>
  </endpointBehaviors>
</behaviors>

Dela via