Condividi tramite


Integrazione di Microsoft Entra SSO con Civic Platform

In questo articolo si apprenderà come integrare Civic Platform con Microsoft Entra ID. Integrando Civic Platform con Microsoft Entra ID, è possibile:

  • Controllare in Microsoft Entra ID chi può accedere a Civic Platform.
  • Consenti agli utenti di effettuare automaticamente l'accesso a Civic Platform 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:

  • Sottoscrizione della Piattaforma Civic 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.

  • Civic Platform supporta l'SSO avviato da SP.

Nota

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

Per configurare l'integrazione di Civic Platform in Microsoft Entra ID, è necessario aggiungere Civic Platform dalla raccolta al proprio elenco di app SaaS gestite.

  1. Accedi al centro di amministrazione di Microsoft Entra come almeno un amministratore delle applicazioni cloud .
  2. Passare a Identity>Applications>Enterprise applications>New application.
  3. Nella sezione Aggiungi dalla raccolta, digitare Civic Platform nella casella di ricerca.
  4. Selezionare Civic Platform nel pannello dei risultati e quindi aggiungere l'app. Attendere qualche secondo mentre l'app viene aggiunta al tuo cliente.

In alternativa, è anche possibile usare la Procedura guidata di configurazione dell'App Aziendale. In questa procedura guidata è possibile aggiungere un'applicazione al tenant, aggiungere utenti/gruppi all'app, assegnare ruoli, nonché esaminare la configurazione dell'accesso SSO. Scopri di più sulle procedure guidate di Microsoft 365.

Configurare e testare l'accesso Single Sign-On di Microsoft Entra per Civic Platform

Configurare e testare SSO Entra di Microsoft con Civic Platform 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 Civic Platform.

Per configurare e testare l'accesso SSO di Microsoft Entra con Civic Platform, seguire questa procedura:

  1. Configurare il 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 permettere a B.Simon di utilizzare l'accesso Single Sign-On di Microsoft Entra.
  2. Configurare l'accesso Single Sign-On di Civic Platform: per configurare le impostazioni di Single Sign-On sul lato applicazione.
    1. Creare l'utente di test di Civic Platform: per avere una controparte di B.Simon in Civic Platform collegata alla rappresentazione dell'utente in Microsoft Entra.
  3. Testare SSO: per verificare se la configurazione funziona.

Configurare l'SSO di Microsoft Entra

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

  1. Accedi all'interfaccia di amministrazione di Microsoft Entra come almeno un Cloud Application Administrator .

  2. Accedere alla pagina di integrazione dell'applicazione Identity>Applications>Enterprise applications>Civic Platform, individuare la sezione Manage e selezionare Single Sign-On.

  3. Nella pagina Selezionare un metodo single sign-on selezionare SAML.

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

    Modificare la configurazione SAML di base

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

    un. Nella casella di testo (Identificatore ID entità), digitare il valore: civicplatform.accela.com

    b. Nella casella di testo URL di accesso digitare un URL usando il modello seguente: https://<SUBDOMAIN>.accela.com

    Nota

    Il valore dell'URL di accesso non è reale. Aggiornare questo valore con l'URL di accesso effettivo. Per ottenere questo valore, contattare il team di supporto clienti di Civic Platform. È anche possibile fare riferimento ai modelli illustrati nella sezione configurazione SAML di base.

  6. Nella pagina Configura singolo Sign-On con SAML, nella sezione certificato di firma SAML, clicca sul pulsante Copia per copiare l'URL dei metadati di federazione dell'app e salvarlo sul tuo computer.

    Lo screenshot mostra la pagina Certificato di firma SAML in cui è possibile copiare l'URL dei metadati di federazione dell'app

  7. Passare a Identity>Applications>Registrazioni app, seleziona la tua applicazione.

  8. Copiare l'ID directory (tenant) e archiviarlo nel Blocco note.

    Copiare la directory (ID tenant) e archiviarla nel codice dell'app

  9. Copiare l'ID applicazione e archiviarlo nel Blocco note.

    Copiare l'ID applicazione (client)

  10. Vai a Identity>Applications>Registrazioni app, seleziona l'applicazione. Selezionare Certificati & segreti.

  11. Selezionare le credenziali client -> Nuovo segreto client.

  12. Specificare una descrizione del segreto e una durata. Al termine, selezionare Aggiungi.

    Nota

    Dopo aver salvato il segreto client, viene visualizzato il valore del segreto client. Copiare questo valore perché non è possibile recuperare la chiave in un secondo momento.

    Copiare il valore del segreto perché non è possibile recuperarlo in un secondo momento

Creare un utente di test di Microsoft Entra

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

  1. Accedi al centro di amministrazione di Microsoft Entra come almeno un Amministratore Utente .
  2. Naviga verso Identity>Users>All users.
  3. Selezionare Nuovo utente>Crea nuovo utente, nella parte superiore della schermata.
  4. Nelle proprietà User seguire questa procedura:
    1. Nel campo Nome visualizzato inserire B.Simon.
    2. Nel campo Nome principale utente immettere il username@companydomain.extension. Ad esempio, B.Simon@contoso.com.
    3. Selezionare la casella di controllo Mostra password e quindi annotare il valore visualizzato nella casella Password.
    4. Seleziona Rivedi e crea.
  5. Selezionare Crea.

Assegnare l'utente di test di Microsoft Entra

In questa sezione, abiliterai B.Simon ad accedere all'accesso Single Sign-On concedendole l'accesso a Civic Platform.

  1. Accedi all'interfaccia di amministrazione di Microsoft Entra come almeno un Amministratore di applicazioni cloud .
  2. Passare a Identity>Applications>Enterprise applications>Civic Platform.
  3. Nella pagina panoramica dell'app, trova la sezione Gestisci e seleziona Utenti e gruppi.
  4. Selezionare Aggiungi utente, quindi selezionare Utenti e gruppi nella finestra di dialogo Aggiungi assegnazione.
  5. Nella finestra di dialogo utenti e gruppi selezionare B.Simon dall'elenco Utenti, quindi fare clic sul pulsante Seleziona nella parte inferiore della schermata.
  6. Se si prevede un valore di ruolo nell'asserzione SAML, nella finestra di dialogo Seleziona ruolo selezionare il ruolo appropriato per l'utente dall'elenco e quindi fare clic sul pulsante Seleziona nella parte inferiore della schermata.
  7. Nella finestra di dialogo Aggiungi assegnazione, fare clic sul pulsante Assegna.

Configurare il Single Sign-On di Civic Platform

  1. Aprire una nuova finestra del Web browser e accedere al sito aziendale di Atlassian Cloud come amministratore.

  2. Fare clic su Opzioni standard.

    Screenshot mostra il sito Atlassian Cloud con opzioni standard evidenziate in Strumenti di amministrazione.

  3. Creare una scelta standard ssoconfig.

  4. Cerca ssoconfig e invia.

    Screenshot mostra la Ricerca Scelte Standard con il nome s s o config immesso.

  5. Espandere SSOCONFIG facendo clic sul punto rosso.

    Screenshot mostra Opzioni standard Sfoglia con SSO CONFIG disponibile.

  6. Specificare le informazioni di configurazione correlate all'accesso Single Sign-On nel passaggio seguente:

    Screenshot mostra la modifica dell'elemento Scelte Standard per S S O CONFIG.

    1. Nel campo applicationid, immettere il valore ID applicazione, che hai copiato in precedenza.

    2. Nel campo clientSecret inserire il valore Secret che hai copiato in precedenza.

    3. Nel campo directoryId, immettere il valore ID directory (tenant), che è stato copiato in precedenza.

    4. Inserisci il nome dell'idp. Ad esempio: Azure.

Creare l'utente di test di Civic Platform

In questa sezione viene creato un utente di nome B.Simon in Civic Platform. Collaborare con il team di supporto di Civic Platform per aggiungere gli utenti al team di supporto clienti di Civic Platform. Gli utenti devono essere creati e attivati prima di usare l'accesso Single Sign-On.

Test SSO

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

  • Fare clic su Prova questa applicazione, questo ti reindirizzerà all'URL di accesso di Civic Platform dove potrai avviare il flusso di login.

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

  • È possibile usare Microsoft My Apps. Se fai clic sul riquadro di Civic Platform nelle App personali, sarai reindirizzato all'URL di accesso di Civic Platform. Per altre informazioni, vedere Microsoft Entra My Apps.

Dopo aver configurato Civic Platform, è 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.