Siirry sisältöön
Service status

Kirjoita hakeaksesi

SSO ja Käyttäjäryhmät · 5 min lukuaika

Käyttäjien provisiointi (SCIM)

Miten SCIM antaa identiteetin tarjoajasi luoda, päivittää, deaktivoida ja poistaa Intric-tilejä, miten otat sen käyttöön Microsoft Entra ID:ssä ja mitä se ei kata.

SCIM (System for Cross-domain Identity Management) on standardi käyttäjätilien siirtämiseen järjestelmästä toiseen. Kun SCIM on käytössä, identiteetin tarjoajasi (IdP) päättää, kenellä on Intric-tili ja onko tili aktiivinen: lisäämäsi käyttäjän tili luodaan Intriciin ennen hänen ensimmäistä kirjautumistaan, ja poistamasi käyttäjä menettää pääsynsä ilman, että kenenkään tarvitsee tehdä mitään Intricissä.

Tämä sivu on tarkoitettu IdP:si ylläpitäjälle. Ohjeet koskevat Microsoft Entra ID:tä. Jos käytät toista IdP:tä, joka tukee SCIM 2.0:aa, ota yhteyttä Intricin tukeen.

SCIM ja SSO ovat erillisiä, ja tarvitset molempia.

  • SSO hoitaa sen, miten käyttäjä kirjautuu sisään.
  • SCIM hoitaa sen, onko käyttäjällä tili ja missä tilassa se on.

Pelkällä SSO:lla tili luodaan ja päivitetään vasta, kun käyttäjä kirjautuu sisään. IdP:stäsi poistamasi käyttäjä ei enää pääse kirjautumaan, mutta hänen Intric-tilinsä pysyy aktiivisena, kunnes joku deaktivoi sen käsin. Uutta käyttäjää ei myöskään ole Intricissä ennen hänen ensimmäistä kirjautumistaan, joten ylläpitäjä ei voi valmistella mitään hänelle etukäteen.

Pelkällä SCIM:llä käyttäjä saa tilin mutta ei pääse kirjautumaan sisään. SCIM ei luo salasanaa, joten sisäänkirjautuminen kulkee edelleen SSO:n kautta.

SCIM:n lisääminen ei muuta mitään nykyisessä SSO-määrityksessäsi. Ota SSO käyttöön ensin, katso SSO ja käyttäjäryhmät.

Muutos IdP:ssäsi Vaikutus Intricissä
Käyttäjä liitetään provisiointisovellukseen Tili luodaan ennen käyttäjän ensimmäistä kirjautumista User-roolilla ja oletuslaskutusryhmääsi. Tili näkyy käyttäjäluettelossa tilassa Kutsuttu, kunnes käyttäjä kirjautuu sisään ensimmäisen kerran.
Käyttäjän liitos poistetaan tai hänen tilinsä poistetaan käytöstä Tili deaktivoidaan, ja se näkyy tilassa Ei aktiivinen. Käyttäjä ei voi kirjautua sisään, ja hänen istuntonsa ja API-avaimensa hylätään. Mitään ei poisteta, ja muutoksen voi perua.
Käyttäjä otetaan uudelleen käyttöön tai liitetään uudelleen Tili palautetaan kaikkine sisältöineen.
Käyttäjä poistetaan Tili deaktivoidaan heti. Kun Entra ID poistaa käyttäjän pysyvästi noin 30 päivän kuluttua, tili poistetaan Intricistä: se katoaa kaikista luetteloista, ja sen sähköpostiosoitteen voi ottaa uudelleen käyttöön. Käyttäjän luoma sisältö ja auditointihistoria säilyvät.
Käyttäjän nimi muuttuu Nimi päivitetään, ellei käyttäjä ole itse muuttanut nimeään Intricissä. Käyttäjän Intricissä valitsema nimi säilyy.
Käyttäjän sähköpostiosoite muuttuu Sähköpostiosoite päivitetään, kun se on vahvistettu ja edellyttäen, ettei mikään toinen Intric-tili käytä sitä.

Muutama sääntö ratkaisee tapaukset, joita taulukko ei kata:

  • Käyttäjä, jolla on jo Intric-tili samalla sähköpostiosoitteella, pitää tämän tilin. Toista tiliä ei luoda. Sama koskee käyttäjää, jolla on odottava kutsu: hän liittyy kutsun kautta.
  • Tili, jonka Intricin ylläpitäjä on deaktivoinut käsin, pysyy deaktivoituna. Käyttäjän ottaminen uudelleen käyttöön IdP:ssäsi palauttaa vain tilit, jotka IdP:si on deaktivoinut.
  • Jokainen SCIM:n tekemä muutos kirjataan Intricin audit-lokiin.
  • Se toimii vain yhteen suuntaan. Muutokset kulkevat IdP:ltäsi Intriciin, eivät koskaan takaisin. Roolin muuttaminen, käyttäjän deaktivointi tai käyttäjän siirtäminen toiseen laskutusryhmään Intricissä ei muuta mitään IdP:ssäsi.
  • Se ei synkronoi ryhmiä. Ryhmäjäsenyydet päivittyvät edelleen aina, kun käyttäjä kirjautuu sisään, kuten kuvataan sivulla Käyttäjäryhmät.
  • Se ei anna rooleja. Provisioidut käyttäjät saavat User-roolin. Intricin ylläpitäjä muuttaa roolit Intricissä.
  • Se ei ole välitön. Entra ID lähettää muutokset jaksoissa, jotka ajetaan 40 minuutin välein. Intric ottaa kunkin muutoksen käyttöön sekunneissa sen vastaanottamisesta. Jos haluat katkaista käyttäjän pääsyn heti, deaktivoi hänet myös Intricin käyttäjähallinnassa.
  • SSO Entra ID:n kanssa on jo toiminnassa organisaatiossasi.
  • Application Administrator- tai Cloud Application Administrator -rooli Entra ID:ssä.
  • Entra ID P1 tai P2, jos liität yksittäisten käyttäjien sijaan ryhmiä.
  • Kaksi arvoa Intricistä, lähetettynä suojatun kanavan kautta: Tenant URL ja Secret Token. Pyydä Intricin tukea ottamaan provisiointi käyttöön organisaatiossasi, niin lähetämme molemmat.

Entra ID:n oma provisiointipalvelu tekee työn. Se yhdistää Intricin kirjautumispalveluun, login.intric.ai, Secret Tokenilla ja hallinnoi vain organisaatiosi käyttäjiä.

Provisioinnin määrittäminen Entra ID:ssä

Osio nimeltä “Provisioinnin määrittäminen Entra ID:ssä”

Provisiointi toimii omasta yrityssovelluksestaan, joka on erillinen kirjautumiseen käyttämästäsi sovelluksen rekisteröinnistä.

Luo provisiointisovellus

  1. Siirry Entra admin centerissä kohtaan Entra IDEnterprise apps ja klikkaa New application.
  2. Klikkaa Create your own application.
  3. Anna sovellukselle nimi, jonka ylläpitäjäsi tunnistavat, esimerkiksi Intric provisioning, valitse Integrate any other application you don’t find in the gallery (Non-gallery) ja klikkaa Create.

Yhdistä se Intriciin

  1. Avaa uudessa sovelluksessa Provisioning ja aseta provisiointitilaksi Automatic.
  2. Liitä kohdassa Admin Credentials Intricistä saamasi Tenant URL ja Secret Token.
  3. Klikkaa Test Connection. Testin täytyy onnistua, ennen kuin jatkat. Jos se epäonnistuu, tarkista, että molemmat arvot on liitetty kokonaisina, ja ota sitten yhteyttä Intricin tukeen.
  4. Tallenna.

Määritä attribuuttien yhdistämiset

  1. Avaa kohdassa Mappings Provision Microsoft Entra ID Users ja säilytä vain alla olevan taulukon yhdistämiset. Poista muut, kuten osasto ja tehtävänimike: Intricin kirjautumispalvelu ei tallenna niitä.
  2. Avaa kohdassa Mappings Provision Microsoft Entra ID Groups ja aseta Enabled-asetukseksi No.
  3. Aseta kohdassa Settings Scope-asetukseksi Sync only assigned users and groups.
Entra ID -attribuutti SCIM-attribuutti
userPrincipalName userName
Switch([IsSoftDeleted], , "False", "True", "True", "False") active
mail emails[type eq "work"].value
givenName name.givenName
surname name.familyName
displayName displayName
objectId externalId

Testaa yhdellä käyttäjällä ja aloita sitten

  1. Liitä kohdassa Users and groups yksi testikäyttäjä.
  2. Avaa Provision on demand, valitse testikäyttäjä ja klikkaa Provision. Tulos luettelee jokaisen vaiheen ja sen, mitä kirjautumispalvelu vastasi.
  3. Varmista Intricin tuelta, että tili ilmestyi Intriciin.
  4. Liitä samat käyttäjät ja ryhmät, jotka on liitetty kirjautumissovellukseesi.
  5. Klikkaa Start provisioning.

Tästä lähtien käyttäjän lisääminen liitettyyn ryhmään antaa hänelle Intric-tilin, ja hänen poistamisensa ryhmästä vie tilin pois.

Entra ID:n vaiheet ovat samat. Kaksi asiaa eroaa.

Luot tunnuksen itse. Asennuksessasi toimii oma kirjautumispalvelu, joten sen sijaan, että saisit Tenant URL:n ja Secret Tokenin Intriciltä, luot palvelukäyttäjän ja sen tokenin omassa kirjautumispalvelussasi. Intric opastaa sinua siinä. Asennuksesi vaatii Intric backendin version 2.7.0 tai uudemman ja Zitadelin version 4.13 tai uudemman.

Entra ID:n täytyy myös tavoittaa kirjautumispalvelusi. Sen provisiointipalvelu toimii Microsoftin pilvessä, ja kirjautumispalvelusi on verkkosi sisällä. Verkkotiimisi täytyy sallia tämä liikenne. Vaihtoehtoja on kaksi:

  • Julkaise vain kirjautumispalvelimesi /scim/v2/-polku Microsoftin provisiointipalvelulle.
  • Asenna Microsoftin paikallinen provisiointiagentti verkkosi sisälle, jolloin se tavoittaa kirjautumispalvelun ilman, että mitään avataan sisäänpäin.

Valinta on sinun. Kerro Intricille, kumman valitset, ja jos kumpikaan ei sovi, kehitämme kanssasi toimivan ratkaisun.

  • Secret Tokenilla on vanhenemispäivä. Kun se umpeutuu, provisiointi pysähtyy ilman virhettä Intricissä: seuraava Entra ID:n jakso epäonnistuu, eikä käyttäjiä enää luoda tai deaktivoida. Pyydä Intriciltä uusi token ennen päivää ja liitä se kohtaan Admin Credentials.
  • Tarkista provisiointilokit, kun muutos ei saavu perille. Provisiointisovelluksessa Provisioning logs näyttää jokaisen käyttäjän, jonka Entra ID yritti lähettää, ja saamansa vastauksen. Jos Entra ID ilmoittaa onnistumisesta ja Intric näyttää muutaman minuutin kuluttua yhä vanhan tilan, ota yhteyttä Intricin tukeen ja kerro käyttäjän sähköpostiosoite ja kellonaika.