To configure a specialized authentication portal landing page that will allow your site to provide both RemoteAuth and Non-RemoteAuth logon options from a single link within a catalog or finding aid, see the instructions below. Sites wanting to provide users with one link to various different logon options can use the Atlas Authentication Portal feature. The Atlas Authentication Portal application allows sites to provide a single link from a catalog or finding aid system that will take users to a page where they can select whether they log in via RemoteAuth or another method. In addition to providing logon links, this feature supports passing query string data through the portal to the selected destination.
The application files needed for this feature are available as a zip file on the ILLiad 9.0 Downloads page. Alternatively, ILLiad Customer Service can supply the application to you and assist you with the setup.
The specialized authentication portal landing page, Index.cshtml, displays instructional text to help sites configure the portal for viewing and editing. Once configured, this page will provide users the options for logging into ILLiad. When the user clicks the link and logs into ILLiad, the item data embedded in the original link is carried through and applied to the request form. This page is located in the AtlasAuthPortal file under \AtlasAuthPortal\Views\Portal.
Two Types of Access
There are two options available for configuring the portal: form-based access and linked based access. The default authentication portal page explains in detail how each option works and how to configure either of these options for use by your site.
Automatic Redirect Feature
When the portal is invoked it supports cookie-based tracking of the options selected by the user. If the user is currently logged into the destination system and has previously gone through the portal, it will forward them to their destination rather than show them the selection screen again.
As of Atlas Auth Portal version 1.3, the redirectUrl parameter has been replaced with the authType parameter. The default pages accept the authType values of AtlasAuth and RemoteAuth. For instructions on configuring the authType parameter settings of AtlasAuth and RemoteAuth, see the index.cshtml page for examples. In the index.cshtml, the examples use the default AtlasAuth and RemoteAuth values as placeholder for demonstration purposes only. When configuring your site's redirect URL, take the redirect URL values from your index.cshtml page and put them in the web.config as a named setting, and then update the index.cshtml to pass the authType parameter with the respective names.
In version 1.3, the RedirectUrlCookieName setting has been removed and replaced with the AuthTypeCookieName which defaults to AtlasAuthType. This change prevents the redirect URL from storing the user's cookies. Instead we now store the name of the auth type to use instead. This change will also prevent upgrade issues with users that have redirect URL cookies in their browsers already.
Installing the Atlas Authentication Portal Application
In order for the Atlas Authentication Portal to work properly, you must have Microsoft .NET 4.5.1 Framework installed on your ILLiad web server.
- Download the AtlasAuthPortal files and extract the folder to the web folder on the server (C:\inetpub\wwwroot\illiad is the default).
- Open the IIS Manager on your server.
- Navigate to AtlasAuthPortal by clicking Your Server Name | Sites | Default Web Site | ILLiad | AtlasAuthPortal.
- Right click on the Atlas Auth Portal and select Convert to Application.
- Accept the application defaults or make changes and click OK. The AtlasAuthPortal icon will change from a folder to an application icon.
Configuring the Atlas Authentication Portal
Once you have installed the Atlas Auth Portal application, there are two steps to set up the authentication portal feature.
- Modify the default portal page (Index.cshtml) using the instructions provided on the page. This page is located in the AtlasAuthPortal file under \AtlasAuthPortal\Views\Portal.
- Edit the Web.config file for the authentication portal to include the correct <appSettings> values for the SessionCookieName and UsePersistentRedirectCookie settings. This file is located in the AtlasAuthPortal file under \AtlasAuthPortal\Views.
- SessionCookieName value: ILLiadSessionID: This controls the cookie that should be looked for to identify whether or not the user is logged in. By default ILLiad stores the login as ILLiadSessionID.
- UsePersistentRedirectCookie value: true: This determines whether or not the cookie used to store the redirectURL the user selected on their last visit should be persistent or not (whether the cookie should be available after the user has closed their browser and come back to the portal).
- RedirectUrlCookieName: RedirectUrl: This specifies the name to use when storing the portal's redirect URL in a cookie. By default ILLiad stores the name as RedirectUrl. This can be changed to avoid conflicts between multiple instances of the Atlas Auth Portal on the same domain. For example, if a second instance of the Atlas Auth Portal is set up to redirect to the open URL action, its RedirectUrlCookieName might be set to OpenUrlRedirectUrl.
OpenURL and the Atlas Authentication Portal
Link resolvers that wish to pass an OpenURL link through the Atlas Authentication Portal will need to configure the target base URL to appear like one of the following, based on whether the generating source's OpenURL query (the portion of the URL that is appended to the end of the base URL) is created with a leading ampersand. OpenURL queries that are generated with a leading ampersand would configure the base URL to not include a trailing ampersand.