Registering an App in Entra ID

introduction in this guide, we will walk you through setting up an app registration in microsoft entra id to be used for authentication in factry historian and grafana microsoft entra id was previously known as azure active directory (azure ad) it is a cloud based identity and access management service used to manage users, groups, and permissions for secure sign in to applications step 1 access azure portal go to https //portal azure com and click on microsoft entra id step 2 create app registration click add > app registration step 3 configure app registration factry historian name the application, e g factry historian supported account types select single tenant to limit login to your organisation only (recommended) redirect uri example https //myhistorian com 18000/api/auth/microsoft/callback formula \<my historian base url> + /api/auth/\<my auth provider>/callback replace \<my historian base url> with the factry historian base url set in configuration > server settings > general > base url e g https //myhistorian com 18000 replace \<my auth provider> with the name of the authentication provider you will set in factry historian in configuration > authentication providers example if your redirect uri is /api/auth/microsoft/callback , then use microsoft note the base url must start with https // must not contain an ip address or localhost may include a port number, e g 8000 save the app registration by clicking register grafana name the application, e g grafana supported account types select single tenant first redirect uri example https //mygrafana com 443/login/azuread formula \<my grafana root url> + /login/azuread replace \<my grafana root url> with the grafana root url set in home > administration > general > settings e g https //mygrafana com 443 note must start with https // must not contain an ip address or localhost may include a port number, e g 3000 second redirect uri example https //mygrafana com 443 formula \<my grafana root url> e g https //mygrafana com 443 save the app registration step 4 application/directory id and client secret in entra id, go to manage > app registrations select an application you have created in the previous steps there should be one for factry historian, and one for grafana from the specific app registration's overview in entra id, copy the following values application (client) id directory (tenant) id you will need the application (client) id in the next steps section when configuring entra id authentication for factry historian and grafana back on the specific app registration's overview in entra id, click add a certificate or secret next, click new client secret you will need the client secret in the next steps section when configuring entra id authentication for factry historian and grafana enter a name and expiration date for the client secret and click add copy the value track the client secret's expiration date once expired, authentication will stop working renew the secret in advance and update the value in factry historian/grafana next steps you now have all the required values, tenant id , client id , and client secret from your microsoft entra id app registration you can now continue by configuring authentication in your applications for factry historian , see docid 8fvf2zgangaf70qy5yyec for grafana , see docid\ hrybcuqsezvwumwdjoew1 troubleshooting docid\ qog3brlwi2hfpdlojgfxm