Helpdesk
Helpdesk

Microsoft 365 koppelen

Zet een app-registratie klaar in Microsoft Entra ID, zodat collega's met hun werkaccount inloggen en het smoelenboek zichzelf vult.

Voor beheerdersBijgewerkt op
Waar in Airly/settings/authentication
Open in Airly (opent in een nieuw tabblad)
Op deze pagina

Met een koppeling met Microsoft 365 loggen je collega’s in met hun werkaccount. Airly vult dan ook het smoelenboek met de mensen uit je organisatie. De koppeling stel je in bij Instellingen › Authenticatie. Eerst maak je een app-registratie bij Microsoft. Dat doet iemand die beheerder is van jullie Microsoft-omgeving.


1. Een app-registratie maken#

  1. Ga naar entra.microsoft.com en open App-registraties.
  2. Klik op Nieuwe registratie.
  3. Geef de app een naam, bijvoorbeeld Airly.
  4. Kies bij Ondersteunde accounttypen de optie Alleen accounts in deze organisatiemap.
  5. Kies bij Omleidings-URI het platform Web en vul in: https://app.airly.nl/api/v1/sso/microsoft/callback
  6. Klik op Registreren.

2. De omleidings-URI’s toevoegen#

Microsoft stuurt iemand na het inloggen terug naar Airly. Dat mag alleen naar adressen die bij de app staan. Ontbreekt er een, dan ziet je collega de fout AADSTS500113: No reply address is registered.

  1. Open in de app Verificatie.
  2. Zet bij het platform Web deze adressen:
Waarvoor Omleidings-URI
Inloggen https://app.airly.nl/api/v1/sso/microsoft/callback
Agenda koppelen https://app.airly.nl/api/v1/calendar-sync/m365/callback
Mailbox bij Ideeën https://app.airly.nl/api/v1/stories/ideeen/mailbox/m365/terug
  1. Klik op Opslaan.

Neem de adressen precies over: met https, kleine letters en zonder / aan het eind. Zet ze er alle drie in, ook als je nu alleen het inloggen gebruikt.

3. Machtigingen geven#

  1. Open API-machtigingen en klik op Een machtiging toevoegen › Microsoft Graph.
  2. Kies Toepassingsmachtigingen en vink aan:
    • User.Read.All, voor het smoelenboek
    • ProfilePhoto.Read.All, voor de foto’s
  3. Klik op Beheerderstoestemming verlenen voor de naam van je organisatie.

Achter elke machtiging staat dan een groen vinkje met Verleend.

Voor het inloggen, de agenda en de mailbox vraagt Airly je collega zelf om toestemming. Daarvoor hoef je niets aan te vinken.

4. Een clientgeheim maken#

  1. Open Certificaten en geheimen en klik op Nieuw clientgeheim.
  2. Kies hoe lang het geldig is. Zet in je agenda wanneer het verloopt.
  3. Kopieer meteen de Waarde. Die zie je maar één keer. Gebruik niet de Geheime id.

5. Invullen in Airly#

  1. Ga naar Instellingen › Authenticatie en kies Single Sign-On (SSO).
  2. Kies Microsoft Entra ID.
  3. Vul in:
    • Tenant ID: de Map-id (tenant) van de app
    • Client ID: de Toepassings-id (client) van de app
    • Client secret: de waarde uit stap 4
  4. Zet bij Toegestane e-mail-domeinen het domein van jullie mailadressen, bijvoorbeeld omroep.nl.
  5. Klik op Opslaan.

Airly laat de Tenant ID en de Client ID daarna gewoon zien. Zo kun je ze vergelijken met wat bij Microsoft staat. Het clientgeheim zie je niet meer terug.

Het smoelenboek haalt binnen 15 minuten de mensen op. Je kunt de lijst nog beperken bij Smoelenboek-sync. Lees meer in Collega's opzoeken in het smoelenboek.

Werkt het niet?#

  • AADSTS500113: No reply address is registered: de omleidings-URI ontbreekt of is anders geschreven. Kijk bij 2. De omleidings-URI’s toevoegen.
  • Authorization_RequestDenied bij het smoelenboek: de machtigingen zijn gedelegeerd in plaats van toepassing, of de beheerderstoestemming ontbreekt. Heb je het net aangepast? Dan kan het tot een uur duren voordat Airly het merkt.
  • AADSTS700016: Application not found: de Client ID klopt niet. Vergelijk hem bij Instellingen › Authenticatie met de Toepassings-id (client) in Microsoft. Let op een spatie of een teken dat mist.
  • Token-aanvraag mislukt: het clientgeheim klopt niet of is verlopen. Maak een nieuw geheim en vul het opnieuw in.

Verder lezen

Dit artikel linkt naar

Hier naartoe gelinkt vanuit

Kom je er niet uit? Vraag het aan de beheerder van Airly bij jouw omroep. Die kan zo nodig contact opnemen met ons.