Microsoft Entra ID -integraatio

Sisällysluettelo

• Useat yhteydet
• Vaihe 1: Rekisteröi uusi sovellus Microsoft Azuressa
• Vaihe 2: Luo Client secret -avain
• Vaihe 3: Lisää sovellukselle API-käyttöoikeus (vain todennustavalla «Palvelusta palveluun»)
• Vaihe 4: Yhdistä Huma Entra ID:hen
• Todennustavat
• Vaihe 5: Ota integraatio käyttöön

Aktiivinen integraatio

• Integraatio on aktiivinen
• Synkronoi käyttäjät
• Deaktivoidut tai poistetut käyttäjät
• Tuetut kentät – työntekijän kentät
• Tuetut kentät – tehtävän kentät

Yleiset kysymykset

• UKK: Entra ID ja Human tehtäväintegraatio

Ota Entra-kirjautuminen käyttöön

• Työntekijöiden kirjautuminen Entra ID:llä

Useat yhteydet

Jos sinun täytyy määrittää useita integraatioyhteyksiä, noudata näitä ohjeita.

1: Rekisteröi uusi sovellus Microsoft Azuressa

Integraation määrittäminen Humassa edellyttää järjestelmäroolia, jolla on täydet oikeudet organisaatioon.

Jos et ole varma, mitä rooleja tarvitset Entra ID:n puolella integraation määrittämiseen, pyydä ohjeita Entra ID:n tuesta.

1. Jotta Huma pääsee Entra ID:hen, sinun on luotava Azure-tilillesi sovellus, johon Huma yhdistetään, ja annettava sille oikeus käyttää Entraa.
2. Kirjaudu Microsoft Azure -tilillesi.
3. Kirjoita yläreunan hakukenttään 'App registrations' ja napsauta hakutulosta.

4. Napsauta 'New registration' -painiketta.

5. Anna sovellukselle nimi, esimerkiksi 'Huma'.

6. Valitse kohdassa 'Supported account types' vaihtoehto 'Accounts in this organizational directory only'.

7. 'Redirect URI'

• • Jos yhdistät tavalla «Palvelusta palveluun» (suositus):
    • Jätä Redirect URI -kenttä tyhjäksi.
      
      
  • Jos yhdistät Humassa tavalla «Käyttäjätunnuksellasi»:
    
    • Valitse sovelluksen tyypiksi 'Web'.
    • Aseta Redirect URI -osoitteeksi

      https://auth.humahr.com/oauth

• Lue lisää todennustavoista «Palvelusta palveluun» ja «Käyttäjätunnuksellasi» kohdasta Yhdistä Huma Entra ID:hen.

2: Luo Client secret -avain

1. Napsauta 'Overview'-sivulla 'Add a certificate or secret'.
2. Napsauta 'New client secret' -painiketta.
3. Anna client secretille nimi, esimerkiksi 'Huma client secret'.
4. Valitse voimassaoloaika. Kun aika päättyy, sinun on luotava uusi client secret ja yhdistettävä Huma uudelleen.
5. Napsauta 'Add'-painiketta.
6. Kopioi 'Value'-avain ja tallenna se turvalliseen paikkaan. Et näe avainta enää, kun poistut tältä sivulta.

3: Lisää sovellukselle API-käyttöoikeus

1. Siirry kohtaan 'API permissions' ja napsauta 'Add a permission' -painiketta.
2. Valitse 'Microsoft Graph' ja sitten 'Application permissions'.
3. Hae 'User' ja avaa se.
4. Valitse 'User.ReadWrite.All' ja napsauta 'Add permission' -painiketta.
5. Napsauta 'Grant admin consent for [yrityksesi]' -painiketta.

Yhdistä Entra Humaan

1. Kirjaudu Humassa olevaan organisaatioosi.
2. Siirry kohtaan «Integraatiot» ja valitse «Microsoft Entra ID».
3. Lue kaikki Entra ID -integraatiota koskevat tiedot ennen kuin siirryt seuraavaan vaiheeseen:
   • «Käyttöohjeet»
   • «Tuetut toiminnot»
   • «Tuetut kentät»
4. Napsauta oikeasta yläkulmasta «Määritä».
   
   

Todennustavat

Todennustavat

• Palvelusta palveluun (suositus)
  Todennus on sidottu Humassa olevaan organisaatioosi.

• Käyttäjätunnuksellasi
  Todennus on sidottu käyttäjään, joka määrittää integraation. Jos käyttäjä menettää User Administration -roolin Microsoft Azuressa, integraatio lakkaa toimimasta.

1. Kopioi Microsoft Azuresta 'Directory (tenant) ID' ja liitä se Humassa kenttään «Tenant ID». Kopioi Azuresta 'Application (client) ID' ja liitä se Humassa kenttään «Client ID».
2. Löydät nämä arvot Microsoft Azuressa sovelluksesi 'Overview'-sivulta.
3. Liitä aiemmin tallentamasi Client secret -arvo. (Jos et tallentanut arvoa, poista client secret ja luo uusi.) Napsauta sitten «Jatka».
4. Voit valita, lisätäänkö käyttäjät automaattisesti Entra ID:hen, kun lisäät heitä Humaan. Jos jätät asetuksen pois päältä, sinun on synkronoitava manuaalisesti, jotta käyttäjä lisätään Entra ID:hen.
   1. Jos käytät Teamtailor-integraatiota tai Nuu-integraatiota, niiden kautta Humaan lisätyt käyttäjät lisätään myös Entra ID:hen.
   2. Käyttäjien luonti epäonnistuu, jos käyttäjä on luotu Humaan yksityisellä sähköpostiosoitteella. Käyttäjällä on siksi oltava työsähköpostiosoite valmiina etukäteen.
      
      
5. Jos haluat, että työntekijät voivat kirjautua Microsoft Entra ID:llä, ota integraation asetuksissa käyttöön kirjautuminen Entra ID:llä ("Allow login with Entra ID"). Tämä valinta määrittää, näkyykö Entra ID kirjautumisvaihtoehtona organisaatiosi kirjautumissivulla.
   
   

TÄRKEÄÄ

Lisää Entra ID -sovelluksen asetuksissa tämä Web Redirect URI kohtaan App registrations > Authentication:

https://auth.humahr.com/

1. Napsauta «Tallenna», niin järjestelmien välille muodostetaan yhteys. Siirry sitten seuraavaan vaiheeseen – siinä tapahtuu varsinainen taika.
2. Ota integraatio käyttöön. Synkronoi käyttäjät ja valitse, miten ristiriidat tai puuttuvat arvot käsitellään.
3. Kun napsautat «Jatka», siirryt vaiheeseen «Synkronoi käyttäjät».
   1. Huma kertoo, jos Human ja Entra ID:n välillä on ristiriitoja tai epäjohdonmukaisuuksia, ja sinun on päätettävä, miten ristiriidat ja/tai puuttuvat arvot käsitellään. Voit valita, päivitetäänkö Entra ID Human arvojen perusteella vai päinvastoin.
4. Napsauta «Seuraava» ja valitse, mitkä käyttäjät luodaan Humaan ja Entra ID:hen.
   1. Jos Entra ID:ssä olevia käyttäjiä ei ole Humassa, voit lisätä heidät Humaan.
   2. Jos Humassa olevia käyttäjiä ei ole Entra ID:ssä, voit lisätä heidät Entra ID:hen.
5. Kun olet tehnyt valinnat, napsauta «Synkronoi käyttäjät».
6. Huma aloittaa käyttäjien synkronoinnin Entra ID:n kanssa. Saat tuloksesta vahvistuksen sähköpostiisi.

Human ja Entra ID:n välinen yhteys on aktiivinen

Kaikki muutokset Humassa oleviin tuettuihin kenttiin (lueteltu alla) päivittyvät automaattisesti Entra ID:hen reaaliajassa.

Huomaa, että sinun on synkronoitava käyttäjät saadaksesi uusimmat muutokset Entra ID:stä. Entra ID:ssä tehdyt muutokset eivät päivity Humaan automaattisesti.

Käyttäjien synkronointi manuaalisesti

Käytä toimintoa «Synkronoi käyttäjät» aina, kun olet päivittänyt jotakin tuetuista kentistä Entra ID:ssä tai kun haluat luoda uusia käyttäjiä. Jotta käyttäjien synkronointi toimii, sähköpostiosoitteen on aina oltava sama molemmissa järjestelmissä.

1. Siirry Humassa Entra ID -integraatioon.

2. Napsauta «Synkronoi käyttäjät».

3. Noudata ohjeita.

Huomaa

• Jos olet luonut käyttäjän Humaan, sinun on synkronoitava manuaalisesti, jotta käyttäjä luodaan integraation kautta Entra ID:hen (jos käyttäjien automaattinen luonti ei ole käytössä).

• Jos synkronoinnissa tapahtuu virhe, näet tarkemmat tiedot Human Entra ID -integraatiosivun kohdassa «Error log».

Deaktivoidut tai poistetut käyttäjät

• käyttäjää ei deaktivoida Entrassa.
• käyttäjän tietoja ei enää päivitetä.

Kun käyttäjä poistetaan Humasta:

• käyttäjää ei poisteta Entrasta.
• manuaalinen synkronointi pyytää sinua luomaan käyttäjän Entraan.
• käyttäjää ei voi synkronoida, jos hänen tietojaan on muutettu Entrassa.

Jos deaktivoit tai poistat käyttäjän Entrassa, käyttäjä ei voi kirjautua Humaan Entra-integraation kautta, eikä käyttäjää poisteta Humasta.

Tuetut kentät – synkronoitavat työntekijän kentät

Humassa tuettuihin kenttiin (lueteltu alla) tehdyt muutokset päivittyvät automaattisesti Entra ID:hen reaaliajassa. Entra ID:ssä tehdyt muutokset on sen sijaan synkronoitava Humaan manuaalisesti.

mail

givenName

surname

mobilePhone

streetAddress

postalCode

city

country

employeeId

Tuetut kentät – synkronoitavat tehtävän kentät

📄 Lue lisää siitä, miten työntekijätietojen synkronointi toimii integraatioissa yleisesti.

⚠️ Huomaa, että integraation käyttöönotto ei siirrä aiempia tehtävätietoja Entra ID:hen. Vain tehtävät, jotka luodaan tai päivitetään Humassa integraation käyttöönoton jälkeen, synkronoidaan.

Tehtävätiedot synkronoidaan vain Humasta Entra ID:hen, ei Entra ID:stä Humaan.

employeeHireDate

jobTitle

UKK: Humasta Entra ID:hen -tehtäväintegraatio

Päivittääkö integraatio tehtävätietoja?

Kyllä. Kun tuettuja tehtävän kenttiä muutetaan Humassa, päivitykset lähetetään automaattisesti Entra ID:hen.

Mihin suuntaan tiedot synkronoidaan?

Tehtävätiedot synkronoidaan vain yhteen suuntaan:

Huma → Entra ID

Suoraan Entra ID:ssä tehtyjä muutoksia ei lähetetä takaisin Humaan.

Milloin tehtävätiedot lähetetään Entra ID:hen?

Tehtävätiedot lähetetään Entra ID:hen, kun:

• Humassa luodaan uusi tehtävä

• Humassa päivitetään olemassa oleva tehtävä

• käyttäjä, jolla on tehtävä Humassa, luodaan Entra ID:hen manuaalisella synkronoinnilla

• muutos tapahtuu integraation käyttöönoton jälkeen

Voiko aiempia tehtäviä siirtää?

Ei. Integraatio ei siirrä automaattisesti aiempia tehtävätietoja, jotka olivat olemassa ennen integraation käyttöönottoa.

Miksi kaikkia tehtävän kenttiä ei synkronoida?

Kaikkia tehtävän kenttiä ei voi synkronoida Human ja Entra ID:n välillä, koska järjestelmät tallentavat ja jäsentävät työsuhdetietoja eri tavoin. Jotkin kentät ovat olemassa vain toisessa järjestelmässä, tai niiden tietorakenteet eivät vastaa suoraan toisiaan. Joissakin tapauksissa Entra ID:n API:n rajoitukset tai tapa, jolla tietoja käsitellään Humassa, estävät täyden yksi yhteen -vastaavuuden järjestelmien välillä.

Työntekijöiden kirjautuminen Entra ID:llä

Jos haluat, että työntekijät voivat kirjautua Microsoft Entra ID:llä, ota integraation asetuksissa käyttöön kirjautuminen Entra ID:llä ("Allow login with Entra ID"). Tämä valinta määrittää, näkyykö Entra ID kirjautumisvaihtoehtona organisaatiosi kirjautumissivulla.

TÄRKEÄÄ:
Lisää Entra ID -sovelluksen asetuksissa tämä Web Redirect URI kohtaan App registrations > Authentication:

https://auth.humahr.com/