Condividi tramite

Procedura: utilizzare un validator di nome utente e password personalizzato

  • Articolo

Per impostazione predefinita, quando per l'autenticazione vengono utilizzati un nome utente e una password, in Windows Communication Foundation (WCF) viene utilizzato Windows per convalidarli. WCF, tuttavia, consente l'utilizzo di schemi personalizzati di autenticazione di nome utente e password, noti come validator. Per incorporare un validator personalizzato di nome utente e password, creare una classe che deriva da UserNamePasswordValidator e configurarla.

Per un'applicazione di esempio, vedere Validator del nome utente e password.

Per creare un validator di nome utente e password personalizzato

  1. Creare una classe che deriva da UserNamePasswordValidator.

    Public Class CustomUserNameValidator
    Inherits UserNamePasswordValidator

    public class CustomUserNameValidator : UserNamePasswordValidator
{

  2. Implementare lo schema di autenticazione personalizzato eseguendo l'override del metodo Validate.

    Non utilizzare il codice contenuto nell'esempio seguente, che esegue l'override del metodo Validate, in un ambiente di produzione. Sostituire il codice con lo schema di convalida di nome utente e password personalizzato, operazione che potrebbe comportare il recupero di coppie di nome utente e password da un database.

    Affinché gli errori di autenticazione vengano restituiti al client, generare una classe FaultException nel metodo Validate.

    ' This method validates users. It allows in two users, test1 and test2 
' with passwords 1tset and 2tset respectively.
' This code is for illustration purposes only and 
' must not be used in a production environment because it is not secure.    
Public Overrides Sub Validate(ByVal userName As String, ByVal password As String)
    If Nothing = userName OrElse Nothing = password Then
        Throw New ArgumentNullException()
    End If

    If Not (userName = "test1" AndAlso password = "1tset") AndAlso Not (userName = "test2" AndAlso password = "2tset") Then
        ' This throws an informative fault to the client.
        Throw New FaultException("Unknown Username or Incorrect Password")
        ' When you do not want to throw an infomative fault to the client,
        ' throw the following exception.
        ' Throw New SecurityTokenException("Unknown Username or Incorrect Password")
    End If

End Sub

    // This method validates users. It allows in two users, test1 and test2 
// with passwords 1tset and 2tset respectively.
// This code is for illustration purposes only and 
// must not be used in a production environment because it is not secure.    
public override void Validate(string userName, string password)
{
    if (null == userName || null == password)
    {
        throw new ArgumentNullException();
    }

    if (!(userName == "test1" && password == "1tset") && !(userName == "test2" && password == "2tset"))
    {
        // This throws an informative fault to the client.
        throw new FaultException("Unknown Username or Incorrect Password");
        // When you do not want to throw an infomative fault to the client,
        // throw the following exception.
        // throw new SecurityTokenException("Unknown Username or Incorrect Password");
    }
}

Per configurare un servizio per l'utilizzo di un validator di nome utente e password personalizzato

  1. Configurare un'associazione che utilizza meccanismi di sicurezza a livello di messaggio su qualsiasi trasporto o meccanismi di sicurezza a livello di trasporto su HTTP(S).

    Quando si utilizza la modalità di sicurezza dei messaggi, aggiungere uno dei binding forniti dal sistema, ad esempio un elemento wsHttpBinding Element o customBinding Element che supporta la modalità di sicurezza dei messaggi e il tipo di credenziale UserName.

    Quando si utilizza la modalità di sicurezza a livello di trasporto su HTTP(S), aggiungere l'elemento wsHttpBinding Element, <basicHttpBinding>, <netTcpBinding> o customBinding Element in cui vengono utilizzati il protocollo HTTP(S) e lo schema di autenticazione Basic.

    Aa702565.note(it-it,VS.100).gifNota:
    Quando si utilizza .NET Framework versione 3.5 o versioni successive, è possibile utilizzare un validator di nome utente e password personalizzato con modalità di sicurezza dei messaggi e del trasporto. Quando si utilizza .NET Framework 3.0, un validator di nome utente e password personalizzato può essere utilizzato solo con la modalità di sicurezza dei messaggi.

    Aa702565.Tip(it-it,VS.100).gifSuggerimento:
    Per ulteriori informazioni sull'utilizzo di <netTcpBinding> in questo contesto, vedere <security> of <netTcpBinding>

    1. Aggiungere un elemento <bindings> al file di configurazione, sotto l'elemento <system.ServiceModel>.

    2. Aggiungere un elemento wsHttpBinding Element o <basicHttpBinding> alla sezione delle associazioni. Per ulteriori informazioni su sulla creazione di un elemento di associazione WCF vedere Procedura: specificare un'associazione al servizio in configurazione.

    3. Impostare l'attributo mode dell'elemento security element of wsHttpBinding o <security> of <basicHttpBinding>MessageTransport su or, TransportWithMessageCredential, .

    4. Impostare l'attributo clientCredentialType dell'elemento message element of wsHttpBinding o <transport> of <wsHttpBinding>.

      Quando si utilizza la modalità di sicurezza dei messaggi, impostare l'attributo clientCredentialType dell'elemento message element of wsHttpBinding su UserName.

      Quando si utilizza la modalità di sicurezza a livello di trasporto su HTTP(S), impostare l'attributo clientCredentialType dell'elemento <transport> of <wsHttpBinding><transport> of <basicHttpBinding>Basic o su .

      Aa702565.note(it-it,VS.100).gifNota:
      Quando un servizio WCF è ospitato in Internet Information Services (IIS) utilizzando la protezione a livello di trasporto e la proprietà UserNamePasswordValidationMode è impostata su Custom, lo schema di autenticazione personalizzato utilizza un sottoinsieme dell'autenticazione di Windows. Questo avviene perché in tale scenario, IIS esegue l'autenticazione di Windows prima di WCF richiamando l'autenticatore personalizzato.

    Per ulteriori informazioni su sulla creazione di un elemento di associazione WCF, vedere Procedura: specificare un'associazione al servizio in configurazione.

    Nell'esempio seguente viene illustrato il codice di configurazione per l'associazione.

    <system.serviceModel> 
  <bindings>
  <wsHttpBinding>
      <binding name="Binding1">
        <security mode="Message">
          <message clientCredentialType="UserName" />
        </security>
      </binding>        
    </wsHttpBinding>
  </bindings>
</system.serviceModel>

  2. Configurare un comportamento che specifica che un validator personalizzato di nome utente e password viene utilizzato per convalidare coppie di nome utente e password per i token di sicurezza UserNameSecurityToken in arrivo.

    1. Aggiungere un elemento <behaviors> come figlio dell'elemento <system.serviceModel>.

    2. Aggiungere una sezione serviceBehaviors section all'elemento <behaviors>.

    3. Aggiungere un elemento <behavior>name e impostare l'attributo su un valore appropriato.

    4. Aggiungere una sezione <serviceCredentials> Element<behavior> all'elemento .

    5. Aggiungere un userNameAuthentication element all'<serviceCredentials> Element.

    6. Impostare userNamePasswordValidationMode su Custom.

      Aa702565.Important(it-it,VS.100).gif Nota:
      Se il valore userNamePasswordValidationMode non è impostato, in WCF viene utilizzata l'autenticazione Windows anziché il validator personalizzato di nome utente e password.

    7. Impostare customUserNamePasswordValidatorType sul tipo che rappresenta il validator personalizzato di nome utente e password.

    Nell'esempio seguente viene illustrato il frammento <serviceCredentials> fino a questo punto.

    <serviceCredentials>
  <userNameAuthentication userNamePasswordValidationMode="Custom" customUserNamePasswordValidatorType="Microsoft.ServiceModel.Samples.CalculatorService.CustomUserNameValidator, service" />
</serviceCredentials>

Esempio

Nel codice di esempio seguente viene dimostrato come creare un validator personalizzato di nome utente e password. Non utilizzare il codice che esegue l'override del metodo Validate in un ambiente di produzione. Sostituire il codice con lo schema di convalida di nome utente e password personalizzato, operazione che potrebbe comportare il recupero di coppie di nome utente e password da un database.

Imports System

Imports System.IdentityModel.Selectors
Imports System.IdentityModel.Tokens

Imports System.Security.Principal

Imports System.ServiceModel

    

    
    ...
    
    

        Public Class CustomUserNameValidator
        Inherits UserNamePasswordValidator
        ' This method validates users. It allows in two users, test1 and test2 
        ' with passwords 1tset and 2tset respectively.
        ' This code is for illustration purposes only and 
        ' must not be used in a production environment because it is not secure.    
        Public Overrides Sub Validate(ByVal userName As String, ByVal password As String)
            If Nothing = userName OrElse Nothing = password Then
                Throw New ArgumentNullException()
            End If

            If Not (userName = "test1" AndAlso password = "1tset") AndAlso Not (userName = "test2" AndAlso password = "2tset") Then
                ' This throws an informative fault to the client.
                Throw New FaultException("Unknown Username or Incorrect Password")
                ' When you do not want to throw an infomative fault to the client,
                ' throw the following exception.
                ' Throw New SecurityTokenException("Unknown Username or Incorrect Password")
            End If

        End Sub
    End Class

using System;
using System.IdentityModel.Selectors;
using System.IdentityModel.Tokens;

using System.Security.Principal;

using System.ServiceModel;

    

    
    ...
    
    

    
        public class CustomUserNameValidator : UserNamePasswordValidator
        {
            // This method validates users. It allows in two users, test1 and test2 
            // with passwords 1tset and 2tset respectively.
            // This code is for illustration purposes only and 
            // must not be used in a production environment because it is not secure.   
            public override void Validate(string userName, string password)
            {
                if (null == userName || null == password)
                {
                    throw new ArgumentNullException();
                }

                if (!(userName == "test1" && password == "1tset") && !(userName == "test2" && password == "2tset"))
                {
                    // This throws an informative fault to the client.
                    throw new FaultException("Unknown Username or Incorrect Password");
                    // When you do not want to throw an infomative fault to the client,
                    // throw the following exception.
                    // throw new SecurityTokenException("Unknown Username or Incorrect Password");
                }
            }
        }

Vedere anche

Attività

Procedura: utilizzare provider di appartenenza ASP.NET

Riferimento

UserNamePasswordValidator

Altre risorse

Autenticazione