Okta-yhteyden luominen

Yhdistä Okta-hakemistosi ja synkronoi jäsenet Klangiin. Valitse kaikki synkronoidut käyttäjät tai rajaa käyttöoikeus tiettyihin ryhmiin.

Klang voi synkronoida myös Microsoft Entrasta, Google Workspacesta tai muusta SCIM-palvelusta. Kukin työtila käyttää yhtä palveluntarjoajaa kerrallaan. Useat työtilat voivat jakaa saman Okta-yhteyden.

Ennen kuin aloitatte

Tarvitsette kaksi asiaa:

• Klangissa: järjestelmänvalvojan oikeudet Pro- tai Enterprise-työtilassa
• Oktassa: oikeus lisätä sovellus ja määrittää provisiointi

Ryhmät ovat valinnaisia. Suunnittele ryhmät, jos haluat antaa eri henkilöille erilaiset käyttöoikeudet tai roolit.

Arvojen hakeminen Klangista

1. Avatkaa Klangissa Asetukset → Työtila → Jäsenet → Jäsenten synkronointi
2. Napsauta SCIM-hakemisto-kortissa Yhdistä
3. Valitkaa avautuvasta valintaikkunasta välilehti Okta
4. Napsauta Tallenna, niin yhteys luodaan ja URL-osoite sekä tunnus tulevat näkyviin

Klang näyttää perus-URL:n ja tunnuksen sekä vaiheet, jotka teette Oktassa.

Tunnus näytetään vain kerran. Kopioikaa se ennen kuin suljette valintaikkunan. Jos se katoaa, napsauttakaa Luo uusi tunnus, mutta vanha lakkaa toimimasta heti.

Jos Yhteysasetukset näkyvät, pitäkää Luo uusi yhteys valittuna uutta yhteyttä varten. Jos haluatte käyttää aiempaa yhteyttä, valitkaa sen sijaan hallinnoimanne työtila ja napsauttakaa Tallenna. Uutta tokenia tai palveluntarjoajan määritystä ei tarvita.

Voitte lukea ohjeet uudelleen avaamalla yhteyskortin valikon Lisää vaihtoehtoja (⋮) ja valitsemalla Näytä asetukset. URL-osoite ja palveluntarjoajan ohjeet ovat edelleen saatavilla, mutta tallennettua tokenia ei voi näyttää uudelleen. Sulje sulkee ohjeen muuttamatta yhteyttä.

Sovelluksen lisääminen Oktaan

1. Menkää Oktan hallintakonsolissa kohtaan Applications
2. Napsauttakaa Browse App Catalog
3. Hakekaa SCIM 2.0 Test App (OAuth Bearer Token) ja napsauttakaa Add integration
4. Antakaa sille nimeksi Klang ja napsauttakaa sitten Next ja Done

Nimestä huolimatta tämä on Oktan yleiskäyttöinen SCIM-liitin. Näin yhdistetään sovellus, jota ei ole Okta Integration Networkissa, ja se on sama liitin, johon moni toimittaja ohjeistaa.

Arvojen liittäminen Oktaan

1. Avatkaa Klang-sovelluksessa Provisioning
2. Valitkaa vasemmasta sarakkeesta Integration ja napsauttakaa Edit
3. Rastittakaa Enable API integration
4. Liittäkää Klangin perus-URL kenttään SCIM 2.0 Base Url
5. Liittäkää Klangin tunnus kenttään OAuth Bearer Token
6. Napsauttakaa Test API Credentials. Oktan pitäisi vastata, että sovellus “was verified successfully”
7. Napsauttakaa Save

Jos testi epäonnistuu, tarkistakaa, että kopioitte koko tunnuksen ja ettei perus-URL:n lopussa ole kauttaviivaa.

Klangin tarvitsemien toimintojen käyttöönotto

Tämä vaihe jää helposti väliin, ja ilman sitä kaikki sen jälkeen epäonnistuu hiljaisesti.

1. Edelleen kohdassa Provisioning: valitkaa vasemmasta sarakkeesta To App ja napsauttakaa Edit
2. Ottakaa käyttöön Create Users, Update User Attributes ja Deactivate Users
3. Jättäkää Sync Password pois päältä. Klang ei koskaan kirjaa ketään sisään Oktasta tulleella salasanalla
4. Napsauttakaa Save

Tehkää muutokset Edit-lomakkeen sisällä. Samat valinnat näkyvät myös sen yläpuolella vain luettavina, eikä niiden rastittaminen tee mitään.

Ilman Create Users -valintaa Okta vain etsii henkilöitä, jotka ovat jo Klangissa, eikä luo ketään. Jokainen määritys epäonnistuu silloin virheeseen Automatic provisioning of user ... failed: Matching user not found.

Henkilöiden määrittäminen

1. Avatkaa välilehti Assignments
2. Napsauttakaa Assign ja sitten Assign to People tai Assign to Groups
3. Valitkaa, ketkä provisioidaan, ja napsauttakaa Save and Go Back ja sitten Done

Määrittäminen luo henkilön Klangiin. Se ei vielä anna pääsyä työtilaan; se on alla oleva viimeinen vaihe.

Valinnainen: Ryhmien lähettäminen

Voit ohittaa ryhmien provisioinnin valinnalla Kaikki synkronoidut käyttäjät. Jos haluat valita Klangissa tietyt ryhmät, lähetä ryhmät ja niiden jäsenyydet.

Okta lähettää ryhmien nimet erillään henkilöistä, joten juuri tämä vaihe tuo ryhmänne näkyviin Klangiin.

Jos määrität sovelluksen ryhmän kautta, käytä Push Groups -toiminnolle eri ryhmää.

1. Avatkaa välilehti Push Groups
2. Napsauttakaa Push Groups → Find groups by name
3. Kirjoittakaa ryhmän nimi ja valitkaa se luettelosta
4. Jättäkää Push group memberships immediately rastitetuksi
5. Okta ilmoittaa Match found, jos samanniminen ryhmä on jo Klangissa; valitkaa silloin Link Group. Muussa tapauksessa se tarjoaa Create Group
6. Napsauttakaa Save

Tämän työtilan jäsenten valinta

Kaikki synkronoidut käyttäjät antaa jäsenen käyttöoikeuden kaikille tämän yhteyden kautta lähetetyille aktiivisille käyttäjille. Hallitse ylläpitäjiä Klangissa. Palveluntarjoajasi päättää edelleen, mitkä käyttäjät lähetetään.

1. Palatkaa kohtaan Jäsenten synkronointi ja etsikää Ketkä saavat käyttöoikeuden?
2. Valitse Kaikki synkronoidut käyttäjät tai Valitse tietyt ryhmät. Jos valitset tietyt ryhmät, määritä, mitkä antavat roolin Ylläpitäjä tai Jäsen
3. Napsauttakaa Näytä keitä valinta koskee käydäksenne läpi valintaan kuuluvat henkilöt
4. Käykää läpi tarvittavat lisälisenssit ja napsauttakaa Tallenna

Ryhmät saavat mennä päällekkäin; kukin henkilö lasketaan kerran työtilaa kohti. Uudesta yhteydestä kukaan ei saa pääsyä ennen kuin tallennatte valinnan.

Yhteyden käyttö toisessa työtilassa

1. Vaihtakaa toiseen työtilaan, jota hallinnoitte
2. Avatkaa Asetukset → Työtila → Jäsenet → Jäsenten synkronointi
3. Napsauta SCIM-hakemisto-kortissa Yhdistä
4. Valitkaa työtila, jonka yhteyden haluatte käyttää uudelleen
5. Ota yhteys käyttöön napsauttamalla Tallenna
6. Valitse, ketkä saavat käyttöoikeuden, ja tallenna valinta

Teidän on hallinnoitava molempia työtiloja, kun yhdistätte ne. Yhteys on jaettu, joten Okta tarvitsee määrittää vain kerran. Sama ryhmä voi antaa eri roolit eri työtiloissa.

Mitä tästä eteenpäin tapahtuu

• Tallennettuun valintaasi kuuluvat aktiiviset käyttäjät saavat käyttöoikeuden tähän työtilaan
• Käyttäjät, jotka poistetaan käytöstä tai eivät enää kuulu valintaasi, menettävät synkronoidun käyttöoikeutensa. Heidän sisältönsä säilyy
• Sovelluksesta poistettu tai Oktassa käytöstä poistettu henkilö menettää pääsyn samalla tavalla
• Järjestelmänvalvojaryhmät voivat ylentää jäseniä. Nykyiset järjestelmänvalvojat säilyttävät roolinsa siirtyessään jäsenryhmään
• Ne, jotka eivät ole koskaan kirjautuneet Klangiin, saavat kutsun sähköpostitse

Jatkatte henkilöiden hallintaa Oktassa. Klang seuraa perässä.

Tunnuksen vaihtaminen

Avaa yhteyskortin valikko Lisää vaihtoehtoja (⋮) ja valitse Luo uusi token. Kuka tahansa yhdistetyn työtilan järjestelmänvalvoja voi tehdä sen. Vahvistus nimeää kaikki koskevat työtilat: vanha tunnus lakkaa toimimasta niissä kaikissa. Liittäkää uusi Oktan kenttään OAuth Bearer Token, niin synkronointi jatkuu.

Jos jokin ei synkronoidu

• Test API Credentials kohdassa Provisioning → Integration tarkistaa yhteyden milloin tahansa uudelleen
• Okta näyttää henkilökohtaiset virheet välilehdellä Assignments. Napsauttakaa henkilön vieressä olevaa punaista kuvaketta lukeaksenne syyn
• Matching user not found tarkoittaa, että Create Users on pois päältä. Katso yllä oleva vaihe
• Välilehti Import lukee ryhmänne takaisin Klangista, mutta ei henkilöitänne. Klang vastaa koko käyttäjäluettelon pyyntöön tarkoituksella tyhjällä tuloksella, koska se ei ole hakemistonne totuuden lähde. Oikea suunta on push

Yhteyden katkaiseminen

Napsauttakaa Lisää vaihtoehtoja (⋮) → Katkaise yhteys lopettaaksenne tämän työtilan synkronoinnin. Nykyiset jäsenet säilyttävät pääsynsä ja siirtyvät manuaaliseen hallintaan; synkronoinnin vastausta odottavat kutsut peruutetaan. Muut yhdistetyt työtilat jatkavat synkronointia. Viimeisen työtilan katkaiseminen poistaa myös jaetun yhteyden ja sen tunnuksen.