Microsoft Graph API -liitin (aiemmin Entra ID ja aiemmin Azure AD) on osa natiiveja liittimiä, ja sitä käytetään tietojen lukemiseen ja kirjoittamiseen asiakkaan Azure-/Entra ID:hen Microsoft Graph API:n avulla. Sitä voidaan käyttää kaikissa Professional- ja IGA-ratkaisuissa. 

Entra ID -pääkäyttäjän on luotava Entraan oma App Registration -sovellus Native Connectors -toimintoa varten Professional- ja IGA-ratkaisuissa. Yleensä tämän Entra-konfiguraation tekee organisaation Entra ID- tai todennusasiantuntija. 

Asiakkaan toimenpiteet

Sovelluksen rekisteröinti Entra ID:hen

Sovellus on määritettävä sallimaan Native Connectors (EPE) -komponentin lukea/kirjoittaa objekteja, joita käsitellään EPE:stä, esim. käyttäjätilejä ja ryhmiä. Sovelluksen rekisteröinti tehdään Microsoft Entra -hallintakeskuksesta: https://entra.microsoft.com. 
Valitse App Registration ja sitten +New registration 

Huom! Tämä EI ole Enterprise-sovellus.
 

Anna kuvaava nimi ja valitse Accounts in this organizational directory only (Efecte Baseline only - Single tenant) -vaihtoehto

Luo Secret tai sertifikaatti EPE:lle Entra ID -konsolissa

Valitse sovellus, jonka loit ohjeen vaiheessa “Sovelluksen rekisteröinti Entra ID:hen”

Valitse Certificates & secrets ja sitten Client secrets-välilehdellä + New client secret

Säilytä tämä secret value turvallisessa paikassa (secret ID:tä ei tarvita), ja sinun on myös lähetettävä se Matrix42-konsultille, jotta hän voi määrittää sen ratkaisusi Microsoft Graph API -liittimeen. 

Myönnä tarvittavat oikeudet Entra ID -konsolissa

Lisää oikeudet sovellukseen, jonka loit ohjeen vaiheessa “Sovelluksen rekisteröinti Entra ID:hen”. Sen mukaan, millaisia objektityyppejä Native Connector käsittelee, sinun on asetettava oikeudet Microsoft Graph API -dokumentaation mukaisesti https://learn.microsoft.com/en-us/graph/permissions-reference

Myönnä kirjoitusoikeudet vain tarvittaessa; nämä on kuvattu ja dokumentoitu tarkemmalla tasolla Entra ID -integraatiokuvauksessa, jonka toimittaa käynnissä oleva projekti. 

Valitse API permissions ja napsauta sitten + Add a permission

Kun olet antanut oikeat oikeudet, napsauta “Grant admin consent for <Organization name>” ja napsauta “Yes”. Tämän jälkeen sovellus on valmis Secure Accessin käytettäväksi käyttäjien todennukseen Matrix42 Professional- ja IGA-ratkaisuihin.

Yleisimmin käytetyt oikeudet

Alla on luettelo yleisimmin käytetyistä oikeuksista. Jos ympäristö niitä vaatii, ne voidaan lisätä yllä kuvatulla tavalla.

Varmista oikeat oikeudet tapauskohtaisesti. Katso viralliset Microsoftin ohjeet - https://learn.microsoft.com/en-us/graph/permissions-reference

Asiakkaan toimitettavat tiedot

Toimita seuraavat tiedot Matrix42:lle, jotta ne voidaan määrittää ratkaisun Microsoft Graph API -liittimeen.

Tiedot	Esimerkki
Application (client) ID Luomasi client-sovelluksen GUID-objekti Näkyy sovelluksesi yleiskatsauksessa	56cf0dabc-1a1b-12ca-3bca-bca4bc56a78b
Directory (tenant) ID Entra-tenantin GUID-objekti	abc1fb23-dd24-5a67-8b91-1a123ab123a12
Login URL Entra-tenantin mukautettu verkkotunnus	https://login.microsoftonline.com/example.onmicrosoft.com/
Graph API URL Yleensä asetettu arvoon 'https://graph.microsoft.com', muokattavissa erikoistarpeisiin	https://graph.microsoft.com
Käyttäjien tuontiparametri Valinnainen. Lisä-Graph API-kyselysuodatin, jota käytetään käyttäjiä poimittaessa	$filter=startswith(givenName, 'J')
Ryhmien tuontiparametri  Valinnainen. Lisä-Graph API-kyselysuodatin, jota käytetään ryhmiä poimittaessa	$filter=startswith groupName, ‘E’
ESM:ään tuonnista poissuljettavat käyttäjät Valinnainen. Poissuljettavien käyttäjien objektitunnukset	a11b1fc1-1234-1de1-f1dg-h1i2j345k123
ESM:ään tuonnista poissuljettavat ryhmät Valinnainen. Poissuljettavien ryhmien objektitunnukset	a11b1fc1-1234-1de1-f1dg-h1i2j345k123
Sisällytä käyttäjät tietyillä ryhmillä Valinnainen. Mahdollistaa niiden ryhmien listojen määrittämisen, joiden perusteella käyttäjät sisällytetään lopulliseen tulosjoukkoon. Sisällytettävien ryhmäjäsenyyksien objektitunnukset	a11b1fc1-1234-1de1-f1dg-h1i2j345k123
Sulje pois käyttäjät tietyillä ryhmillä Valinnainen. Mahdollistaa niiden ryhmien listojen määrittämisen, joiden perusteella käyttäjät suljetaan pois lopullisesta tulosjoukosta. Poissuljettavien ryhmäjäsenyyksien objektitunnukset	a11b1fc1-1234-1de1-f1dg-h1i2j345k123
Todennusmenetelmä: Secret tai Certificate Microsoft Graph API -liitin tukee suojattua yhteyttä Entra ID:hen käyttäen joko Client Secretiä tai Certificatea.	Toimita secret Matrix42:lle turvallisella toimitustavalla.   Jos käytetään Certificatea, Matrix42 toimittaa sertifikaatin asiakkaalle. Asiakkaan on ladattava sertifikaatti Entra ID -verkkokonsoliin oikealle sovellukselle.