How to Use ADFS to Implement Single Sign-On for an ASP.NET MVC Application

Transcription

1 How to Use ADFS to Implement Single Sign-On for an ASP.NET MVC Application With Azure s Access Control service retiring next month, I needed to find another way to use an on-premise Active Directory account without changing the current login process I already set up. Without using any complex code logic, I leveraged Microsoft s Single Sign-On (SSO) on my existing ASP.NET MVC web application. Introduction Thanks to Microsoft s Active Directory Federation Services (AD FS), implementing Single Sign-On (SSO) is now a whole lot easier! Here is my solution to implement SSO using ASP.NET MVC, AD FS and the OnPremise Active Directory account. AD FS is an enterprise-level identity and access management service. Because it runs as a separate service, any application that supports WS-Federation and Security Assertion Markup Language (SAML) can leverage this authentication service. Where to use this solution? This article shows how to use an on-premise Active Directory account services to securely login a domain user on an external ASP.NET MVC application. This

2 eliminates the need to create and maintain different login credentials for different applications. This solution can also be used in desktop and mobile applications. Here, I used a preconfigured AD FS Single Sign-On. Before I created the ASP.NET MVC application, I added our URL as a Relying Party Trust on the server where the AD FS is configured. If this is running on a client machine, ask a system admin to perform the steps below. Adding a Relying Party Trust Log into the server where AD is installed. Open the Server Manager Dashboard. Under Tools choose AD FS Management. Choose Add Relying Party Trust

3 Click Start.

4 Choose the option Enter data about relying party manually and click Next Add the display name as Example Enterprise AD FS and click Next/ Choose the AD FS profile option and click Next.

5 Click Next. Click Next.

6 Under Relying party trust identifier add your application s website. Click Add and then click Next. The website needs to have an SSL certificate and https as the navigation path. The AD FS will only communicate through https context. For demo purposes, we have an IIS Express development certificate.

7 Click Next.

8 Click Next. Click Next.

9 Close the wizard.

10 In the new popup window, click Add Rule. Choose the Claim rule template as Send LDAP Attributes as Claims and click Next. Add a Claim rule name (my example here is Example Enterprise Claim ) Select Active Directory as the Attribute Store.

11 Configure the LDAP attributes to outgoing claim types. Add the above four LDAP attributes and their corresponding outing claim type. Click Finish. Set your website URL as the destination page. AD FS will need to redirect back after a successful domain account login. On the AD FS Management window, expand Trust Relationships on the left side.

12 Click Relying Party Trusts. Right-click on your trust and open Properties. Under the Endpoints tab, add a WS-Federation Passive Endpoint with your URL. After a successful login, the data is encrypted by default. I needed a thumbprint of the client s SSL certificate that is used by AD FS. After receiving the thumbprint, I am now ready to configure the ASP.NET MVC application.

13 Configure the ASP.NET MVC Application Open Visual Studio. Choose ASP.NET Web Application. Enter a project name (my example here is AD FS-Demo). Select a folder where you want to create the project. Click OK. In the next screen, choose MVC as the project. Under Authentication, click Change Authentication and change the Authentication to Individual User Accounts.

14 Add the Microsoft.Owin.Security.WsFederation package. Installing this will also install its dependencies. Under Solution Explorer, open the file ~/App_Start/Startup.Auth.cs and add the following code. The FederationMetadata.xml URL from the AD FS server. Wtrealm is the current website URL (i.e.,

15 The last option Wreply is used to call the DomainLogin method after successfully logging in from the AD FS server. To read back claims from the server, add these claim identifiers in web.config. <add key="claimsnameidentifier" value=" ameidentifier" /> <add key="claimsupnidentifier" value=" pn" /> <add key="claims identifier" value=" mailaddress" /> To read data from the encrypted claims, add the following configuration setting in the web.config. <system.identitymodel> <identityconfiguration> <audienceuris> <add value=" /> </audienceuris> <issuernameregistry type="system.identitymodel.tokens.validatingissuernameregistry, System.IdentityModel.Tokens.ValidatingIssuerNameRegistry"> <authority name=" FS.server.com/AD FS/services/trust"> <keys> <add thumbprint="a8f1a0a474c8ff51f5b84945b b8" /> </keys> <validissuers>

16 <add name=" FS.server.com/AD FS/services/trust" /> </validissuers> </authority> </issuernameregistry> <!--certificationvalidationmode set to "None" by the the Identity and Access Tool for Visual Studio. For development purposes.--> <certificatevalidation certificatevalidationmode="none" /> </identityconfiguration> </system.identitymodel> On the website, navigate to the login page. Now you ll see Federation under External Logins. After a successful login, the claims can be retrieved in back in code by using the below line. var claimsidentity = (ClaimsIdentity)Thread.CurrentPrincipal.Identity; You can verify the user s identity with the claims. After setting these values, execute the application and navigate to the login page. Click the Federation button. This will navigate to the AD FS server.

17 Using a valid domain account, login to the AD FS. You will navigate back to the application. The application contains the claims , name and other data. Use this data to sign in and navigate to the home screen!