Configurare Genesys Cloud per Azure per l'accesso Single Sign-On con Microsoft Entra ID

2025-05-20

Questo articolo illustra come integrare Genesys Cloud for Azure con Microsoft Entra ID. Integrando Genesys Cloud for Azure con Microsoft Entra ID, è possibile:

Controllare in Microsoft Entra ID chi può accedere a Genesys Cloud for Azure.
Consentire l'accesso automatico agli utenti a Genesys Cloud for Azure con i loro account Microsoft Entra.
Gestire gli account in un'unica posizione centrale.

Prerequisiti

Lo scenario descritto in questo articolo presuppone che siano già disponibili i prerequisiti seguenti:

Un account utente di Microsoft Entra con una sottoscrizione attiva. Se non ne hai già uno, puoi Creare un account gratuitamente.
Uno dei ruoli seguenti:

Sottoscrizione di Genesys Cloud for Azure abilitata all'accesso Single Sign-On (SSO).

Descrizione dello scenario

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

Genesys Cloud for Azure supporta l'SSO avviato da SP e IDP.
Genesys Cloud per Azure offre il supporto per il provisioning automatizzato degli utenti .

Nota

L'identificatore di questa applicazione è un valore stringa fisso, quindi è possibile configurare una sola istanza in un tenant.

Aggiungi Genesys Cloud for Azure dalla raccolta

Per configurare l'integrazione di Genesys Cloud for Azure in Microsoft Entra ID, è necessario aggiungere Genesys Cloud for Azure dalla raccolta all'elenco di app SaaS gestite. A tale scopo, seguire questa procedura:

Accedi all'interfaccia di amministrazione di Microsoft Entra come almeno un Amministratore di applicazioni cloud .
Naviga su Entra ID>Applicazioni aziendali>Nuova applicazione.
Nella sezione Aggiungi dalla raccolta, inserisci Genesys Cloud for Azure nella casella di ricerca.
Selezionare Genesys Cloud for Azure nel pannello dei risultati e quindi aggiungere l'app. Attendere alcuni secondi mentre l'app viene aggiunta nel tenant.

In alternativa, è anche possibile usare procedura guidata di configurazione delle app aziendali. In questa procedura guidata è possibile aggiungere un'applicazione al tenant, aggiungere utenti/gruppi all'app, assegnare i ruoli e procedere alla configurazione dell'accesso SSO. Scopri di più sulle procedure guidate di Microsoft 365.

Configurare e testare l'accesso Single Sign-On di Microsoft Entra for Genesys Cloud for Azure

Configurare e testare l'accesso SSO di Microsoft Entra con Genesys Cloud for Azure utilizzando un utente di test chiamato 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 Genesys Cloud for Azure.

Per configurare e testare l'accesso SSO di Microsoft Entra con Genesys Cloud for Azure, seguire questa procedura:

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 consentire a B.Simon di utilizzare il Single Sign-On di Microsoft Entra.
Configure Genesys Cloud for Azure SSO per configurare le impostazioni di Single Sign-On sul lato applicazione.
1. Creare un utente di test Genesys Cloud per Azure, in modo da avere una controparte di B.Simon in Genesys Cloud for Azure collegata alla rappresentazione di Microsoft Entra dell'utente.
Test SSO per verificare se la configurazione è funzionante.

Configura il Single Sign-On di Microsoft Entra

Per abilitare l'accesso SSO di Microsoft Entra nel portale di Azure, seguire questa procedura:

Accedi all'interfaccia di amministrazione di Microsoft Entra come almeno un Amministratore di applicazioni cloud .
Passare alla pagina di integrazione dell'applicazione Entra ID>Enterprise>Genesys Cloud for Azure , individuare la sezione Gestione e selezionare Single Sign-On.
Nella pagina Selezionare un metodo Sign-On singolo selezionare SAML.
Nella pagina Configura single Sign-On con SAML, selezionare l'icona a forma di matita per la Configurazione SAML di base per modificare le impostazioni.

Nella sezione Configurazione SAML di base, se si vuole configurare l'applicazione in modalità avviata dall'IDP, seguire questa procedura:

un. Nella casella Identificatore, immettere gli URL che corrispondono alla tua regione.

URL identificatore
https://login.mypurecloud.com/saml
https://login.mypurecloud.de/saml
https://login.mypurecloud.jp/saml
https://login.mypurecloud.ie/saml
https://login.mypurecloud.com.au/saml

b. Nella casella URL di risposta immettere gli URL corrispondenti all'area geografica:

URL di risposta
https://login.mypurecloud.com/saml
https://login.mypurecloud.de/saml
https://login.mypurecloud.jp/saml
https://login.mypurecloud.ie/saml
https://login.mypurecloud.com.au/saml

Selezionare Impostare URL aggiuntivi e seguire questa procedura se si vuole configurare l'applicazione in SP modalità avviata:

Nella casella URL di accesso immettere gli URL corrispondenti all'area:

URL di accesso

https://login.mypurecloud.com

https://login.mypurecloud.de

https://login.mypurecloud.jp

https://login.mypurecloud.ie

https://login.mypurecloud.com.au
Genesys Cloud per l'applicazione Azure prevede un formato specifico per le asserzioni SAML. È quindi necessario aggiungere mapping di attributi personalizzati alla configurazione degli attributi del token SAML. Lo screenshot seguente mostra l'elenco degli attributi predefiniti:
Inoltre, Genesys Cloud per l'applicazione Azure prevede il passaggio di altri attributi nella risposta SAML, come illustrato nella tabella seguente. Questi attributi sono precompilati, ma è possibile esaminarli se necessario.

Nome Attributo di origine

E-mail user.nomeprincipaleutente

Nome organizzazione Your organization name
Nella pagina Configura Single Sign-On con SAML, nella sezione Certificato di firma SAML, trovare il Certificato (Base64) e selezionare Download per scaricare il certificato e salvarlo nel computer.
Nella sezione Configurare Genesys Cloud for Azure copiare l'URL (o gli URL appropriati) in base alle esigenze.

URL di accesso
https://login.mypurecloud.com
https://login.mypurecloud.de
https://login.mypurecloud.jp
https://login.mypurecloud.ie
https://login.mypurecloud.com.au

Nome	Attributo di origine
E-mail	user.nomeprincipaleutente
Nome organizzazione	`Your organization name`

Creare e assegnare l'utente di test di Microsoft Entra

Segui le linee guida nel quickstart per creare e assegnare un account utente per creare un account di test chiamato B.Simon.

Configurare Genesys Cloud per Azure SSO

In un'altra finestra del Web browser accedere a Genesys Cloud for Azure come amministratore.
Selezionare Admin nella parte superiore e quindi passare a Single Sign-On in Integrations.
Passare alla scheda ADFS/Azure AD(Premium) e quindi seguire questa procedura:

un. Selezionare Sfoglia per caricare il certificato con codifica base 64 scaricato nel certificato ADFS.

b. Nella casella URI emettitore ADFS, incollare il valore di identificatore Microsoft Entra che hai copiato.

c. Nella casella Target URI, incolla il valore dell'URL di accesso che hai copiato.

d. Per il valore Identificatore relying party, passare al portale di Azure e quindi, nella pagina di integrazione dell'applicazione Genesys Cloud for Azure, selezionare la scheda Proprietà e copiare il valore ID applicazione. Incolla nella casella Identificatore Relying Party.

e. Selezionare Salva.

Creare l'utente di test di Genesys Cloud for Azure

Per consentire agli utenti di Microsoft Entra di accedere a Genesys Cloud for Azure, è necessario configurare gli utenti in Genesys Cloud for Azure. In Genesys Cloud for Azure il provisioning è un'attività manuale.

Per effettuare il provisioning di un account utente, seguire questa procedura:

Accedere a Genesys Cloud per Azure come amministratore.
Selezionare Admin in alto e passare a People sotto People & Permissions.
Nella pagina Persone selezionare Aggiungi persona.
Nella finestra di dialogo Aggiungi persone all'organizzazione seguire questa procedura:

un. Nella casella nome completo immettere il nome di un utente. Ad esempio: B.simon.

b. Nella casella email, immettere l'email dell'utente. Ad esempio: b.simon@contoso.com.

c. Selezionare Crea.

Nota

Genesys Cloud for Azure supporta anche il provisioning utenti automatico, trovi maggiori dettagli qui su come configurare il provisioning utenti automatico.

Testare la funzionalità SSO

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

Avviato da SP:

Selezionare Testare questa applicazione, questa opzione reindirizza all'URL di accesso Genesys Cloud for Azure in cui è possibile avviare il flusso di accesso.
Passare direttamente all'URL di accesso di Genesys Cloud for Azure e avviare il flusso di accesso da questa posizione.

IDP avviato:

Seleziona Prova questa applicazionee sarai automaticamente connesso all'istanza di Genesys Cloud for Azure per la quale hai configurato l'accesso SSO.

È anche possibile usare Microsoft My Apps per testare l'applicazione in qualsiasi modalità. Quando si seleziona il riquadro Genesys Cloud for Azure in Le mie app, se configurato in modalità SP, si verrà reindirizzati alla pagina di accesso dell'applicazione per avviare il flusso di accesso e, se configurato in modalità IDP, si verrà automaticamente connessi all'istanza di Genesys Cloud for Azure per cui è stato configurato l'SSO. Per altre informazioni sulle app personali, vedere Introduzione alle app personali.

Dopo aver configurato Genesys Cloud per Azure, è 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 si estende dall'accesso condizionale. Informazioni su come applicare il controllo sessione con Microsoft Defender for Cloud Apps.