Entra Setup

In order to enable Entra in your ngSurvey installation you have to first create a new application registration in your Azure Entra Id portal.

This newly created application will allow you to link NGSurvey with your Entra. Set it up using its name and its redirection URI which should be the URI under which you have installed ngSurvey. Make also sure to set the Redirect URI as Single-page Application (SPA).

Once you have registered your application open its API permissions and add the the User.ReadAll and Groups.ReadAll permission to it.

Entra users that can add new users in ngSurvey are required to have have both permissions assigned to their Entra Directory account in order to query the Entra user list and link users with ngSurvey.

In the permission screen grant the admin consent on the permissions.

The last step is to enable ID tokens in the application authentication page.

Once you have registered the application in Entra you're almost ready to go, the only thing left is to copy the Application (client) ID from the overview screen of your Entra Application registration screen.

Paste that application ID in your ngSurvey system settings Active Directory section.

Click on the test button, if you're not logged into Entra it will prompt a login screen. Login to make sure that the connection between Azure and ngSurvey is working.

Well done, your Entra users are now able to log into ngSurvey using their account and you will able able to add new Entra users to ngSurvey to let them access and use ngSurvey.