Delen via

Zelfstudie: Integratie van eenmalige aanmelding van Microsoft Entra met Kronos Workforce Dimensions

  • Artikel

In deze zelfstudie leert u hoe u Kronos Workforce Dimensions integreert met Microsoft Entra ID. Wanneer u Kronos Workforce Dimensions integreert met Microsoft Entra ID, kunt u het volgende doen:

  • In Microsoft Entra ID beheren wie toegang heeft tot Kronos Workforce Dimensions.
  • Ervoor zorgen dat gebruikers automatisch met hun Microsoft Entra-account worden aangemeld bij Kronos Workforce Dimensions.
  • Beheer uw accounts op één centrale locatie.

Vereisten

U hebt het volgende nodig om aan de slag te gaan:

  • Een Microsoft Entra-abonnement. Als u geen abonnement hebt, kunt u een gratis account krijgen.
  • Een abonnement op Kronos Workforce Dimensions waarvoor eenmalige aanmelding is ingeschakeld.

Notitie

Deze integratie is ook beschikbaar voor gebruik vanuit de Microsoft Entra US Government Cloud-omgeving. U vindt deze toepassing in de Microsoft Entra US Government Cloud Application Gallery en configureert deze op dezelfde manier als vanuit de openbare cloud.

Beschrijving van scenario

In deze zelfstudie configureert en test u eenmalige aanmelding van Microsoft Entra in een testomgeving.

  • Kronos Workforce Dimensions ondersteunt door SP geïnitieerde eenmalige aanmelding.

Als u de integratie van Kronos Workforce Dimensions in Microsoft Entra ID wilt configureren, moet u Kronos Workforce Dimensions vanuit de galerie toevoegen aan uw lijst met beheerde SaaS-apps.

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassing Beheer istrator.
  2. Blader naar Bedrijfstoepassingen voor identiteitstoepassingen>>>Nieuwe toepassing.
  3. Typ Kronos Workforce Dimensions in het zoekvak in de sectie Toevoegen vanuit de galerie.
  4. Selecteer Kronos Workforce Dimensions in het resultatenvenster en voeg de app vervolgens toe. Wacht enkele seconden tot de app aan de tenant is toegevoegd.

U kunt ook de wizard Enterprise App Configuration gebruiken. In deze wizard kunt u een toepassing toevoegen aan uw tenant, gebruikers/groepen toevoegen aan de app, rollen toewijzen en ook de configuratie van eenmalige aanmelding doorlopen. Meer informatie over Microsoft 365-wizards.

Eenmalige aanmelding van Microsoft Entra voor Kronos Workforce Dimensions configureren en testen

Configureer en test eenmalige aanmelding van Microsoft Entra met Kronos Workforce Dimensions met behulp van een testgebruiker met de naam B.Simon. Eenmalige aanmelding werkt alleen als u een koppelingsrelatie tot stand brengt tussen een Microsoft Entra-gebruiker en de bijbehorende gebruiker in Kronos Workforce Dimensions.

Voer de volgende stappen uit om eenmalige aanmelding van Microsoft Entra met Kronos Workforce Dimensions te configureren en te testen:

  1. Configureer eenmalige aanmelding van Microsoft Entra - zodat uw gebruikers deze functie kunnen gebruiken.
    1. Een Microsoft Entra-testgebruiker maken : eenmalige aanmelding van Microsoft Entra testen met B.Simon.
    2. Wijs de Microsoft Entra-testgebruiker toe om B.Simon in staat te stellen eenmalige aanmelding van Microsoft Entra te gebruiken.
  2. Eenmalige aanmelding configureren in Kronos Workforce Dimensions : als u de instellingen voor eenmalige aanmelding aan de toepassingszijde wilt configureren.
    1. Testgebruiker voor Kronos Workforce Dimensions maken: als u een tegenhanger van B.Simon in Kronos Workforce Dimensions wilt hebben die is gekoppeld aan de Microsoft Entra-weergave van de gebruiker.
  3. Eenmalige aanmelding testen: om te controleren of de configuratie werkt.

Eenmalige aanmelding voor Microsoft Entra configureren

Volg deze stappen om eenmalige aanmelding van Microsoft Entra in te schakelen.

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassing Beheer istrator.

  2. Blader naar Identity>Applications>Enterprise-toepassingen>Kronos Workforce Dimensions>Eenmalige aanmelding.

  3. Selecteer SAML op de pagina Selecteer een methode voor eenmalige aanmelding.

  4. Op de pagina Eenmalige aanmelding instellen met SAML klikt u op het potloodpictogram voor Standaard-SAML-configuratie om de instellingen te bewerken.

    Schermopname van het bewerken van de standaard SAML-configuratie.

  5. In de sectie Standaard SAML-configuratie voert u de volgende stappen uit:

    a. In het tekstvak Id (Entiteits-id) typt u een URL met de volgende notatie: https://<SUBDOMAIN>.<ENVIRONMENT>.mykronos.com/authn/<TENANT_ID/hsp/<TENANT_NUMBER>

    b. In het tekstvak Aanmeldings-URL typt u een URL met een van de volgende patronen:

    Aanmeldings-URL
    https://<CUSTOMER>-<ENVIRONMENT>-sso.<ENVIRONMENT>.mykronos.com/
    https://<CUSTOMER>-sso.<ENVIRONMENT>.mykronos.com/

    Notitie

    Dit zijn geen echte waarden. Werk deze waarden bij met de werkelijke id en aanmeldings-URL. Neem contact op met het klantondersteuningsteam van Kronos Workforce Dimensions om deze waarden op te vragen. U kunt ook verwijzen naar de patronen die worden weergegeven in de sectie Standaard SAML-configuratie .

  6. Op de pagina Eenmalige aanmelding met SAML instellen in de sectie SAML-handtekeningcertificaat klikt u op de kopieerknop om de URL voor federatieve metagegevens van de app te kopiëren en slaat u deze op uw computer op.

    Schermopname van de koppeling Certificaat downloaden.

Een Microsoft Entra-testgebruiker maken

In deze sectie maakt u een testgebruiker met de naam B.Simon.

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een gebruiker Beheer istrator.
  2. Blader naar Identiteit>Gebruikers>Alle gebruikers.
  3. Selecteer Nieuwe gebruiker Nieuwe gebruiker> maken bovenaan het scherm.
  4. Voer in de gebruikerseigenschappen de volgende stappen uit:
    1. Voer in het veld Weergavenaam de tekst in B.Simon.
    2. Voer in het veld User Principal Name de username@companydomain.extensionnaam in. Bijvoorbeeld: B.Simon@contoso.com.
    3. Schakel het selectievakje Wachtwoord weergeven in en noteer de waarde die wordt weergegeven in het vak Wachtwoord.
    4. Selecteer Controleren + maken.
  5. Selecteer Maken.

De Microsoft Entra-testgebruiker toewijzen

In deze sectie geeft u B.Simon toestemming om eenmalige aanmelding te gebruiken door toegang te verlenen tot Kronos Workforce Dimensions.

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassing Beheer istrator.
  2. Blader naar Bedrijfstoepassingen voor Identiteitstoepassingen>>>Kronos Workforce Dimensions.
  3. Selecteer gebruikers en groepen op de overzichtspagina van de app.
  4. Selecteer Gebruiker/groep toevoegen en selecteer vervolgens Gebruikers en groepen in het dialoogvenster Toewijzing toevoegen.
    1. Selecteer in het dialoogvenster Gebruikers en groepen de optie B.Simon in de lijst Gebruikers. Klik vervolgens op de knop Selecteren onderaan het scherm.
    2. Als u verwacht dat er een rol aan de gebruikers moet worden toegewezen, kunt u de rol selecteren in de vervolgkeuzelijst Selecteer een rol. Als er geen rol is ingesteld voor deze app, wordt de rol Standaardtoegang geselecteerd.
    3. Klik in het dialoogvenster Toewijzing toevoegen op de knop Toewijzen.

Eenmalige aanmelding voor Kronos Workforce Dimensions configureren

Als u eenmalige aanmelding aan de zijde van Kronos Workforce Dimensions wilt configureren, moet u de APP-URL voor federatieve metagegevens naar het ondersteuningsteam van Kronos Workforce Dimensions verzenden. Het team stelt de instellingen zo in dat de verbinding tussen SAML en eenmalige aanmelding aan beide zijden goed is ingesteld.

Testgebruiker voor Kronos Workforce Dimensions maken

In deze sectie maakt u een gebruiker met de naam Britta Simon in Kronos Workforce Dimensions. Werk samen met het ondersteuningsteam van Kronos Workforce Dimensions om de gebruikers toe te voegen aan het Kronos Workforce Dimensions-platform. Er moeten gebruikers worden gemaakt en geactiveerd voordat u eenmalige aanmelding kunt gebruiken.

Notitie

De oorspronkelijke Microsoft-documentatie adviseert contact op te maken met UKG Support via e-mail om uw Microsoft Entra-gebruikers te maken. Hoewel deze optie beschikbaar is, kunt u de volgende selfserviceopties overwegen.

Handmatig proces

Er zijn twee manieren om uw Microsoft Entra-gebruikers handmatig te maken in WFD. U kunt een bestaande gebruiker selecteren, deze dupliceren en vervolgens de benodigde velden bijwerken om die gebruiker uniek te maken. Dit proces kan tijdrovend zijn en vereist kennis van de WFD-gebruikersinterface. Het alternatief is om de gebruiker te maken via de WFD-API, wat veel sneller is. Voor deze optie is kennis vereist van het gebruik van API-hulpprogramma's zoals Postman om de aanvraag naar de API te verzenden. De volgende instructies helpen bij het importeren van een vooraf samengesteld voorbeeld in het Postman-API-hulpprogramma.

Instellingen

  1. Open het hulpprogramma Postman en importeer de volgende bestanden:

    a. Personeelsdimensies - User.postman_collection.json maken

    b. Microsoft Entra-id voor WFD Env-Variables.json

  2. Selecteer in het linkerdeelvenster de knop Omgevingen .

  3. Klik op AAD_to_WFD_Env_Variables en voeg de waarden van UKG Support toe die betrekking hebben op uw WFD-exemplaar.

    Notitie

    access_token en refresh_token leeg moeten zijn, omdat deze automatisch worden ingevuld als gevolg van de HTTP-aanvraag toegangstoken verkrijgen.

  4. Open de gebruiker Microsoft Entra maken in WFD HTTP-aanvraag en werk gemarkeerde eigenschappen bij binnen de JSON-nettolading:

    { 

"personInformation": { 

   "accessAssignment": { 

      "accessProfileName": "accessProfileName", 

      "notificationProfileName": "All" 

    }, 

    "emailAddresses": [ 

      { 

        "address": "address” 

        "contactTypeName": "Work" 

      } 

    ], 

    "employmentStatusList": [ 

      { 

        "effectiveDate": "2019-08-15", 

        "employmentStatusName": "Active", 

        "expirationDate": "3000-01-01" 

      } 

    ], 

    "person": { 

      "personNumber": "personNumber", 

      "firstName": "firstName", 

      "lastName": "lastName", 

      "fullName": "fullName", 

      "hireDate": "2019-08-15", 

      "shortName": "shortName" 

    }, 

    "personAuthenticationTypes": [ 

      { 

        "activeFlag": true, 

        "authenticationTypeName": "Federated" 

      } 

    ], 

    "personLicenseTypes": [ 

      { 

        "activeFlag": true, 

        "licenseTypeName": "Employee" 

      }, 

      { 

        "activeFlag": true, 

        "licenseTypeName": "Absence" 

      }, 

      { 

        "activeFlag": true, 

        "licenseTypeName": "Hourly Timekeeping" 

      }, 

      { 

        "activeFlag": true, 

        "licenseTypeName": "Scheduling" 

      } 

    ], 

    "userAccountStatusList": [ 

      { 

        "effectiveDate": "2019-08-15", 

        "expirationDate": "3000-01-01", 

        "userAccountStatusName": "Active" 

      } 

    ] 

  }, 

  "jobAssignment": { 

    "baseWageRates": [ 

      { 

        "effectiveDate": "2019-01-01", 

        "expirationDate": "3000-01-01", 

        "hourlyRate": 20.15 

      } 

    ], 

    "jobAssignmentDetails": { 

      "payRuleName": "payRuleName", 

      "timeZoneName": "timeZoneName" 

    }, 

    "primaryLaborAccounts": [ 

      { 

        "effectiveDate": "2019-08-15", 

        "expirationDate": "3000-01-01", 

        "organizationPath": "organizationPath" 

      } 

    ] 

  }, 

  "user": { 

    "userAccount": { 

      "logonProfileName": "Default", 

      "userName": "userName" 

    } 

  } 

}

    Notitie

    De personInformation.emailAddress.address en de user.userAccount.userName moeten beide overeenkomen met de beoogde Microsoft Entra-gebruiker die u probeert te maken in WFD.

  5. Selecteer in de rechterbovenhoek de vervolgkeuzelijst Omgevingen en selecteer AAD_to_WFD_Env_Variables.

  6. Zodra de JSON-nettolading is bijgewerkt en de juiste omgevingsvariabelen zijn geselecteerd, selecteert u de HTTP-aanvraag toegangstoken verkrijgen en klikt u op de knop Verzenden . Dit maakt gebruik van de bijgewerkte omgevingsvariabelen om te verifiëren bij uw WFD-exemplaar en slaat vervolgens uw toegangstoken in de omgevingsvariabelen in de omgevingsvariabelen op die moeten worden gebruikt bij het aanroepen van de gebruikersmethode.

  7. Als de verificatieaanroep is geslaagd, ziet u een 200-antwoord met een toegangstoken dat is geretourneerd. Dit toegangstoken wordt nu ook weergegeven in de kolom CURRENT VALUE in de omgevingsvariabelen voor de vermelding access_token .

    Notitie

    Als er geen access_token wordt ontvangen, controleert u of alle variabelen in de omgevingsvariabelen juist zijn. Gebruikersreferenties moeten een supergebruikersaccount zijn.

  8. Zodra een access_token is verkregen, selecteert u de AAD_to_WFD_Env_Variables HTTP-aanvraag en klikt u op de knop Verzenden . Als de aanvraag is geslaagd, ontvangt u een HTTP-status van 200.

  9. Meld u aan bij WFD met het supergebruikersaccount en controleer of de nieuwe Microsoft Entra-gebruiker is gemaakt in het WFD-exemplaar.

Geautomatiseerd proces

Het geautomatiseerde proces bestaat uit een plat bestand in CSV-indeling waarmee de gebruiker de gemarkeerde waarden in de nettolading vooraf kan bekijken uit het bovenstaande handmatige API-proces. Het platte bestand wordt gebruikt door het bijbehorende PowerShell-script waarmee de nieuwe WFD-gebruikers bulksgewijs worden gemaakt. Het script verwerkt nieuwe gebruikerscreaties in batches van 70 (standaard) die kan worden geconfigureerd voor optimale prestaties. De volgende instructies doorlopen de installatie en uitvoering van het script.

  1. Sla de bestanden AAD_To_WFD.csv en AAD_To_WFD.ps1 lokaal op uw computer op.

  2. Open het AAD_To_WFD.csv bestand en vul de kolommen in.

    • personInformation.accessAssignment.accessProfileName: Specifieke naam van het toegangsprofiel van het WFD-exemplaar.

    • personInformation.emailAddresses.address: moet overeenkomen met de user principle name in Microsoft Entra ID.

    • personInformation.personNumber: Moet uniek zijn in het WFD-exemplaar.

    • personInformation.firstName: voornaam van gebruiker.

    • personInformation.lastName: achternaam van gebruiker.

    • jobAssignment.jobAssignmentDetails.payRuleName: Specifieke pay-regelnaam van WFD.

    • jobAssignment.jobAssignmentDetails.timeZoneName: Tijdzone-indeling moet overeenkomen met het WFD-exemplaar (dat wil (GMT -08:00) Pacific Timegezegd).

    • jobAssignment.primaryLaborAccounts.organizationPath: Organisatiepad van een specifieke bedrijfsstructuur in het WFD-exemplaar.

  3. Sla het bestand .csv op.

  4. Klik met de rechtermuisknop op het script AAD_To_WFD.ps1 en klik op Bewerken om het te wijzigen.

  5. Controleer of het pad dat is opgegeven in regel 15, de juiste naam/het juiste pad naar het AAD_To_WFD.csv-bestand is.

  6. Werk de volgende regels bij met de waarden van UKG Support die betrekking hebben op uw WFD-exemplaar.

    • Regel 33: vanityUrl

    • Regel 43: appKey

    • Regel 48: client_id

    • Regel 49: client_secret

  7. Sla het script op en voer het uit.

  8. Geef de referenties van WFD Super User op wanneer u hierom wordt gevraagd.

  9. Zodra het script is voltooid, wordt een lijst geretourneerd met alle gebruikers die niet konden worden gemaakt.

Notitie

Controleer de waarden die zijn opgegeven in het AAD_To_WFD.csv bestand als het resultaat van typefouten of niet-overeenkomende velden in het WFD-exemplaar wordt geretourneerd. De fout kan ook worden geretourneerd door het WFD API-exemplaar als alle gebruikers in de batch al aanwezig zijn in het exemplaar.

Eenmalige aanmelding testen

In deze sectie test u de configuratie voor eenmalige aanmelding van Microsoft Entra met de volgende opties.

  • Klik op Deze toepassing testen. U wordt omgeleid naar de aanmeldings-URL van Kronos Workforce Dimensions, waar u de aanmeldingsstroom kunt initiëren.

  • Ga naar de aanmeldings-URL van Kronos Workforce Dimensions en initieer daar de aanmeldingsstroom.

  • U kunt Microsoft Mijn apps gebruiken. Wanneer u in Mijn apps op de tegel Kronos Workforce Dimensions klikt, wordt u omgeleid naar de aanmeldings-URL van Kronos Workforce Dimensions. Zie Introduction to My Apps (Inleiding tot Mijn apps) voor meer informatie over Mijn apps.

Volgende stappen

Zodra u Kronos Workforce Dimensions hebt geconfigureerd, kunt u sessiebeheer afdwingen, waardoor exfiltratie en infiltratie van gevoelige gegevens van uw organisatie in realtime worden beschermd. Sessiebeheer is een uitbreiding van voorwaardelijke toegang. Meer informatie over het afdwingen van sessiebeheer met Microsoft Defender voor Cloud Apps.