TOPdesk logo

Microsoft Graph API: sådan kan du anvende det i din ITSM-løsning

Denne blog er tagget til følgende kategorier:

Af Ulrik Pedersen den

Hvis du til dagligt arbejder i et ITSM-system, kan du med fordel oprette integrationer til andre værktøjer og tjenester, der kan hjælpe dig med at effektivisere dine arbejdsprocesser. Heriblandt Microsoft Graph API.

Hvad er Microsoft Graph API?

Microsoft Graph API er en cloud-baseret tjeneste, der giver dig mulighed for at få adgang til - og interagere med - data fra forskellige Microsoft produkter og tjenester. Det fungerer dermed som en fælles gateway til data fra bl.a. Office 365, Azure Active Directory, OneDrive, SharePoint og Teams.

Ved hjælp af dette API’et kan du udvikle løsninger, der kan manipulere med data fra de ovennævnte kilder. Du kan udføre handlinger såsom oprettelse, læsning, opdatering og sletning af data i de enkelte brugeres konti og tjenester.

5 trin til at komme i gang

Hvis du ønsker at bruge Microsoft Graph API’et i din ITSM-løsning, skal du gennemgå følgende trin:

  1. Opret en global administratoradgang til dit Microsoft 365-miljø
  2. Registrér din applikation (en såkaldt ”App Registration”) via Azure Portalen og giv den rettigheder til de operationer, den skal kunne foretage
  3. Udvikl din løsning: hvordan bruger du Microsoft Graph API-kald? Hvis du har behov for at teste undervejs, kan du både gøre det i din egen applikation samt anvende det indbyggede værktøj Microsoft Graph Explorer
  4. Test din løsning
  5. Sæt din løsning i drift

4 eksempler på anvendelse

Microsoft Graph API’et giver dig en enorm mængde muligheder. Jeg vil derfor introducere dig for nogle konkrete løsninger, som du kan anvende i dit ITSM-system:

  1. I forbindelse med sagsbehandling: Opret en kalenderinvitation fra operatørens kalender til et Teams-møde mellem bruger og operatør. Send besked tilbage til sagen, om det lykkes eller ej
  2. Synkronisér Azure AD gruppemedlemskaber for en operatør med tildelingsgrupper i ITSM-systemet
  3. I forbindelse med sagsbehandling: Opret en bruger i Azure AD med specifikke grupper ud fra en rolle
  4. Baseret på en hændelse: Skriv en besked i en Teams-kanal eller til en navngiven person

3 gode grunde til at anvende Microsoft Graph API

Der er op til flere fordele ved at benytte Microsoft Graph API, men her er de tre mest centrale:

1. Nemmere integration

Med Microsoft Graph API har du standard API-kald til at manipulere med data. Det gør det meget nemmere at komme i gang med at integrere din løsning eller applikation i Microsoft 365-verdenen.

2. Standardløsninger

Løsninger kan laves med standard API-kald, der kan bruges på tværs af applikationer – og organisationer. Det er både nemmere og billigere at genbruge standardløsninger, som laves via Microsoft Graph API’et. Dertil vil implementeringen af en sådan standardløsning være meget hurtig, da der blot skal oprettes login-oplysninger til det specifikke Microsoft 365-miljø.

3. Omfattende muligheder

Microsoft Graph API gør det muligt at læse og skrive data samt at abonnere på ændringer, administrere brugere og grupper, sende beskeder i Teams og meget mere. Det er altså (næsten) kun fantasien, der sætter grænser!

Dos & don’ts

Der findes nogle essentielle do’s & don’ts. Her er der de vigtigste:

Dos:

  • Godkendelsesmekanismer: For at lave et Microsoft Graph API-kald, skal du bruge såkaldt OAuth 2.0-autentificering. Sikr dig, at adgangstokens håndteres sikkert.
  • Paging og sideinddeling: Hvis API-kaldet returnerer en stor mængde data, skal du implementere sideinddeling og bruge paging-mekanismen. Dette mindsker serverbelastningen og forbedrer ydeevnen.
  • Selektiv dataanmodning: Anmod kun om de data, du har brug for. Du kan filtrere i, hvilke data API’et returnerer. F.eks. at du kun får det fulde navn og ID tilbage på brugere - og ikke alle felter, der findes på dem. Dette forbedrer ydeevnen og reducerer netværkstrafikken.
  • Håndtér fejl: Forvent fejl og implementer passende fejlhåndtering i din løsning. Brug fejlkoder og -beskeder fra API'et til at give meningsfuld feedback til brugeren og håndtere eventuelle fejlscenarier, der kan opstå.

Don'ts:

  • Overflødig caching: Undgå at gemme og bruge forældede data fra API'et uden at kontrollere, om det stadig er gyldigt.
  • Unødvendige API-kald: Minimer antallet af API-kald ved at kombinere og optimere dine anmodninger. F.eks. kan du bruge batch-anmodninger til at gruppere flere operationer i en enkelt anmodning og reducere netværksbelastningen.
  • Overførsel af følsomme data: Undlad at sende eller lagre følsomme data, såsom adgangskoder, kreditkortoplysninger eller personligt identificerbare oplysninger (PII), uden at tage de nødvendige sikkerhedsforanstaltninger.

Interesseret i af høre mere?

Er du blevet nysgerrig på at lære mere om, hvordan du kan anvende Microsoft Graph API i din ITSM-løsning? Så deltag på vores webinar: MS Graph API: Dyk ned i de smarte funktioner.

 

Ulrik Pedersen

Senior service management konsulent