If you need any help configuring the following steps, be sure to get in touch: firstname.lastname@example.org or via chat.
Use your favorite package manager to install NodeJS
Download and extract our Azure AD client to a directory of your choice
Edit config.json to match your environment.
Go to https://portal.azure.com and log in. Select the domain / tenant you would like to integrate with Vizito.
Now, follow these steps:
Navigate to Azure Active Directory:
Click on App Registrations and then on New application registration:
Fill in the required fields. For example: Vizito Azure AD integration, application type Web app / API and sign-on URL: https://backoffice.vizito.be/oauth.Click on Create.
Copy the Application ID and fill this value in in the config.json file under client_id.
Afterwards, clik on settings.
Click on Keys and Add:
Fill in a description like API Key and set expires to never.
Click on Save.
Now, a key is generated and this key will only be displayed once, so copy paste it immediately to the config.json file of the installed Vizito Azure AD Client.
You need to put this value in the field client_secret.
Now, click on Required Permissions and Add.
Select the option Select an API:
Select Microsoft Graph:
Select Read all users' full profiles under App Permissions (not Delegated Permissions!):
Once completed, click on Grant permissions and then Yes:
Now, click on the Azure Active Directory icon on the left hand side, go to Properties and copy your tenant ID and paste this value in the config.json file in field tenant_id.
Here you can find the configuration values and a description of what information you need to enter:
Open a command prompt, navigate to the folder where your Azure AD client resides, and run "node server.js"
If everything works as intended, you should see a line like this in your console: https://graph.microsoft.com/v1.0/users?$top=999.
You can now use a browser to test the Azure AD http server by pointing your browser to http://ip_or_hostname_of_machine_running_azure_ad_client:48800.If you're running a firewall, make sure it allows access to port 48800.If your browser shows a JSON object representing the users you want to expose, than everything works!
Navigate to https://backoffice.vizito.be and under Settings, configure the Host datasource as 'Managed externally' and fill in the Integration URL.Now the tablet will look up the information from the installed client.
Download the latest release of NSSM at https://nssm.cc/downloadextract the appropriate architecture executable to a folder of your choice.now run the following command: nssm install vizito_azure_ad_clientThis will show a window where your service parameters can be configured.
Now go to your Windows Services, start your newly created service, and test! Remember to stop any manually started instances of the Azure AD client before starting the service.