# User Guide

When the LiferayIAM 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](/files/-LFRp8QSZc7gr53WlkSj)

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](/files/-LFRp8QV1T5i7qTDPuaL)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://indigo-dc.gitbook.io/liferay-iam-connector/user.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
