Procedura: creare un'applicazione componente ASP.NET

In questo scenario i modelli di Visual Studio WIF e FedUtil vengono utilizzati per creare un sito Web ASP.NET che consente di accedere alle attestazioni dell'utente corrente tramite IClaimsPrincipal. A tale scopo, FedUtil aggiunge infatti ClaimsPrincipalHttpModule al progetto. Il modulo consente di convertire l'oggetto IPrincipal dell'utente corrente in un oggetto IClaimsPrincipal.

In Visual Studio creare un sito Web ASP.NET in grado di riconoscere attestazioni, come illustrato in Sito Web ASP.NET in grado di riconoscere attestazioni.

Fare quindi clic con il pulsante destro del mouse sul progetto in Esplora soluzioni e scegliere Aggiungi riferimento a STS:

Verrà eseguito lo strumento FedUtil. Verrà visualizzata la finestra di dialogo FedUtil, a partire dalla pagina Procedura guidata di Federation Utility:

In questa pagina è necessario compilare due campi:

1. Posizione di configurazione applicazione: specificare il percorso del file web.config per il sito Web ASP.NET. Se si esegue FedUtil dall'esterno di Visual Studio, questo campo è vuoto. Se si esegue FedUtil dall'interno di Visual Studio, questo campo già contiene il percorso del file web.config per il progetto. Il file web.config deve già esistere ed essere nello stato predefinito (ovvero, come è stato generato da Visual Studio). Se si esegue FedUtil più di una volta nello stesso file web.config, FedUtil sovrascrive semplicemente il contenuto aggiunto al file web.config.

2. URI applicazione: specificare l'URI per il sito Web ASP.NET. Se si esegue FedUtil dall'esterno di Visual Studio, questo campo è vuoto. Se si esegue FedUtil dall'interno di Visual Studio, questo campo contiene già due URI per il progetto: uno che utilizza localhost e uno che utilizza il nome di dominio completo per il computer, se disponibile. Se l'URI non è sicuro (ovvero, non inizia con "https://"), viene visualizzato un avviso quando si fa clic su Avanti.

Dopo avere immesso le informazioni, fare clic su Avanti. Verrà visualizzata la pagina Servizio token di protezione:

Selezionare Nessun servizio token di protezione e quindi fare clic su Avanti. Verrà visualizzata la pagina di riepilogo:

Fare clic su Fine.

Aprire ora il file default.aspx.cs e notare le prime due righe del metodo Page_Load:

IClaimsPrincipal claimsPrincipal = Page.User as IClaimsPrincipal; IClaimsIdentity claimsIdentity = ( IClaimsIdentity )claimsPrincipal.Identity;

Il codice restante elenca semplicemente le attestazioni per l'utente corrente e i rispettivi valori.