Käyttäjien suodattaminen

Suodattimen nimi: Tuo käyttäjät -parametri
Tämä suodatin on asetettu tuomaan käyttäjä syötettyjen parametrien perusteella (kuten esimerkiksi $filter=startswith givenName, 'J'). Parametreja voi olla useita, ja niitä käytetään yhdessä.

Esimerkkejä

Seuraava esimerkki löytää käyttäjät, joiden sähköpostiosoite päättyy "@efecte.com"

Seuraava esimerkki löytää käyttäjät, jotka kuuluvat osastolle, jonka nimi alkaa sanalla ”IT-palvelu”.

Seuraava esimerkki löytää käyttäjät, joiden näyttönimi alkaa sanalla ”TEST”

Seuraava esimerkki löytää käyttäjät, jotka eivät kuulu Efecte-nimiseen yritykseen

Seuraava esimerkki löytää käyttäjät, jotka eivät ole Active Directory , mutta ovat Entra tenantin jäseniä.

Seuraava esimerkki löytää käyttäjät, joiden sähköpostiosoite on tuija.itasalmi@efecte.com

Seuraava esimerkki löytää käyttäjät, joiden laajennusattribuutissa extension_824667ba11b6468baf6ac13ac3c62c81_AuthenticationType on todennustyyppi 'vakio' ja tilit on otsikoitu laajennusattribuutissa extension_824667ba11b6468baf6ac13ac3c62c81_AccountType sisäisiksi tai ulkoisiksi.

Seuraava esimerkki löytää käyttäjät, joilla on sähköpostia

Seuraava esimerkki löytää käyttäjät, joilla on käytössä

Ryhmien suodattaminen

Suodattimen nimi: Tuo ryhmien parametri
Tämä suodatin on asetettu tuomaan ryhmiä annettujen parametrien perusteella. Esimerkiksi: $filter=startswith groupName, 'E' . Huomaa, että yksi suodatin voi käyttää useita parametreja kerralla.

Esimerkkejä

Seuraava esimerkki löytää ryhmiä, jotka ovat käyttöoikeusryhmiä

Seuraava esimerkki löytää ryhmät, joiden näyttönimi alkaa sanalla ”Efecte”.

Seuraava esimerkki löytää ryhmät, jotka on luotu ja synkronoitu Active Directory

Poissuljetut ryhmät

Azure -pohjaisissa tehtävissä anna poissuljettavien ryhmien objektitunnukset (eroteltuna rivinvaihdoilla).

Käyttäjien suodattaminen ryhmän jäsenyyden perusteella

Suodattimen nimi: Tuo ryhmät -parametri
Tämä suodatin on asetettu tuomaan käyttäjiä ryhmän jäsenyyden perusteella. Azure -pohjaisissa tehtävissä anna sisällytettävien tai poissuljettavien ryhmien jäsenyyksien objektitunnukset (eroteltuna rivinvaihdoilla).

Suodatus yksittäisten käyttäjien perusteella

Suodattimen nimi: Poissuljetut käyttäjät

Tämän suodattimen avulla on mahdollista jättää tiettyjä käyttäjiä pois tuonnista. Entra varten käytä poissuljettavien ryhmien ObjectGUID tunnuksia (eroteltuna rivinvaihdoilla).

Lisätietoja MS Graph API ja suodattimista löytyy osoitteesta https://docs.microsoft.com/en-us/graph/aad-advanced-queries?tabs=http .

EPE Azure -kyselyiden testaaminen

Jos haluat testata Azure -kyselyitä ilman EPE:n suorittamista, siirry URL-osoitteeseen https://developer.microsoft.com/en-us/graph/graph-explorer 

Tämä testaustyökalu käyttää täsmälleen samoja sääntöjä kuin EPE. Jos jokin toimii täällä, se toimii myös EPE:ssä ja päinvastoin.

Esimerkiksi miten testataan, toimiiko onPremisesExtensionAttribute-syntaksi EPE:ssä:

Voit määrittää ajoitetun tehtävän lukemaan tietoja kyselyllä ja alikyselyillä, jotka liittyvät pääkyselyn palauttamaan tulosjoukkoon.

Tässä esimerkissä deviceManagement/managedDevices on pääkysely, ja sillä on kaksi alikyselyä. Alikyselyt tehdään kaikille laitteille, jotka pääkysely palautti.

Kun olet asettanut kyseiset alikyselyt, voit käyttää niitä määrityksissä hakeaksesi alikyselyiden palauttamia tietoja. Esimerkiksi näin:

Kun luet attribuutin alikyselystä, sillä on oma muotonsa. Ensin sinun on lisättävä etuliitteeksi alikysely, sitten piste (.) ja lopuksi luettavan attribuutin nimi.

Tarkastellaanpa esimerkkinä tätä kartoitusta tarkemmin:
/deviceManagement/managedDevices/{id}/windows Pro tectionState . deviceState

etuliite (sama kuin alikysely): /deviceManagement/managedDevices/{id}/windows Pro tectionState

piste : .

pääte attribuutin nimenä alikyselyn tulosjoukosta: deviceState

Tuo alikyselyn yhdistämismääritys lukee (tässä esimerkissä) kaikista pääkyselyn tuloksena saaduista laitteista Windowsin Pro -objektin ja sieltä se lukee deviceState-attribuutin arvon.

Alitaulukoiden tuki lisätty versioon 2025.2

Voit lukea taulukoiden ominaisuuksia tällä syntaksilla:
deviceManagement/detectedApps/{id}/deviceActionResults.0.actionName
Esimerkkejä (lue tiedot deviceActionResults-alikyselyn tulosjoukoista ensimmäisestä taulukosta ja lue tästä taulukosta actionName-, actionState- ja lastUpdatedDateTime-attribuutit erillisiksi ESM-attribuuteiksi):

Rajoitukset versiossa 2025.1

Monitasoisia alikyselyitä ei tueta

Alikyselyt tukevat vain yhtä alikyselytasoa, mikä tarkoittaa, että et voi luoda suoraan esimerkiksi tällaisia alikyselyitä, joissa on useampi kuin yksi muuttuja {}-muuttujassa:

/deviceManagement/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}/users/{userId}/managedDevices

Alitaulukoita ei tueta

Tietojen hakemista alitaulukoista ei tueta, eli et voi esimerkiksi lukea actionName-funktiota tästä API kutsulla:

deviceManagement/managedDevices/{id}

Vain yksi alikysely tehtävää kohden on tuettu.

Jos käytät useampaa kuin yhtä alikyselyä, tiedot saattavat sekoittua niiden välillä.

Rajoitukset versiossa 2025.2

Monitasoisia alikyselyitä ei tueta

Alikyselyt tukevat vain yhtä alikyselytasoa, mikä tarkoittaa, että et voi luoda suoraan esimerkiksi tällaisia alikyselyitä, joissa on useampi kuin yksi muuttuja {}-muuttujassa:

/deviceManagement/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}/users/{userId}/managedDevices

Vain yksi alikysely tehtävää kohden on tuettu.

Jos käytät useampaa kuin yhtä alikyselyä, tiedot saattavat sekoittua niiden välillä.

Rajoitukset versiossa 2025.3

Monitasoisia alikyselyitä ei tueta

Alikyselyt tukevat vain yhtä alikyselytasoa, mikä tarkoittaa, että et voi luoda suoraan esimerkiksi tällaisia alikyselyitä, joissa on useampi kuin yksi muuttuja {}-muuttujassa:

/deviceManagement/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}/users/{userId}/managedDevices

Katso https://docs.efecte.com/configure-connectors/intune-read-and-write

Katso https://docs.efecte.com/configure-connectors/ms_teams_integration

Yleisen REST kutsutoiminnon avulla voit tehdä erilaisia kutsuja Azure ja Entra ID hen Microsoft Graph API kautta. Tässä on pari esimerkkiä näistä mahdollisuuksista, mutta ei rajoitu pelkästään näihin.

Aseta extensionAttributes (1–15) Entra ID -tilin arvoksi.

Luo json-runko työnkulun komentosarjasolmussa (muokkaa komentosarjaa vastaamaan vaatimuksiasi). Alla olevassa esimerkkityönkulussa tämä komentosarja on ”EXT Generate ExtensionAttributes payload” -solmussa:

import json

_source = this.get("source")

# EXT users extension attributes, ordered from portal
if "Self-service portal" in _source:
  # set values to variables
  _extAttr1 = this.get("iga_id")
  _extAttr4 = "EXT"
  _extAttr9 = str(this.get("work_unit"))
  _extAttr10 = "100"
  _extAttr15 = this.get("microsoft_license")

  _payload_dict = {
    "onPremisesExtensionAttributes": {
        "extensionAttribute1": _extAttr1,
        "extensionAttribute4": _extAttr4,
        "extensionAttribute9": _extAttr9,
        "extensionAttribute10": _extAttr10,
        "extensionAttribute15": _extAttr15
    }
}

  # format to json and set to extattributesEntra attribute
  _payload = json.dumps(_payload_dict, indent=4)
  this.set("extattributesEntra", _payload)

Luo orkestrointisolmu Microsoft Graph API -tietolähteelle ja yleiselle REST kutsutoiminnalle.

Aseta Action-komennon arvoksi PATCH, anna URL-osoitteen muuttua muodossa /users/$objectGUID$ ja käytä rungossa edellisessä vaiheessa luomaasi extattributes Entra -attribuutin arvoa syntaksilla $extattributes Entra $.

Aktivoi / deaktivoi käyttäjä

Yllä olevassa kuvassa järjestelmänvalvojat valitsevat oikean Microsoft Azure AD ”kohteen” ja voivat tarkastella valituille Azure -tehtäville määritettyjä identiteettimäärityksiä. Tässä orkestrointinäkymässä järjestelmänvalvojat eivät voi muuttaa määrityksiä, ne esitetään vain visuaalisena apuna. Jos määrityksiin on tarpeen tehdä muutoksia, ne on suoritettava Pro määritysnäkymässä.

Saman solmun sisällä järjestelmänvalvojat voivat valita haluamansa toiminnon: ”Aktivoi” tai ”Poista käytöstä”. ”Aktivoi/Poista käytöstä” -toiminto viittaa tässä ”accountEnabled”-arvon asettamiseen arvoon ”true”, jos tili on käytössä; muussa tapauksessa arvoon ”false”.

Pro on valinnainen ominaisuus tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää tämän ominaisuuden käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana on poikkeuksia.

Lisää käyttäjä ryhmään

Yllä olevassa kuvassa Person-attribuutin konfiguraation tulisi osoittaa mallipohjaan, josta orkestrointisolmu löytää käyttäjän tiedot (yleensä IGA tili). Role-attribuutti on konfiguroitava määrittämään, mistä orkestrointisolmu löytää käytettävissä olevat roolit (hakemistoryhmät, joista käyttäjä tulisi poistaa). ”Rooli-attribuutissa” voi olla määritettynä yksi tai useita attribuuttiryhmiä. Käytettävissä olevien rekisteröityjen hakemistotehtävien luettelo noudetaan EPE-pääpalvelimelta.

Hakemiston tehtävävalinta on pakollinen, koska Efecte Provisioning Engine orkestrointisolmu käyttää identiteetti- ja käyttöoikeuskenttien yhdistämismäärityksiä selvittääkseen, minkä attribuuttikoodin alle käyttäjän ja hakemistoryhmän erottuvat nimet on tallennettu.

Poikkeusten käsittely:

• Solmun tulos on "Valmis"-tilassa vain, jos kaikkien käyttäjien ryhmäjäsenyydet on päivitetty onnistuneesti. Jos esimerkiksi käyttäjä on poistettu onnistuneesti viidestä kuudesta ryhmästä, solmun tulos on "Poikkeus"-tilassa.
• Tästä syystä sekä identiteetin että käyttöoikeuden JSON-kentän distinguishedName-määritykset ovat pakollisia. Jos määritystä ei löydy, orkestrointisolmu siirtää sen tilaan ”Poikkeus”.
• Käyttäjän poistaminen ryhmästä, johon hän ei kuulu, epäonnistuu.
• Käyttäjän lisääminen ryhmään, johon hän jo kuuluu, epäonnistuu.
• Tiedot käyttäjän ryhmäjäsenyyden onnistuneesta/epäonnistuneesta päivityksestä löytyvät lokeista.
• Pro ja ryhmäjäsenyyden poikkeukset ovat valinnaisia ominaisuuksia tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää nämä ominaisuudet käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana ilmenee poikkeuksia.

Luo käyttäjä

Yllä olevassa kuvassa identiteettiattribuuttimääritykset on täytetty Pro . Järjestelmänvalvojat valitsevat oikean kohdehakemiston ja voivat tarkastella valituille hakemistotehtäville määritettyjä identiteettimäärityksiä. Tässä orkestrointinäkymässä järjestelmänvalvojat eivät voi muuttaa määrityksiä, vaan ne esitetään visuaalisena apuna. Jos määrityksiin on tarpeen tehdä muutoksia, ne on suoritettava Pro määritysnäkymässä.

Uuden käyttäjän luontisolmu lukee attribuutteja kyseisiltä datakorteilta ja suorittaa API kutsun Azure . On tärkeää varmistaa, että käyttäjän luontisolmussa käytettävä identiteettikartoitus sisältää vähintään kolme muuta Azure AD -kartoitusta: attribuuteille ”displayName”, ”mailNickname” ja ”userPrincipalName”. Huomautus: jos nämä kolme kartoitusta puuttuvat tietystä kokoonpanosta, sitä ei näytetä avattavassa valikossa.

Uusien käyttäjäaktiviteettimuistiinpanojen luominen:

• Uuden käyttäjän salasanan luomiseen ensimmäistä kirjautumista varten on kaksi tapaa.
  • Määritä oletussalasana Pro Task -määritysnäkymässä
    • Käyttäjät käyttävät tätä salasanaa vain, kun he kirjautuvat järjestelmään ensimmäistä kertaa.
  • Satunnaisen salasanan luominen työnkulussa ja sen valitseminen, mihin identiteettikartoituksen datakortin attribuuttiin se kirjoitettiin
  • Molemmissa tapauksissa ensimmäisellä kerralla salasanaksi ”pwdLastSet” asetetaan nolla (0), jotta käyttäjän on pakko vaihtaa salasanansa ensimmäisen kirjautumisen jälkeen.
  • Mahdollisuus valita, onko salasana vaihdettava ensimmäisen kirjautumisen yhteydessä vai ei. Järjestelmänvalvojat voivat tehdä tämän valinnan suoraan työnkulun käyttäjäluonnin orkestrointisolmussa.
• Loppukäyttäjälle voidaan antaa ensimmäisen kirjautumisen salasana eri tavoilla. Asiakkaan tarpeista riippuen on mahdollista käyttää työnkulun toimintoja salasanan lähettämiseen suoraan loppukäyttäjälle sähköpostitse tai tekstiviestitse. Toinen vaihtoehto on lähettää ensimmäisen kirjautumisen salasana esimiehelle, joka toimittaa sen loppukäyttäjälle. EPE:n orkestrointisolmu itsessään EI tarjoa tätä toimintoa, se on määriteltävä muualla.
• Pro on valinnainen ominaisuus tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää tämän ominaisuuden käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana on poikkeuksia.

Luo ryhmä

Yllä olevassa kuvassa käyttöoikeusattribuuttien yhdistämismääritykset on täytetty valmistelutehtävistä. Järjestelmänvalvojat valitsevat oikean Azure -hakemiston "Kohde"-kohdan ja voivat tarkastella valituille Azure -tehtäville määritettyjä käyttöoikeusmäärityksiä. Tässä orkestrointinäkymässä järjestelmänvalvojat eivät voi muuttaa määrityksiä, vaan ne esitetään Pro apuna. Jos määrityksiin on tarpeen tehdä muutoksia, ne on suoritettava Pro määritysnäkymässä.

Uuden käyttäjän orkestrointisolmun luonti lukee attribuutit kyseisiltä datakorteilta ja suorittaa API komennon Entra -hakemistoon.

On tärkeää varmistaa, että Create Group -orkestrointisolmussa käytettävä käyttöoikeusmääritys sisältää vähintään neljä muuta Azure AD -määritystä: attribuuteille ”displayName”, ”mailEnabled”, ”mailNickname” ja ”securityEnabled”.

Pro on valinnainen ominaisuus tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää tämän ominaisuuden käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana on poikkeuksia.


Poista ryhmä

Yllä olevassa kuvassa järjestelmänvalvojat voivat valita oikean Azure -hakemiston ”Kohde”. Poistoryhmän orkestrointisolmu lukee määritteet kyseisiltä datakorteilta ja suorittaa API -komennon Azure -hakemistoon.

Azure Active Directory -pohjaisissa kokoonpanoissa 'Rooliryhmän attribuutin' tulisi sisältää ryhmän ObjectGUID .

Pro on valinnainen ominaisuus tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää tämän ominaisuuden käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana on poikkeuksia.

Poista käyttäjä

Yllä olevassa kuvassa järjestelmänvalvojat voivat valita oikean Azure AD ”kohteen”. Käyttäjäorkestrointisolmun poisto lukee attribuutit kyseisiltä datakorteilta ja suorittaa API -komennon Entra -hakemistoon.

Azure Active Directory -pohjaisissa kokoonpanoissa 'Person Attribute' -kohdan tulee sisältää käyttäjän ObjectGUID -arvo.

Pro on valinnainen ominaisuus tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää tämän ominaisuuden käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana on poikkeuksia.

Poista käyttäjä ryhmästä

Yllä olevassa kuvassa järjestelmänvalvojat voivat valita oikean Azure AD ”kohteen”. Käyttäjän poistaminen ryhmästä -orkestrointisolmu lukee attribuutit kyseisiltä datakorteilta ja suorittaa API -komennon Entra -hakemistoon.

Azure Active Directory -pohjaisissa kokoonpanoissa 'Henkilöattribuutti'- ja 'Rooliattribuutti'-kohtien tulee sisältää käyttäjän ObjectGUID -arvo.

Poikkeusten käsittely:

• Solmun tulos on "Valmis"-tilassa vain, jos kaikkien käyttäjien ryhmäjäsenyydet on päivitetty onnistuneesti. Jos esimerkiksi käyttäjä on poistettu onnistuneesti viidestä kuudesta ryhmästä, solmun tulos on "Poikkeus"-tilassa.
• Käyttäjän poistaminen ryhmästä, johon hän ei kuulu, epäonnistuu.
• Tiedot käyttäjän ryhmäjäsenyyden onnistuneesta/epäonnistuneesta päivityksestä löytyvät lokeista.
• Pro ja ryhmäjäsenyyden poikkeukset ovat valinnaisia ominaisuuksia tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää nämä ominaisuudet käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana ilmenee poikkeuksia.
  

Palauta käyttäjän salasana

Yllä olevassa kuvassa järjestelmänvalvojat voivat valita oikean Azure -hakemiston ”kohteen”. Käyttäjän salasanan palautus -orkestrointisolmu lukee attribuutit kyseisiltä datakorteilta ja suorittaa API komennon Azure -hakemistoon. Person- ja Password-attribuuttien tulisi osoittaa mallipohjaan, josta orkestrointisolmu löytää käyttäjän tiedot.

EPE-versiosta 2022.3 eteenpäin olemme ottaneet käyttöön mahdollisuuden valita, onko salasana vaihdettava ensimmäisen kirjautumisen yhteydessä vai ei. Järjestelmänvalvojat voivat tehdä tämän valinnan suoraan työnkulun Käyttäjän salasanan vaihtaminen -orkestrointisolmusta.

Pro on valinnainen ominaisuus tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää tämän ominaisuuden käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana on poikkeuksia.

Päivitä ryhmä

Yllä olevassa kuvassa käyttöoikeusattribuuttien yhdistämismääritykset on täytetty Pro . Järjestelmänvalvojat valitsevat oikean Azure -hakemiston ”Kohde”-kohdan ja voivat tarkastella valituille Azure -tehtäville määritettyjä käyttöoikeusmäärityksiä.

Tässä orkestrointinäkymässä järjestelmänvalvojat eivät voi muuttaa määrityksiä, ne näytetään vain visuaalisena apuna. Jos määrityksiin on tarpeen tehdä muutoksia, ne on suoritettava Pro määritysnäkymässä.

Päivitysryhmän orkestrointisolmu lukee attribuutit kyseisiltä datakorteilta ja suorittaa API kutsua Azure .

Pro on valinnainen ominaisuus tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää tämän ominaisuuden käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana on poikkeuksia.

Päivitä käyttäjä

Yllä olevassa kuvassa identiteettiattribuuttimääritykset on täytetty Pro . Järjestelmänvalvojat valitsevat oikean Azure -hakemiston "Kohde"-kohdan ja voivat tarkastella valituille Azure -tehtäville määritettyjä identiteettimäärityksiä. Tässä orkestrointinäkymässä järjestelmänvalvojat eivät voi muuttaa määrityksiä, vaan ne esitetään vain visuaalisena apuna. Jos määrityksiin on tarpeen tehdä muutoksia, ne on suoritettava Pro määritysnäkymässä.

Päivityksen käyttäjän orkestrointisolmu lukee attribuutit kyseisiltä datakorteilta ja suorittaa API kutsua Azure AD hen.

Käyttäjän salasanan päivitystä ei tueta tässä orkestrointitoiminnassa.

Pro on valinnainen ominaisuus tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää tämän ominaisuuden käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana on poikkeuksia.

Vahvista ryhmä

Yllä olevassa kuvassa käyttöoikeusattribuuttimääritykset on täytetty valmistelutehtävistä. Järjestelmänvalvojat valitsevat oikean Azure -hakemiston "Kohde"-kohdasta ja voivat tarkastella valitulle Azure -tehtävälle määritettyjä käyttöoikeusmäärityksiä. Tässä orkestrointinäkymässä et voi muuttaa määrityksiä, ne näytetään vain Pro apuna. Jos määritemäärityksiä on tarpeen muuttaa, kyseiset määritteet on määritettävä valmistelutehtävän määritysnäkymässä, jotta niitä voidaan muuttaa orkestrointisolmussa.

Käyttöoikeusmääritykset -ylläpitäjäpaneelissa ylläpitäjät voivat antaa "JOS"-lausekkeen, joka muodostaa API kutsun ryhmän olemassaolon varmistamiseksi. Data Cardilta voi valita niin monta attribuuttia kuin on tarpeen ryhmän yksilöllisyyden vahvistamiseksi. Kun toiminto suoritetaan, nämä attribuutit luetaan kyseisestä Data Cardista ja niitä verrataan asianmukaisiin Azure -attribuutteihin "Kohde*" Azure -hakemiston kokoonpanon mukaisesti. Ylläpitäjät voivat myös valita "yhtä suuri kuin" tai "ei yhtä suuri kuin" vastaavalle Azure -attribuutille muuttamalla "JOS"-lauseketta. "Tallenna tulos*" -kenttää käytetään määrittämään, minne onnistuneet API -kutsun tulokset tallennetaan, "tosi", jos ryhmä löytyi, ja "epätosi" muussa tapauksessa.

Pro on valinnainen ominaisuus tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää tämän ominaisuuden käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana on poikkeuksia.

Vahvista ryhmän jäsenyys

Yllä olevassa kuvassa identiteettiattribuuttimääritykset on täytetty Pro . Järjestelmänvalvojat valitsevat oikean Azure -hakemiston "Kohde"-kohdasta ja voivat tarkastella valitulle Azure -tehtävälle määritettyjä identiteettimäärityksiä. Tässä orkestrointinäkymässä et voi muuttaa määrityksiä, ne näytetään vain visuaalisena apuna. Jos määritemäärityksiä on tarpeen muuttaa, kyseiset määritteet on määritettävä valmistelutehtävän määritysnäkymässä, jotta niitä voidaan muuttaa orkestrointisolmussa.

”Tallenna tulos*” -kenttää käytetään määrittämään, minne onnistuneiden API -kutsujen tulokset tallennetaan. Arvo on ”true”, jos käyttäjä löytyi, tai ”false” muussa tapauksessa.

Pro on valinnainen ominaisuus tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää tämän ominaisuuden käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana on poikkeuksia.

Vahvista käyttäjä

Yllä olevassa kuvassa identiteettiattribuuttimääritykset on täytetty Pro . Järjestelmänvalvojat valitsevat oikean Azure -hakemiston "Kohde"-kohdasta ja voivat tarkastella valitulle Azure -tehtävälle määritettyjä identiteettimäärityksiä. Tässä orkestrointinäkymässä et voi muuttaa määrityksiä, ne näytetään vain visuaalisena apuna. Jos määritemäärityksiä on tarpeen muuttaa, kyseiset määritteet on määritettävä valmistelutehtävän määritysnäkymässä, jotta niitä voidaan muuttaa orkestrointisolmussa.

Identiteettimääritykset -ylläpitäjäpaneelissa ylläpitäjät voivat antaa "JOS"-lausekkeen, joka muodostaa API kutsun käyttäjän olemassaolon varmistamiseksi. Henkilötietokortista voi valita niin monta attribuuttia kuin on tarpeen käyttäjän yksilöllisyyden vahvistamiseksi. Kun toiminto suoritetaan, nämä attribuutit luetaan kyseisestä tietokortista ja niitä verrataan asianmukaisiin Azure -attribuutteihin "Kohde*" Azure -kokoonpanon mukaisesti. Ylläpitäjät voivat myös valita "yhtä suuri kuin" tai "ei yhtä suuri kuin" vastaavalle Azure attribuutille muuttamalla "JOS"-lauseketta. "Tallenna tulos*" -kenttää käytetään määrittämään, minne onnistuneet API kutsun tulokset tallennetaan, "tosi", jos käyttäjä löytyi, ja "epätosi" muuten.

Tämän solmun mekaniikan ymmärtämisen kannalta olennaista on, että IF-lauseketta muodostettaessa ylläpitäjän on käytettävä Template-mallin attribuutteja, mutta itse asiassa niistä luetut arvot muunnetaan (mapataan) oikeiksi Azure Directory -attribuuteiksi identiteettikartoituksen kokoonpanon mukaisesti ja välitetään Azure Directoryyn hakukyselynä.

Pro on valinnainen ominaisuus tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää tämän ominaisuuden käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana on poikkeuksia.

Luo mukautettu objekti

Vuodesta 2022.2 lähtien Efecte Provisioning Engine (EPE) on ottanut käyttöön uuden työnkulkutoiminnon "Luo mukautettu objekti". Esimerkiksi laitteita, yhteystietoja ja sovelluksia voidaan nyt luoda EPE:n avulla Azure AD kohti. Huomaa, että tällä toiminnolla on IGA lisenssi. Tämä tarkoittaa, että mukautettujen objektien luontia voidaan käyttää IGA -asennuksissa.

Yllä olevassa kuvassa identiteettiattribuuttimääritykset on täytetty Pro . Järjestelmänvalvojat valitsevat oikean Azure -hakemiston "Kohde"-kohdasta ja voivat tarkastella valitulle Azure -tehtävälle määritettyjä identiteettimäärityksiä. Tässä orkestrointinäkymässä et voi muuttaa määrityksiä, ne näytetään vain visuaalisena apuna. Jos määritemäärityksiä on tarpeen muuttaa, kyseiset määritteet on määritettävä valmistelutehtävän määritysnäkymässä, jotta niitä voidaan muuttaa orkestrointisolmussa.

Mukautettu objektiluokka määrittää, minkä objektin EPE luo. Tässä esimerkissä EPE luo kontakteja.

Pro on valinnainen ominaisuus tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää tämän ominaisuuden käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana on poikkeuksia.

Päivitä mukautettu objekti

Vuodesta 2023.1 lähtien Efecte Provisioning Engine (EPE) on ottanut käyttöön uuden työnkulkutoiminnon "Päivitä mukautettu objekti". Esimerkiksi laitteita, yhteystietoja ja sovelluksia voidaan nyt päivittää EPE:n avulla Azure AD kohti. Huomaa, että tällä toiminnolla on IGA lisenssi. Tämä tarkoittaa, että mukautettujen objektien luontia voidaan käyttää IGA -asennuksissa.

Yllä olevassa kuvassa identiteettiattribuuttimääritykset on täytetty Pro . Järjestelmänvalvojat valitsevat oikean Azure -hakemiston "Kohde"-kohdasta ja voivat tarkastella valitulle Azure -tehtävälle määritettyjä identiteettimäärityksiä. Tässä orkestrointinäkymässä et voi muuttaa määrityksiä, ne näytetään vain visuaalisena apuna. Jos määritemäärityksiä on tarpeen muuttaa, kyseiset määritteet on määritettävä valmistelutehtävän määritysnäkymässä, jotta niitä voidaan muuttaa orkestrointisolmussa.

Pro on valinnainen ominaisuus tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää tämän ominaisuuden käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana on poikkeuksia.

Poista mukautettu objekti

Vuodesta 2023.1 lähtien Efecte Provisioning Engine (EPE) on ottanut käyttöön uuden työnkulkutoiminnon "Poista mukautettu objekti". Esimerkiksi laitteita, yhteystietoja ja sovelluksia voidaan nyt poistaa EPE:n avulla Azure AD kohti. Huomaa, että tällä toiminnolla on IGA lisenssi. Tämä tarkoittaa, että mukautettujen objektien luontia voidaan käyttää IGA -asennuksissa.

Yllä olevassa kuvassa Object name -attribuutti määrittää, mitä objektia EPE poistaa. Tässä esimerkissä EPE poistaa yhteystietoja.

Pro on valinnainen ominaisuus tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää tämän ominaisuuden käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana on poikkeuksia.

Lue käyttäjätiedot

Vuodesta 2022.2 lähtien Efecte Provisioning Engine (EPE) on ottanut käyttöön uuden työnkulkutoiminnon ”Lue käyttäjän tiedot”. Tietoja voidaan päivittää viitteen taakse, esimerkiksi IGA tilin tiedot voidaan päivittää Identity Storagesta.

Yllä olevassa kuvassa person-attribuuttia käytetään oikean tilin tietojen päivittämiseen hakemistosta ESM:ään.

Pro on valinnainen ominaisuus tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää tämän ominaisuuden käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana on poikkeuksia.

Suorita valmistelutehtävä

Tätä toimintoa käytetään, kun kaikki hakemiston tiedot tarvitaan välittömästi takaisin.

Yllä olevassa kuvassa järjestelmänvalvojat voivat valita oikean kohdehakemiston. Suorita valmistelutehtävä orkestrointisolmun lukumääritteet Azure -hakemistosta IGA tileille.

"Kohde"-EPE-tehtävän vaatimukset ovat:

• Tehtävän on oltava tyyppiä "Ajoitettava tehtävä", ei tapahtumapohjainen
• Työnkulun mallin on oltava sama kuin identiteettikartoituksen malli.
• Tehtävä on ajoitettava johonkin aikaan - se merkitsee tehtävän "käytössä olevaksi" ja sitten
• Yhdistämismääritysten on oltava erillisiä, tehtävässä ei saa olla päällekkäisiä yhdistämismäärityksiä

Tässä orkestrointinäkymässä et voi muuttaa määrityksiä, ne näytetään vain visuaalisena apuna. Jos määritteiden määrityksiä on tarpeen muuttaa, kyseiset määritteet on määritettävä valmistelutehtävän määritysnäkymässä, jotta niitä voidaan muuttaa orkestrointisolmussa.

Pro on valinnainen ominaisuus tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää tämän ominaisuuden käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana on poikkeuksia.

Yleinen REST kutsu

Lisää Orchestration-solmu työnkulkuusi ja määritä seuraavat asiat.

Nimi - anna kuvaava nimi

Kuvaus - aseta kuvaileva kuvaus

Orkestroi - valitse Pro

Tietolähde - valitse Microsoft Graph API

Aktiviteetti - valitse Yleinen REST kutsu

Kohde - valitse tapahtumapohjainen tehtäväsi (voit käyttää samaa tehtävää useille orkestrointisolmuille)

Toiminto – valitse toiminto kutsumasi REST API perusteella (tarkista oikea toiminto API dokumentaatiosta). Tuetut toiminnot ovat: POST, PUT, PATCH, DELETE ja GET

REST URL - kutsuttava API-päätepiste. Tämä voi olla koko URL-osoite tai URL-osoitteen jälkiliite. Jos käytät jälkiliitettä, kutsuttava varsinainen URL-osoite yhdistetään käyttämällä kaikkia näitä: liittimen isännän URL-osoite + tehtäväkysely + orkestrointisolmun URL-osoite. Voit käyttää mallipohjaisia attribuuttimuuttujia samalla tavalla kuin sähköpostisolmussa käyttämällä dollarisyntaksia, kuten: $attribute_code$ ja $reference:attribute_code$.

Huom! Jos URL-osoitteessasi on välilyöntejä tai $-merkkejä, muista koodata ne URL-osoitteeseen. Joten $ on %24, välilyönti on %20.
Esim. tämä url: users?%24count=true&$filter=userprincipalname eq 'test' on koodattu näin: users?$count=true&%24filter=userprincipalname%20eq%20'test'

Loput body - JSON-body API-kutsua varten. Voi olla tyhjä, jos kutsumasi API ei tarvitse bodya. Voit myös käyttää {}-merkkiä, jos bodyn jättäminen ei toimi Microsoftin kanssa. Katso bodyn tiedot API dokumentaatiosta. Voit käyttää mallipohjan attribuuttimuuttujia samalla tavalla kuin sähköpostisolmussa käyttämällä dollarin syntaksia, kuten: $attribute_code$ ja $reference:attribute_code$.

Esimerkiksi tässä rungossa on kaksi muuttujaa: $firstname$ ja $lastname$
{"nimi": {
"givenName": "$firstname$",
"perhenimi": "$sukunimi$"}}

Jos sinun täytyy luoda monimutkainen json-runko API kutsua varten, voit ensin rakentaa koko json-koodin somedatacard-attribuutin avulla. Ja sitten vain kyseisen attribuutin koodi jää rungon osaksi, kuten tässä:$generated_json_body_attributecode$

import json

if onPremisesExtensionAttributes:
  _data = this.get("onPremisesExtensionAttributes")
  _obj = json.loads(_data)
  _value = _obj["extensionAttribute14"]
  this.set("extensionAttribute14code",_value)

Rest-vastausattribuutti - API kutsun resultset json kirjoitetaan tähän attribuuttiin. Kaikki API :t eivät palauta json-vastausta. Katso lisätietoja API dokumentaatiosta.

import json

if onPremisesExtensionAttributes:
  _data = this.get("onPremisesExtensionAttributes")
  _obj = json.loads(_data)
  _value = _obj["extensionAttribute14"]
  this.set("extensionAttribute14code",_value)

Pro - Jos REST API -kutsussa on ongelma, tähän attribuuttiin kirjoitetaan virhe.

Yleisten REST -kutsujen poikkeusten käsittely:

• Pro on valinnainen ominaisuus tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää tämän ominaisuuden käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana on poikkeuksia.
• Solmun tulos on "Valmis"-tilassa, jos Microsoft Graph API http-vastauskoodi on 200 tai yli ja alle 400.
• Tiedot onnistuneista/epäonnistuneista Microsoft Graph API -kutsuista löytyvät lokeista.

Tässä luvussa kuvataan vianmääritysvaihtoehtoja,

• Jos käytetään vikamallia, tarkista oikea datakortti
• Tarkista ajoitettujen tehtävien historia liitinten hallinnasta
• Tarkista Efecte Provisioning Engine lokit
• Tällä hetkellä EPE ei tue saman Entra ID -attribuutin yhdistämistä useisiin ESM-attribuutteihin. Käyttöliittymä kuitenkin sallii tämän määrityksen, mikä voi johtaa virheisiin.