NIH Login

1. NIH Login An Overview of Single Sign-On, Federation, Its Benefits, and Basic Procedures for Integrating Applications

2. Welcome to abc.nih.gov Welcome to def.nih.gov Welcome to ghi.nih.gov Please Log In Please Log In Please Log In Username Username Username Password Password Password GHI’s DB ABC’s DB DEF’s DB Without Single Sign-On or FederationLogin Procedures are Performed By Each Application

3. Welcome to xyz.nih.gov Welcome to abc.nih.gov Please Log In Please Log In Username Username Password Password XYZ’s DB ABC’s DB Visiting Multiple Applications • Under a non-SSO enabled architecture, users must log in to each application or website each time they visit. Logging in to one site does not provide access to others.

4. Supported User Credentials • NIH Login • NIH AD and NIH External user name password • HHS issued Personal Identification Verification (PIV) smart card • eRA Commons OID user name password • Federation • InCommon federation credentials • http://www.incommonfederation.org/participants/ • OpenID Foundation • http://openid.net/u-s-government-openid-pilot-program-participants/

5. Single Sign-On with NIH Login • Using NIH Login, users can login once to be granted access to any SSO-enabled application within NIH.

6. Welcome Please Log In Username Password XYZ’s DB How Does NIH Login Change My Application? • Applications are no longer required to perform authentication procedures • Users are authenticated by NIH AD, NIH Ext, and eRA Commons. • Login information is passed to the application from NIH Login via HTTP headers Homepage Welcome, Authenticated User!

7. Welcome Welcome Welcome Welcome App. #2 App. #3 App. #4 App. #1 Please Log In Please Log In Please Log In Please Log In Welcome Welcome Welcome Welcome Username Username Username Username Password Password Password Password DB XYZ’s DB XYZ’s DB XYZ’s DB The SSO Big-Picture Benefit • As long as the visitor continues using the browser window through which he or she logged in (or a child window), all SSO-enabled applications for which the user is authorized may be accessed.

8. How NIH Login Works • NIH Login uses CA SiteMinder software • Upon receiving a request, the client web server invokes the web agent. • The web agent checks with the policy server to see whether the site is protected by NIH Login or federation. • If the site is protected and the user is not yet authenticated, the NIH Login or federation screen is shown and login is required Client Side NIH Login Webserver Policy Server Web Agent AD AD

9. Federation with NIH Login • Using the federation components of NIH Login, external users can be granted access to web applications within NIH using their “home” credentials.

10. Welcome Please Log In Username Password XYZ’s DB How Does Federation Change My Application? • Applications are no longer required to authenticate and provision external users locally. • Users are authenticated using standards-based assertions/tokens (SAML, OpenID, WS-Federation, etc). • User authentication attributes are passed to the application via HTTP headers Homepage Welcome, Authenticated User!

11. How Federation Works NIH Login w/ Federation Home Org • Federation also uses CA SiteMinder software • Upon receiving a request, the client web server invokes the web agent. • The web agent checks with the policy server to see whether the site is protected by federation. • If the site is protected and the user is not yet authenticated, the federation screen is shown and the user chooses their “home” organization. • After the user authenticates at their “home” organization, they are returned to their requested NIH application. Client Side Policy Server Web Server Identity Provider Home Org Selector Web Agent

12. Authentication and Authorization • NIH Login will perform the necessary authentication procedures to verify the credentials of the user • NIH Login can also perform basic authorization • Authorization is based on active directory groups • Groups must exist or be created in the NIH AD for NIH Login and LDAP_ALL for federation

13. Getting Started… • Your part: In order to use NIH Login, the application’s web server must run an executable known as a web agent. The web agent is available for various operating systems including Windows, Solaris and Linux. The simple installation/configuration process may be performed by your team or by a member of the NIH Login team if granted access to the server. • Our part: The NIH Login team must first configure the NIH Login policy server to expect connections from the web agent. We will then send you technical information to allow you to connect your web agent to the policy server. • Application owners or technical contacts should provide operating system and web server information to the NIH Login team via theNIH Login Request Form (see contact information below for requests).

14. Tasks for Application Programmers • Applications integrating with NIH Login will need to remove their existing login procedures. This includes: • Altering HTML to remove login screen • Changing code (e.g. ASP, JSP, ColdFusion) to receive HTTP header information from NIH Login • Values include username, full name, email, etc. • These values can be used to populate data that is needed by the application • Using the information received to proceed with your application’s tasks • Code change requirements are usually minimal

15. More Information • For more information, please see the NECS Community on the NIH Portal at http://my.NIH.gov • Contact: • Yvonne Brooks – brooksy@orstcb.od.nih.gov • NIHISCSupport– nihiscsupport@mail.nih.gov