Esercitazione: Integrazione dell'accesso Single Sign-On di Microsoft Entra con Pega Systems

In questa esercitazione si apprenderà come integrare Pega Systems con Microsoft Entra ID. Integrando Pega Systems con Microsoft Entra ID, è possibile:

  • Controllare in Microsoft Entra ID chi può accedere a Pega Systems.
  • Abilitare gli utenti per l'accesso automatico a Pega Systems 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 Pega Systems abilitata per l'accesso Single Sign-On (SSO).

Descrizione dello scenario

In questa esercitazione verrà configurato e testato l'accesso Single Sign-On di Microsoft Entra in un ambiente di test.

  • Pegasystems supporta l'accesso SSO avviato da SP e IdP.

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

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra come almeno un'applicazione cloud Amministrazione istrator.
  2. Passare a Applicazioni di identità>Applicazioni>aziendali>Nuova applicazione.
  3. Nella sezione Aggiungi dalla raccolta digitare Pega Systems nella casella di ricerca.
  4. Selezionare Pega Systems nel pannello dei risultati e quindi aggiungere l'app. Attendere alcuni secondi che l'app venga aggiunta al tenant.

In alternativa, è anche possibile usare l'Enterprise Configurazione app Wizard. 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 Pega Systems

Configurare e testare l'accesso SSO di Microsoft Entra con Pega Systems 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 Pega Systems.

Per configurare e testare l'accesso SSO di Microsoft Entra con Pega Systems, 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 Pega Systems: per configurare le impostazioni di Single Sign-On sul lato applicazione.
    1. Creare l'utente di test di Pega Systems: per avere una controparte di B.Simon in Pega Systems 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 come almeno un'applicazione cloud Amministrazione istrator.

  2. Passare a Applicazioni di identità>Applicazioni>aziendali>Pega Systems>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.

    Edit Basic SAML Configuration

  5. Nella finestra di dialogo Configurazione SAML di base, se si vuole configurare l'applicazione in modalità avviata da IdP, seguire questa procedura.

    1. Nella casella di testo Identificatore digitare un URL nel formato seguente:

      https://<customername>.pegacloud.io:443/prweb/sp/<instanceID>

    2. Nella casella URL di risposta digitare un URL usando il modello seguente:

      https://<customername>.pegacloud.io:443/prweb/PRRestService/WebSSO/SAML/AssertionConsumerService

  6. Se si desidera configurare l'applicazione in modalità avviata da SP, selezionare Imposta URL aggiuntivi e completare la seguente procedura.

    1. Nella casella URL di accesso immettere il valore dell'URL di accesso.

    2. Nella casella Stato dell'inoltro immettere un URL nel formato seguente: https://<customername>.pegacloud.io/prweb/sso

    Nota

    I valori qui forniti sono segnaposto. È necessario usare l'identificatore effettivo, l'URL di risposta, l'URL di accesso e l'URL dello stato dell'inoltro. È possibile ottenere i valori dell'identificatore e dell'URL di risposta in un'applicazione Pega illustrata più avanti in questa esercitazione. Per ottenere il valore dello stato dell'inoltro, contattare il team di supporto di Pegasystems. È anche possibile fare riferimento ai modelli illustrati nella sezione Configurazione SAML di base.

  7. L'applicazione Pegasystems ha bisogno di un formato specifico per le asserzioni SAML. Per visualizzarle nel formato corretto, è necessario aggiungere mapping di attributi personalizzati alla configurazione degli attributi dei token SAML. Lo screenshot seguente mostra gli attributi predefiniti. Selezionare l'icona Modifica per aprire la finestra di dialogo Attributi utente:

    User Attributes

  8. Oltre agli attributi illustrati nello screenshot precedente, l'applicazione Pegasystems richiede il passaggio di alcuni altri attributi nella risposta SAML. Nella sezione Attestazioni utente della finestra di dialogo Attributi utente completare questa procedura per aggiungere gli attributi del token SAML:

    • uid
    • cn
    • mail
    • accessgroup
    • organization
    • orgdivision
    • orgunit
    • workgroup
    • Phone

    Nota

    Questi valori sono specifici dell'organizzazione. Fornire i valori appropriati.

    1. Selezionare Aggiungi nuova attestazione per aprire la finestra di dialogo Gestisci attestazioni utente:

    Select Add new claim

    Manage user claims dialog box

    1. Nella casella Nome immettere il nome dell'attributo indicato per la riga.

    2. Lasciare vuota la casella Spazio dei nomi.

    3. Per Origine, selezionare Attributo.

    4. Nell'elenco Attributo di origine selezionare il valore dell'attributo indicato per la riga.

    5. Selezionare OK.

    6. Seleziona Salva.

  9. Nella sezione Certificato di firma SAML della pagina Configura l'accesso Single Sign-On con SAML selezionare il collegamento Scarica accanto a XML metadati federazione, in base ai propri requisiti, quindi salvare il certificato nel computer:

    Certificate download link

  10. Nella sezione Configura Pegasystems copiare gli URL appropriati in base alle esigenze.

    Copy the configuration URLs

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 come almeno un utente Amministrazione istrator.
  2. Passare a Utenti>identità>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 Pega Systems.

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra come almeno un'applicazione cloud Amministrazione istrator.
  2. Passare a Applicazioni di identità>Applicazioni>aziendali>Pega Systems.
  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 Pega Systems

  1. Per configurare l'accesso Single Sign-On sul lato Pegasystems, accedere al portale Pega usando un account amministratore in un'altra finestra del browser.

  2. Selezionare Create>SysAdmin>Authentication Service (Crea > Amministrazione del sistema > Servizio di autenticazione):

    Select Authentication Service

  3. Seguire questa procedura nella schermata Crea servizio di autenticazione.

    Create Authentication Service screen

    1. Nell'elenco Type (Tipo) selezionare SAML 2.0.

    2. Nella casella Nome immettere qualsiasi nome, ad esempio Microsoft Entra SSO.

    3. Nella casella Short description (Descrizione breve) immettere una descrizione.

    4. Selezionare Create and open (Crea e apri).

  4. Nella sezione Identity Provider (IdP) information (Informazioni provider di identità) selezionare Importa metadati IdP e passare al file di metadati scaricato. Fare clic su Submit (Invia) per caricare i metadati:

    Identity Provider (IdP) information section

    L'importazione inserirà i dati del provider di identità come illustrato nella seguente immagine:

    Imported IdP data

  5. Seguire questa procedura nella sezione Service Provider (SP) settings (Impostazioni provider di servizi).

    Service provider settings

    1. Copiare il valore di Identificazione entità e incollarlo nella casella Identificatore nella sezione Configurazione SAML di base.

    2. Copiare il valore del percorso del servizio consumer di asserzione (ACS) e incollarlo nella casella URL di risposta nella sezione Configurazione SAML di base.

    3. Selezionare Disable request signing (Disabilita firma richiesta).

  6. Seleziona Salva.

Creare l'utente di test di Pega Systems

A questo punto occorre creare un utente di nome Britta Simon in Pegasystems. Collaborare con il team di supporto di Pegasystems per creare gli utenti.

Testare l'accesso SSO

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

Avviato da SP:

  • Fare clic su Test this application (Testa questa applicazione), verrà eseguito il reindirizzamento all'URL di accesso di Pega Systems in cui è possibile avviare il flusso di accesso.

  • Passare direttamente all'URL di accesso di Pega Systems e avviare il flusso di accesso da questa posizione.

Avviato da IDP:

  • Fare clic su Test this application (Testa questa applicazione) e si dovrebbe accedere automaticamente all'istanza di Pega Systems per cui si è configurato l'accesso SSO.

È anche possibile usare App personali Microsoft per testare l'applicazione in qualsiasi modalità. Quando si fa clic sul riquadro pega systems nel App personali, se è stato configurato in modalità SP, si dovrebbe essere reindirizzati alla pagina di accesso dell'applicazione per avviare il flusso di accesso e, se configurato in modalità IDP, si dovrebbe accedere automaticamente all'istanza di Pega Systems per cui si è configurato l'accesso SSO. Per altre informazioni su App personali, vedere l'introduzione ad App personali.

Passaggi successivi

Dopo aver configurato Pega Systems, è 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.