---
description: >-
  This section describes the element added to Liferay User Interface from the
  point of view of the user.
---

# User Guide

## IAM Authentication modules

When the IAM Authentication modules are deployed and properly configured the user interface change in few component. The login portlet will include, among the other enabled protocols, the new _INDIGO AAI_ authentication method, as shown in the following picture:

![Login portlet with INDIGO AAI authentication](https://1669070646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFRonM_kmG0gGAA-t3m%2F-LFRozAfCDk1OQ1eBAfq%2F-LFRpCcDzDeERcGXsUsM%2FLogIn.png?generation=1529492069579172\&alt=media)

If a user clicks on _INDIGO AAI_ a pop-up window is created with the IAM login page. After the login the pop-up page is automatically closed and the user is authenticated in the portal.

When a new user try to access the portal, he/she has to provide the consensus to release the tokens to the Liferay based portal. This request is performed twice: once for the access token and the other for the refresh token. Following authentications will not require the user consensus. This will be requested again if different scopes are requested.

Finally, the user can verify the tokens released by IAM going to his/her personal account page. In the _My Account_ page, under the tab _Miscellaneous_ there are the _Custom Fields_ attributes. IAM tokens nad user subject are among the custom fields as shown in the following picture:

![INDIGO AAI tokens](https://1669070646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFRonM_kmG0gGAA-t3m%2F-LFRozAfCDk1OQ1eBAfq%2F-LFRpCcGry4C5F5LniWI%2FCustField.png?generation=1529492079694417\&alt=media)

## FutureGateway administration modules

The FutureGateway administration modules add a new panel in the control panel of Liferay at `Liferay > Control Panel > Apps > FutureGateway` which is visible to the enabled user (a special role is requested to access the panel).

The panel presents a multi tab interface with three tabs for the main resources of the FutureGateway: _tasks_, _applications_ and _infrastructures_. In each tab a table with the available resources is shown, as shown in the following figure:

![FG applications](https://1669070646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFRonM_kmG0gGAA-t3m%2F-LFRozAfCDk1OQ1eBAfq%2F-LFRpCcW6dtPW2f7pbkx%2FFGapplications.png?generation=1529492077315005\&alt=media)

User can look at the resource details by clicking the id. This will open a modal window with an information tree containing all the resource details and a button to delete the resource, although the user should be enabled in the FutureGateway to delete the resources. The modal windows is shown in the following figure:

![FG application details](https://1669070646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFRonM_kmG0gGAA-t3m%2F-LFRozAfCDk1OQ1eBAfq%2F-LFRpCcYI1z1-rdegP8_%2FFGapplicationsdetails.png?generation=1529492079724032\&alt=media)

Finally, in the right bottom of the applications and infrastructures tab a button with a `+` sign open an insert page where the user can add a new resource. The button will open a new page with a form, depending on the resource type, containing all the possible fields.

## FutureGateway customisable application module

Customisable application portlet provides direct access to selected applications and allows the user to list all submitted tasks and check their status. To submit new tasks it is needed only to fill all required fields in a _submission panel_ and confirm it by pressing _Submit_ button. ![Customisable Portlet](https://1669070646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFRonM_kmG0gGAA-t3m%2F-LFRozAfCDk1OQ1eBAfq%2F-LFRpCc_XE5lZHiCv1Mm%2Fca-portlet.png?generation=1529492077348067\&alt=media)

## Kepler Status Portlet

The portlet works only with users logged in using IAM authentication method. ![You must be logged in](https://1669070646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFRonM_kmG0gGAA-t3m%2F-LFRozAfCDk1OQ1eBAfq%2F-LFRpCcbjdyaHFmK8-IA%2Fyou-must-be-logged-in.png?generation=1529492079009248\&alt=media)

Once logged, user is prompted to provide name of the application. ![Application name](https://1669070646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFRonM_kmG0gGAA-t3m%2F-LFRozAfCDk1OQ1eBAfq%2F-LFRpCcdIdQCjjQp01-G%2Fapplication-name.png?generation=1529492078957365\&alt=media)

Given invalid name, portlet presents a meaningful error message. ![Error message](https://1669070646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFRonM_kmG0gGAA-t3m%2F-LFRozAfCDk1OQ1eBAfq%2F-LFRpCcf__xUEIrc5_H-%2Ferror-message.png?generation=1529492078933330\&alt=media)

When the application is found, portlet will begin to query for all tasks of the current user which are of the application type. ![Application query](https://1669070646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFRonM_kmG0gGAA-t3m%2F-LFRozAfCDk1OQ1eBAfq%2F-LFRpCchvpGk55O8svW7%2Fapplication-query.png?generation=1529492077341456\&alt=media)

The results are shown in a table. An icon distinguishing `DONE`, `ABORTED` and `RUNNING` tasks is shown next to the task's id and description. Rows of the table can be clicked to extend a panel with runtime data of the selected tasks. ![Runtime data](https://1669070646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFRonM_kmG0gGAA-t3m%2F-LFRozAfCDk1OQ1eBAfq%2F-LFRpCcjWYMHs1-Smwvn%2Fruntime-data.png?generation=1529492079747574\&alt=media)
