SpnEndpointIdentity Classe

Définition

Espace de noms:

System.ServiceModel

Assembly:

System.ServiceModel.Primitives.dll

Paquet:

System.ServiceModel.Primitives v8.0.0

Source:

SpnEndpointIdentity.cs

Représente un nom de principal du service (SPN) pour une identité lorsque la liaison utilise Kerberos.

public ref class SpnEndpointIdentity : System::ServiceModel::EndpointIdentity

public class SpnEndpointIdentity : System.ServiceModel.EndpointIdentity

type SpnEndpointIdentity = class
    inherit EndpointIdentity

Public Class SpnEndpointIdentity
Inherits EndpointIdentity

Héritage

Object

EndpointIdentity

SpnEndpointIdentity

Exemples

Le code suivant présente un moyen standard de créer une instance de cette classe.

static EndpointIdentity CreateIdentity()
 {
     WindowsIdentity self = WindowsIdentity.GetCurrent();
     SecurityIdentifier sid = self.User;

     EndpointIdentity identity = null;

     if (sid.IsWellKnown(WellKnownSidType.LocalSystemSid) ||
         sid.IsWellKnown(WellKnownSidType.NetworkServiceSid) ||
         sid.IsWellKnown(WellKnownSidType.LocalServiceSid))
     {
         identity = EndpointIdentity.CreateSpnIdentity(
             string.Format(CultureInfo.InvariantCulture, "host/{0}", GetMachineName()));
     }
     else
     {
         // Need an UPN string here
         string domain = GetPrimaryDomain();
         if (domain != null)
         {
             string[] split = self.Name.Split('\\');
             if (split.Length == 2)
             {
                 identity = EndpointIdentity.CreateUpnIdentity(split[1] + "@" + domain);
             }
         }
     }

     return identity;
 }

Private Shared Function CreateIdentity() As EndpointIdentity
     Dim self As WindowsIdentity = WindowsIdentity.GetCurrent()
     Dim sid As SecurityIdentifier = self.User

     Dim identity As EndpointIdentity = Nothing

     If sid.IsWellKnown(WellKnownSidType.LocalSystemSid) OrElse sid.IsWellKnown(WellKnownSidType.NetworkServiceSid) OrElse sid.IsWellKnown(WellKnownSidType.LocalServiceSid) Then
         identity = EndpointIdentity.CreateSpnIdentity(String.Format(CultureInfo.InvariantCulture, "host/{0}", GetMachineName()))
     Else
         ' Need an UPN string here
         Dim domain As String = GetPrimaryDomain()
         If domain IsNot Nothing Then
             Dim split() As String = self.Name.Split("\"c)
             If split.Length = 2 Then
                 identity = EndpointIdentity.CreateUpnIdentity(split(1) & "@" & domain)
             End If
         End If
     End If

     Return identity
End Function

Remarques

Un SPN est le nom par lequel un client identifie de manière unique une instance d'un service. Si vous installez plusieurs instances d'un service sur les ordinateurs d'une forêt, chaque instance doit posséder son propre SPN. Une instance de service donnée peut posséder plusieurs noms SPN si les clients peuvent utiliser plusieurs noms pour l'authentification.

Lorsqu'un client souhaite se connecter à un service, il localise une instance du service, compose un SPN pour cette instance et affecte SpnEndpointIdentity à l'identité. Un contrôle permettra de s'assurer que le message est bien destiné à ce service.

Les trois modes d'authentification utilisés sous Kerberos sont :

• SSPINegotiate

• Kerberos

• KerberosOverTransport.

Constructeurs

SpnEndpointIdentity(Claim)	Initialise une nouvelle instance de la classe SpnEndpointIdentity avec la revendication d'identité spécifiée.
SpnEndpointIdentity(String)	Initialise une nouvelle instance de SpnEndpointIdentity avec le nom de principal du service (SPN) spécifié.

Propriétés

IdentityClaim	Obtient la revendication d'identité qui correspond à l'identité. (Hérité de EndpointIdentity)
SpnLookupTime	Spécifie la durée maximale de recherche autorisée pour le nom de principal du service (SPN).

Méthodes

Equals(Object)	Retourne une valeur qui détermine si l'objet spécifié est égal à l'objet d'identité actuel ou s'ils ont des propriétés de sécurité identiques. (Hérité de EndpointIdentity)
GetHashCode()	Fournit un code de hachage pour l'instance actuelle de l'identité. (Hérité de EndpointIdentity)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
Initialize(Claim)	Initialise une EndpointIdentity avec la revendication spécifiée. (Hérité de EndpointIdentity)
Initialize(Claim, IEqualityComparer<Claim>)	Initialise une EndpointIdentity avec la revendication spécifiée et une interface et compare l'égalité. (Hérité de EndpointIdentity)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne l'identité. (Hérité de EndpointIdentity)