Skip to content
AIV

AIV SSO & External Security

Introduction

AIV allows a single sign-on option, enabling integration with third-party applications as part of an integrated solution. In this exercise, you will learn to implement a simple single sign-on code that validates users against those available in AIV.

In order to work with SSO, we first need to fetch users from client source, which could be a CSV file or a database.

AIV allow configuring external security so that you do have to redefine users and roles within AIV application, To use external security you need to implement a java interface.

This document will guide you through implementing simple Single Sign-On (SSO) and external security, validating users against a CSV file. You can download the sample project files for SSO and external security from Here..

There are 3 ways to get users in AIV using external security:

  1. Fetch user from CSV file:
  • In this document, we demonstrated using CSV file!
  1. Fetch user from Database:
  • Click here to know more on how to fetch user data from database!
  1. Fetch user from LDAP:
  • Click here to know more on how to fetch user data from LDAP!

Data file you required:

(a) SSO and External Security project files (b) Eclipse IDE

Prerequisites

  • Downloaded Sample project from Here..

Implement External Security

Follow these steps to implement external security with a CSV file:

  1. Download the files and extract them into your local storage folder. You will see two folders:
  • AIV External Security
  • AIV SSO

  1. Import both of these projects into Eclipse to make path changes in this sample project.

    Image

  1. Expand the AIV External Security project and navigate to the ‘files’ folder. This folder contains CSV files for user, role, and user-role mapping sample information, as well as other .properties files that will be used if your user data resides in a database.

    Image

  1. To change path of this CSV files in your project, expand src folder and open ExternalSecurityCSVImpl class file available in com.aiv.externalsecurity package.

    Image

  2. Provide path of CSV file here at variable BASE_PATH as shows in below image:

    Image

  3. Save this class file, now expand sso project folder and open aivSSOImpl class, provide valid path to store log files.

    Image

  1. Save this file and export whole project as a jar file and save it in local storage.

  2. Do the same with external security, export AIV External security project as JAR file and store it in local storage.

  3. Paste External Security & SSO JAR File into location [C:\aiv\apache-tomcat\webapps\aiv\WEB-INF\lib].

  4. To use it, enable SSO and External Security from the AIV Configuration page.

  5. Click on Hamburger menu and Go to Administration > AIV Configuration section, Click the button of External Security, as shown in figure.

  6. Select the ‘Secure’ radio button of Editable User Properties and Editable Roles Properties.

    Image

  7. Enter in Security class name: com.aiv.externalsecurity.ExternalSecurityCSVImpl.

  8. Enter in Admin Users: Admin

  9. Enter in Admin Roles: Administrator.

  1. Check the boxes for ‘User Defaults’ and ‘Role Defaults,’ as shown in the figure.

    Image

  1. Click on SSO Configuration button, it will enable SSO Configuration setting into AIV, as shown in figure.

    Image

  2. Enter the class name: com.aiv.sso.aivSSOImpl, as shown in the figure. [It impairments SSO jar File class path]

  3. Click on submit button to save the changes.

  1. Restart the tomcat server!

  2. Once server started, Login into aiv, Go to Administration > User section you will find some new users added into aiv.