NegotiateStream.RemoteIdentity Propriété

Définition

Espace de noms:

System.Net.Security

Assembly:

System.Net.Security.dll

Source:

NegotiateStream.cs

Obtient des informations à propos de l'identité du tiers distant qui partage ce flux authentifié.

public:
 virtual property System::Security::Principal::IIdentity ^ RemoteIdentity { System::Security::Principal::IIdentity ^ get(); };

public virtual System.Security.Principal.IIdentity RemoteIdentity { get; }

member this.RemoteIdentity : System.Security.Principal.IIdentity

Public Overridable ReadOnly Property RemoteIdentity As IIdentity

Valeur de propriété

IIdentity

Objet IIdentity qui décrit l'identité du point de terminaison distant.

Exceptions

InvalidOperationException

L'authentification a échoué ou n'a pas été effectuée.

Exemples

L’exemple de code suivant illustre l’affichage de la valeur de cette propriété.

static void EndAuthenticateCallback( IAsyncResult^ ar )
{
   
   // Get the saved data.
   ClientState^ cState = dynamic_cast<ClientState^>(ar->AsyncState);
   TcpClient^ clientRequest = cState->Client;
   NegotiateStream^ authStream = dynamic_cast<NegotiateStream^>(cState->AuthStream);
   Console::WriteLine( L"Ending authentication." );
   
   // Any exceptions that occurred during authentication are
   // thrown by the EndServerAuthenticate method.
   try
   {
      
      // This call blocks until the authentication is complete.
      authStream->EndAuthenticateAsServer( ar );
   }
   catch ( AuthenticationException^ e ) 
   {
      Console::WriteLine( e );
      Console::WriteLine( L"Authentication failed - closing connection." );
      cState->Waiter->Set();
      return;
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( e );
      Console::WriteLine( L"Closing connection." );
      cState->Waiter->Set();
      return;
   }

   
   // Display properties of the authenticated client.
   IIdentity^ id = authStream->RemoteIdentity;
   Console::WriteLine( L"{0} was authenticated using {1}.", id->Name, id->AuthenticationType );
   cState->Waiter->Set();
}

private static void EndAuthenticateCallback(ClientState cState)
{
    // Get the saved data.
    NegotiateStream authStream = (NegotiateStream)cState.AuthenticatedStream;
    Console.WriteLine("Ending authentication.");

    // Display properties of the authenticated client.
    IIdentity id = authStream.RemoteIdentity;
    Console.WriteLine("{0} was authenticated using {1}.",
        id.Name,
        id.AuthenticationType
    );
}

Remarques

Lorsqu’elle est accessible par le client, cette propriété renvoie un GenericIdentity contenant le nom du principal du service (SPN) du serveur et le protocole d’authentification utilisé. Lorsqu’elle est sollicitée par le serveur, cette propriété retourne un WindowsIdentity qui décrit le client. Si le WindowsIdentity n’est pas disponible, les informations client sont retournées au serveur dans un GenericIdentity.