openxava / documentation / SSO with Azure AD

All the features in this article are available only in XavaPro
Since XavaPro 7.1  you can configure user identification to use Azure AD, allowing you to use Single Sign-On (SSO). This way, the user can authenticate once and access all your XavaPro applications and other non-XavaPro applications that also use Azure AD. Furthermore, using Azure AD enables you to utilize two-step authentication for your XavaPro applications.

SSO configuration in XavaPro

In the Admin folder, you have a module called SSO to configure Azure AD:
If you check the Enabled checkbox and fill in the remaining fields with the correct configuration of your Azure AD for your application, when you sign in, you will have a new button labeled SIGN IN WITH AZURE AD:
If the user clicks on SIGN IN WITH AZURE AD, he will be given the option to sign in using his Azure credentials:
Furthermore, if the user is already signed in on that browser, they will access the application without being prompted for authentication. However, for this to happen, the user needs to be added to the application in Azure AD configuration and also registered as a XavaPro user in the application, with the corresponding roles assigned. Please note that the user must be registered in the XavaPro application with the same name as in Azure, otherwise access to the application will not be possible.

Configure the application in Azure AD

If you already use Azure AD in your organization, you will be familiar with configuring applications and assigning users to them. You will also know where to find the values for the XavaPro SSO form. However, if you have never used Azure AD before, don't worry. Here is a guide to help you register your application in Azure AD. Azure AD offers a free tier good enough to enable SSO in your XavaPro applications.

Azure AD Control Panel

The first step is to sign up for Azure AD at this address: (if the link doesn't work, search for "Azure AD" on Google). Once you have signed up, go to the Azure main page, which is usually accessible after you log in. If not, go to From there, click on Azure Active Directory:
This takes you to the Azure AD administration page:

Add application in Azure AD

Let's assume that we have a XavaPro application called invoicing and we want to register it in Azure AD. We should follow the next steps.
First, open the Add menu and click on App registration:
In the Register an application page that appears, enter your application's registration information:
Select Register to create the application.

Create secret

On the Azure AD administration page, choose the App registrations option from the left menu. This will display the list of your applications. Click on invoicing.

In the app's registration screen, click on the Certificates & secrets option in the left to open the page where we can generate secrets and upload certificates. In the Client secrets section, click on New client secret:

Type a key description (for instance app secret), Select one of the available key durations (6 months, 1 year, 2 years, or Never Expires) as per your security concerns.

The generated key value will be displayed when you click the Add button. Copy the generated value for use in the steps later. You'll need this key later in your XavaPro SSO configuration. This key value will not be displayed again, and is not retrievable by any other means, so make sure to note it from the Azure portal before navigating to any other screen or section.

Configure the Azure AD application in XavaPro

In Azure AD, go to App registrations and select your application to view its essential information. Then, in your XavaPro application, open the SSO module within the Admin folder and fill in the required information:

In this way:

Check the Enabled checkbox, and your application will now work with Azure AD. Remember to register users in your XavaPro application with the corresponding roles; otherwise, it will not work. If you do this with other XavaPro applications, you will be able to authenticate yourself the first time and access the other applications without login. Additionally, you can enable two-step authentication for your users from Azure AD.