Esercitazione: Integrazione dell'accesso Single Sign-On di Microsoft Entra con Kronos Workforce Dimensions

  • Articolo

In questa esercitazione si apprenderà come integrare Kronos Workforce Dimensions con Microsoft Entra ID. Integrando Kronos Workforce Dimensions con Microsoft Entra ID, è possibile:

  • Controllare in Microsoft Entra ID chi può accedere alle dimensioni Kronos Workforce.
  • Abilitare gli utenti per l'accesso automatico a Kronos Workforce Dimensions con gli account Microsoft Entra personali.
  • Gestire gli account in un'unica posizione centrale.

Prerequisiti

Per iniziare, sono necessari gli elementi seguenti:

  • Una sottoscrizione di Microsoft Entra. Se non si possiede una sottoscrizione, è possibile ottenere un account gratuito.
  • Sottoscrizione di Kronos Workforce Dimensions abilitata per l'accesso Single Sign-On (SSO).

Nota

Questa integrazione è disponibile anche per l'uso dall'ambiente cloud US Government di Microsoft Entra. È possibile trovare questa applicazione nella raccolta di applicazioni cloud US Government di Microsoft Entra e configurarla con la stessa procedura usata dal cloud pubblico.

Descrizione dello scenario

In questa esercitazione viene configurato e testato l'accesso SSO di Microsoft Entra in un ambiente di test.

  • Kronos Workforce Dimensions supporta l'accesso SSO avviato da SP .

Per configurare l'integrazione di Kronos Workforce Dimensions in Microsoft Entra ID, è necessario aggiungere Kronos Workforce Dimensions dalla raccolta all'elenco di app SaaS gestite.

  1. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.
  2. Passare a Identità>Applicazioni>Applicazioni aziendali>Nuova applicazione.
  3. Nella sezione Aggiungi dalla raccolta digitare Kronos Workforce Dimensions nella casella di ricerca.
  4. Selezionare Kronos Workforce Dimensions nel pannello dei risultati e quindi aggiungere l'app. Attendere alcuni secondi che l'app venga aggiunta al tenant.

In alternativa, è anche possibile usare Configurazione guidata app aziendali. In questa procedura guidata è possibile aggiungere un'applicazione al tenant, aggiungere utenti/gruppi all'app, assegnare ruoli, nonché esaminare la configurazione dell'accesso SSO. Altre informazioni sulle procedure guidate di Microsoft 365.

Configurare e testare l'accesso Single Sign-On di Microsoft Entra per Kronos Workforce Dimensions

Configurare e testare l'accesso SSO di Microsoft Entra con Kronos Workforce Dimensions usando un utente di test di nome B.Simon. Per consentire il funzionamento dell'accesso Single Sign-On, è necessario stabilire una relazione di collegamento tra un utente di Microsoft Entra e l'utente correlato in Kronos Workforce Dimensions.

Per configurare e testare l'accesso SSO di Microsoft Entra con Kronos Workforce Dimensions, seguire questa procedura:

  1. Configurare l'accesso Single Sign-On di Microsoft Entra per consentire agli utenti di usare questa funzionalità.
    1. Creare un utente di test di Microsoft Entra per testare l'accesso Single Sign-On di Microsoft Entra con B.Simon.
    2. Assegnare l'utente di test di Microsoft Entra per abilitare B.Simon all'uso dell'accesso Single Sign-On di Microsoft Entra.
  2. Configurare l'accesso Single Sign-On di Kronos Workforce Dimensions: per configurare le impostazioni di Single Sign-On sul lato applicazione.
    1. Creare l'utente di test di Kronos Workforce Dimensions: per avere una controparte di B.Simon in Kronos Workforce Dimensions collegata alla rappresentazione dell'utente in Microsoft Entra.
  3. Testare l'accesso Single Sign-On: per verificare se la configurazione funziona.

Configurare l'accesso Single Sign-On di Microsoft Entra

Seguire questa procedura per abilitare l'accesso Single Sign-On di Microsoft Entra.

  1. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.

  2. Passare a Applicazioni di identità>Applicazioni>aziendali>Kronos Workforce Dimensions>Single Sign-On.

  3. Nella pagina Selezionare un metodo di accesso Single Sign-On selezionare SAML.

  4. Nella pagina Configura l'accesso Single Sign-On con SAML fare clic sull'icona della matita per modificare le impostazioni di Configurazione SAML di base.

    Screenshot che mostra come modificare la configurazione SAML di base.

  5. Nella sezione Configurazione SAML di base seguire questa procedura:

    a. Nella casella di testo Identificatore (ID entità) digitare un URL nel formato seguente: https://<SUBDOMAIN>.<ENVIRONMENT>.mykronos.com/authn/<TENANT_ID/hsp/<TENANT_NUMBER>

    b. Nella casella di testo URL di accesso digitare un URL usando uno dei modelli seguenti:

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

    Nota

    Poiché questi non sono i valori reali, Aggiornare questi valori con l'identificatore effettivo e l'URL di accesso. Per ottenere questi valori, contattare il team di supporto clienti di Kronos Workforce Dimensions. È anche possibile fare riferimento ai modelli illustrati nella sezione Configurazione SAML di base.

  6. Nella sezione Certificato di firma SAML della pagina Configura l'accesso Single Sign-On con SAML fare clic sul pulsante Copia per copiare l'URL dei metadati di federazione dell'app e salvarlo nel computer.

    Screenshot che mostra il collegamento Download certificato.

Creare un utente di test di Microsoft Entra

In questa sezione verrà creato un utente di test di nome B.Simon.

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra almeno come Amministratore utenti.
  2. Passare a Identità>Utenti>Tutti gli utenti.
  3. Selezionare Nuovo utente Crea nuovo utente> nella parte superiore della schermata.
  4. Nelle proprietà Utente seguire questa procedura:
    1. Nel campo Nome visualizzato immettere B.Simon.
    2. Nel campo Nome entità utente immettere .username@companydomain.extension Ad esempio: B.Simon@contoso.com.
    3. Selezionare la casella di controllo Mostra password e quindi prendere nota del valore visualizzato nella casella Password.
    4. Selezionare Rivedi e crea.
  5. Seleziona Crea.

Assegnare l'utente di test di Microsoft Entra

In questa sezione si abiliterà B.Simon all'uso dell'accesso Single Sign-On concedendole l'accesso a Kronos Workforce Dimensions.

  1. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.
  2. Passare a Applicazioni di identità>Applicazioni>aziendali>Dimensioni Kronos Workforce.
  3. Nella pagina di panoramica dell'app selezionare Utenti e gruppi.
  4. Selezionare Aggiungi utente/gruppo, quindi utenti e gruppi nella finestra di dialogo Aggiungi assegnazione .
    1. Nella finestra di dialogo Utenti e gruppi selezionare B.Simon dall'elenco degli utenti e quindi fare clic sul pulsante Seleziona nella parte inferiore della schermata.
    2. Se si prevede che agli utenti venga assegnato un ruolo, è possibile selezionarlo nell'elenco a discesa Selezionare un ruolo. Se per questa app non è stato configurato alcun ruolo, il ruolo selezionato è "Accesso predefinito".
    3. Nella finestra di dialogo Aggiungi assegnazione fare clic sul pulsante Assegna.

Configurare l'accesso Single Sign-On di Kronos Workforce Dimensions

Per configurare l'accesso Single Sign-On sul lato Kronos Workforce Dimensions, è necessario inviare l'URL dei metadati di federazione dell'app al team di supporto di Kronos Workforce Dimensions. La configurazione viene eseguita in modo che la connessione SSO SAML sia impostata correttamente su entrambi i lati.

Creare l'utente di test di Kronos Workforce Dimensions

In questa sezione viene creato un utente di nome Britta Simon in Kronos Workforce Dimensions. Collaborare con il team di supporto di Kronos Workforce Dimensions per aggiungere gli utenti alla piattaforma Kronos Workforce Dimensions. Gli utenti devono essere creati e attivati prima di usare l'accesso Single Sign-On.

Nota

La documentazione originale di Microsoft consiglia di contattare il supporto ukg tramite posta elettronica per creare gli utenti di Microsoft Entra. Anche se questa opzione è disponibile, prendere in considerazione le opzioni self-service seguenti.

Processo manuale

Esistono due modi per creare manualmente gli utenti di Microsoft Entra in WFD. È possibile selezionare un utente esistente, duplicarli e quindi aggiornare i campi necessari per rendere univoco l'utente. Questo processo può richiedere molto tempo e richiede la conoscenza dell'interfaccia utente di WFD. L'alternativa consiste nel creare l'utente tramite l'API WFD, molto più veloce. Questa opzione richiede la conoscenza dell'uso di Strumenti API, ad esempio Postman, per inviare la richiesta all'API. Le istruzioni seguenti consentono di importare un esempio predefinito nello strumento API Postman.

Attrezzaggio

  1. Aprire lo strumento Postman e importare i file seguenti:

    a. Dimensioni della forza lavoro - Creare User.postman_collection.json

    b. Microsoft Entra ID to WFD Env Variables.json

  2. Nel riquadro sinistro selezionare il pulsante Ambienti .

  3. Fare clic su AAD_to_WFD_Env_Variables e aggiungere i valori forniti dal supporto UKG relativo all'istanza di WFD.

    Nota

    access_token e refresh_token devono essere vuoti perché questi verranno popolati automaticamente in seguito alla richiesta HTTP per ottenere il token di accesso.

  4. Aprire l'opzione Create Microsoft Entra user in WFD HTTP Request (Crea utente Di Microsoft Entra in WFD HTTP Request) e aggiornare le proprietà evidenziate all'interno del payload JSON:

    { 

"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" 

    } 

  } 

}

    Nota

    PersonInformation.emailAddress.address e user.userAccount.userName devono corrispondere entrambi all'utente di Microsoft Entra di destinazione che si sta tentando di creare in WFD.

  5. Nell'angolo in alto a destra selezionare la casella di riepilogo a discesa Ambienti e selezionare AAD_to_WFD_Env_Variables.

  6. Dopo aver aggiornato il payload JSON e aver selezionato le variabili di ambiente corrette, selezionare la richiesta HTTP per ottenere il token di accesso e fare clic sul pulsante Invia . In questo modo si useranno le variabili di ambiente aggiornate per eseguire l'autenticazione all'istanza di WFD e quindi memorizzare nella cache il token di accesso nelle variabili di ambiente da usare quando si chiama il metodo utente di creazione.

  7. Se la chiamata di autenticazione ha avuto esito positivo, verrà visualizzata una risposta 200 con un token di accesso restituito. Questo token di accesso verrà ora visualizzato anche nella colonna CURRENT VALUE nelle variabili di ambiente per la voce access_token .

    Nota

    Se non viene ricevuto un access_token, verificare che tutte le variabili nelle variabili di ambiente siano corrette. Le credenziali utente devono essere un account utente con privilegi avanzati.

  8. Dopo aver ottenuto un access_token , selezionare il AAD_to_WFD_Env_Variables richiesta HTTP e fare clic sul pulsante Invia . Se la richiesta ha esito positivo, si riceverà uno stato HTTP 200.

  9. Accedere a WFD con l'account utente con privilegi avanzati e verificare che il nuovo utente di Microsoft Entra sia stato creato all'interno dell'istanza di WFD.

Processo automatizzato

Il processo automatizzato è costituito da un file flat in formato CSV che consente all'utente di prespecificare i valori evidenziati nel payload dal processo API manuale precedente. Il file flat viene utilizzato dallo script di PowerShell adiacente che crea i nuovi utenti WFD in blocco. Lo script elabora le nuove creazioni utente in batch di 70 (impostazione predefinita) configurabili per prestazioni ottimali. Le istruzioni seguenti illustrano la configurazione e l'esecuzione dello script.

  1. Salvare i file AAD_To_WFD.csv e AAD_To_WFD.ps1 in locale nel computer.

  2. Aprire il file AAD_To_WFD.csv e compilare le colonne.

    • personInformation.accessAssignment.accessProfileName: nome del profilo di accesso specifico dall'istanza di WFD.

    • personInformation.emailAddresses.address: deve corrispondere al nome dell'entità utente in Microsoft Entra ID.

    • personInformation.personNumber: deve essere univoco nell'istanza di WFD.

    • personInformation.firstName: nome dell'utente.

    • personInformation.lastName: cognome dell'utente.

    • jobAssignment.jobAssignmentDetails.payRuleName: nome della regola di pagamento specifico di WFD.

    • jobAssignment.jobAssignmentDetails.timeZoneName: il formato del fuso orario deve corrispondere all'istanza di WFD, ovvero (GMT -08:00) Pacific Time.

    • jobAssignment.primaryLaborAccounts.organizationPath: Percorso organizzazione di una struttura business specifica nell'istanza di WFD.

  3. Salvare il file .csv.

  4. Fare clic con il pulsante destro del mouse sullo script AAD_To_WFD.ps1 e scegliere Modifica per modificarlo.

  5. Verificare che il percorso specificato nella riga 15 sia il nome/percorso corretto del file AAD_To_WFD.csv .

  6. Aggiornare le righe seguenti con i valori forniti dal supporto UKG relativo all'istanza di WFD.

    • Riga 33: vanityUrl

    • Riga 43: appKey

    • Riga 48: client_id

    • Riga 49: client_secret

  7. Salvare ed eseguire lo script.

  8. Specificare le credenziali utente con privilegi avanzati di WFD quando richiesto.

  9. Al termine, lo script restituirà un elenco di tutti gli utenti che non sono riusciti a creare.

Nota

Assicurarsi di controllare i valori specificati nel file AAD_To_WFD.csv se viene restituito come risultato di errori di digitazioni o campi non corrispondenti nell'istanza di WFD. L'errore può essere restituito anche dall'istanza dell'API WFD se tutti gli utenti del batch esistono già nell'istanza.

Testare l'accesso SSO

In questa sezione viene testata la configurazione dell'accesso Single Sign-On di Microsoft Entra con le opzioni seguenti.

  • Fare clic su Test this application (Testa questa applicazione), verrà eseguito il reindirizzamento all'URL di accesso Kronos Workforce Dimensions (Dimensioni della forza lavoro Kronos), in cui è possibile avviare il flusso di accesso.

  • Passare direttamente all'URL di accesso di Kronos Workforce Dimensions e avviare il flusso di accesso da questa posizione.

  • È possibile usare App personali Microsoft. Quando si fa clic sul riquadro Kronos Workforce Dimensions nel App personali, verrà eseguito il reindirizzamento all'URL di accesso Kronos Workforce Dimensions. Per altre informazioni su App personali, vedere l'introduzione ad App personali.

Passaggi successivi

Dopo aver configurato Kronos Workforce Dimensions, è possibile applicare il controllo sessione che consente di proteggere in tempo reale l'esfiltrazione e l'infiltrazione dei dati sensibili dell'organizzazione. Il controllo sessione costituisce un'estensione dell'accesso condizionale. Informazioni su come applicare il controllo sessione con app Microsoft Defender per il cloud.