Beheerhandleiding NedGlobe aansluiten op Azure AD

Laatst gewijzigd op: 10 maart 2023

Aansluiten NedGlobe op eigen Azure AD

NedGlobe is een door Cadac ontwikkelde applicatie die kaartmateriaal bruikbaar maakt voor de desktop, tablet, en touch-table, op basis van OGC services.

Deze handleiding beschrijft de stappen die doorlopen dienen te worden om NedGlobe aan te sluiten op de Azure AD van een organisatie zodat gebruikers met hun eigen account en wachtwoord kunnen inloggen in NedGlobe. Dit is een EENMALIGE handeling per Azure AD. Deze stappen dienen door een SYSTEEMBEHEERDER van de organisatie uitgevoerd te worden.

De admin-user van de Azure AD van de organisatie dient een zogenaamd “ADMINCONSENT” uit te delen op de NedGlobe applicatie. Hiermee wordt toestemming aan de NedGlobe applicatie gegeven om de gebruiker gegevens te lezen. Wachtwoorden van gebruikers vallen niet onder deze toestemming en worden daarbij dus niet meegenomen.
Concreet betekent dit dat in de Azure AD een “Enterprise application” (Bedrijfstoepassing) genaamd NEDGLOBE wordt aangemaakt met Permissions op de NEDGLOBE-API.
Dit verloopt via de onderstaande links.

Via de volgende link wordt er na het inloggen toestemming van registratie van NEDGLOBE gevraagd.

https://login.microsoftonline.com/{tenant-id}/v2.0/adminconsent?client_id={client-id}&redirect_uri=https://nedglobe.cadac.com/mobile&scope=User.Read

In deze link moet {tenant-id} worden vervangen door de tenant-id van de Azure AD die te vinden is in het Azure portal van uw organisatie.

Het {client-id} moet worden vervangen door de application-id van de NedGlobe app registratie in de NedGlobe Azure AD. Deze client-id kunt u bij Cadac opvragen wanneer u bovenstaande link gaat uitvoeren.

Om alle gebruikers uit de Azure Active Directory te synchroniseren met die in het NedGlobe Dashboard moet nog een extra admin consent worden gedaan:

https://login.microsoftonline.com/{tenant-id}/v2.0/adminconsent?client_id={client-id}&redirect_uri=https://nedglobe.cadac.com/mobile&scope=User.Read.All

Vervang ook hier weer {tenant-id} en {client-id}.

TIP: Om te voorkomen dat er met een verkeerd Microsoft account wordt ingelogd is het advies om eerst de browser geschiedenis te wissen.

Na het invoeren van bovenstaande URL's en inloggen wordt het onderstaande scherm getoond. Klik op ‘Accepteren’ of 'Accept'.

Daarna kan een scherm met een foutmelding worden getoond. Dit kan worden genegeerd.

Na het uitvoeren van de twee URL’s voor User.Read en User.Read.All moet de beheerder van uw AAD nog een admin consent (beheerderstoestemming) uitdelen via het Azure portal.

Klik onder "Azure Active Directory " op “Bedrijfstoepassingen / Enterprise Applications" en vervolgens op de NEDGLOBE applicatie. Klik daarna op "Machtigingen".

Klik daarna op de onderstaande blauwe knop, log in en klik op "Accepteren".

Het kan enige tijd (tot een half uur) duren voordat de machtiging zichtbaar is voor API-NedGlobe-PROD.

Ook zal dan bij de User.Read.All machtiging het type van Delegated gewijzigd zijn naar Application.

Om de volledige synchronisatie van gebruikers te laten werken moeten wij de volgende zaken registreren in NedGlobe voor uw organisatie:

Domeinnaam, bv cadac.com
Azure Active Directory naam, bv cadac.onmicrosoft.com

Als dit is gebeurd kunnen alle gebruikers van de Azure AD door de beheerder in het NedGlobe Dashboard handmatig worden gesynchroniseerd middels een knop in het Dashboard scherm Gebruikers onder menu Autorisatie.

De NedGlobe Dashboard beheerder dient eerst een standaard Ondergrondlaag profiel en 1 of meer standaard thema/opslaglaag profielen aan te maken. Deze worden dan automatisch aan nieuwe gebruikers toegekend. Momenteel kan dat daarna niet meer en moet dat handmatig hersteld per gebruiker.

In het Instellingen scherm onder menu Systeem moet het standaard Ondergrondlaag profiel worden geselecteerd.

In het Thema/opslaglaag profielscherm moet middels een vinkje "Standaard profiel" worden bepaald of een profiel standaard wordt toegekend aan nieuwe gebruikers.

Daarna kunnen uw eindgebruikers gebruik maken van de NedGlobe Mobile applicatie via de link https://nedglobe.cadac.com/mobile

Bij Cadac maken we onderscheid tussen Sales, Service & Support. Sales & Service vinden wij vanzelfsprekend. Wij helpen u met de aanschaf van uw product, dienst, training of expert en zorgen ervoor dat u probleemloos aan de slag kunt. Gratis en voor niets. U kunt zorgeloos met uw software starten, wij zorgen ervoor dat u het meeste uit uw software kunt halen. Loopt u tegen technische softwareproblemen aan? Dan kunt u gebruik maken van Cadac Support. Door de juiste informatie in te dienen kunnen wij u zo snel mogelijk helpen