Esercitazione: Integrazione di Azure Active Directory con Kantega SSO for Confluence

Questa esercitazione descrive come integrare Kantega SSO for Confluence con Azure Active Directory (Azure AD).

L'integrazione di Kantega SSO for Confluence con Azure AD offre i vantaggi seguenti:

  • È possibile controllare in Azure AD chi può accedere a Kantega SSO for Confluence
  • È possibile abilitare gli utenti per l'accesso automatico a Kantega SSO for Confluence (Single Sign-On) con gli account Azure AD
  • È possibile gestire gli account in un'unica posizione centrale: il portale di Azure.

Per altre informazioni sull'integrazione di app SaaS con Azure AD, vedere Informazioni sull'accesso alle applicazioni e Single Sign-On con Azure Active Directory.

Prerequisiti

Per configurare l'integrazione di Azure AD con Kantega SSO for Confluence, sono necessari gli elementi seguenti:

  • Sottoscrizione di Azure AD.
  • Sottoscrizione di Kantega SSO for Confluence abilitata per l'accesso Single Sign-On

Nota

Non è consigliabile usare un ambiente di produzione per testare i passaggi di questa esercitazione.

A questo scopo, è consigliabile seguire le indicazioni seguenti:

  • Non usare l'ambiente di produzione a meno che non sia necessario.
  • Se non si dispone di un ambiente di prova di Azure AD, è possibile ottenere una versione di valutazione di un mese qui.

Descrizione dello scenario

In questa esercitazione viene eseguito il test dell'accesso Single Sign-On di Azure AD in un ambiente di test. Lo scenario descritto in questa esercitazione prevede i due blocchi predefiniti seguenti:

  1. Aggiunta di Kantega SSO for Confluence dalla raccolta
  2. Configurazione e test dell'accesso Single Sign-On di Azure AD

Per configurare l'integrazione di Kantega SSO for Confluence in Azure AD, è necessario aggiungere Kantega SSO for Confluence dalla raccolta all'elenco di app SaaS gestite.

Per aggiungere Kantega SSO for Confluence dalla raccolta, seguire questa procedura:

  1. Nel portale di Azure fare clic sull'icona di Azure Active Directory nel riquadro di spostamento sinistro.

    Active Directory

  2. Passare ad Applicazioni aziendali. Andare quindi a Tutte le applicazioni.

    Applicazioni

  3. Fare clic sul pulsante Nuova applicazione nella parte superiore della finestra di dialogo per aggiungere una nuova applicazione.

    Applicazioni

  4. Nella casella di ricerca digitare Kantega SSO for Confluence.

    Creazione di un utente test di Azure AD

  5. Nel pannello dei risultati selezionare Kantega SSO for Confluence e quindi fare clic sul pulsante Aggiungi per aggiungere l'applicazione.

    Creazione di un utente test di Azure AD

Configurazione e test dell'accesso Single Sign-On di Azure AD

In questa sezione viene configurato e testato l'accesso Single Sign-On di Azure AD con Kantega SSO for Confluence mediante un utente test di nome "Britta Simon".

Per il funzionamento dell'accesso Single Sign-On, Azure AD deve individuare l'utente di Kantega SSO for Confluence corrispondente a un utente di Azure AD. In altre parole, deve essere stabilita una relazione di collegamento tra un utente di Azure AD e l'utente correlato in Kantega SSO for Confluence.

Per stabilire la relazione di collegamento, in Kantega SSO for Confluence assegnare il valore di nome utente in Azure AD come valore di Username (Nome utente).

Per configurare e testare l'accesso Single Sign-On di Azure AD con Kantega SSO for Confluence, è necessario completare i blocchi predefiniti seguenti:

  1. Configurazione dell'accesso Single Sign-On di Azure AD : per abilitare gli utenti all'utilizzo di questa funzionalità.
  2. Creazione di un utente test di Azure AD : per testare l'accesso Single Sign-On di Azure AD con l'utente Britta Simon.
  3. Creazione di un utente test di Kantega SSO for Confluence: per avere una controparte di Britta Simon in Kantega SSO for Confluence collegata alla rappresentazione dell'utente in Azure AD.
  4. Assegnazione dell'utente test di Azure AD : per abilitare Britta Simon all'uso dell'accesso Single Sign-On di Azure AD.
  5. Testing Single Sign-On : per verificare se la configurazione funziona.

Configurazione dell'accesso Single Sign-On di Azure AD

In questa sezione viene abilitato l'accesso Single Sign-On di Azure AD nel portale di Azure e viene configurato l'accesso Single Sign-On nell'applicazione Kantega SSO for Confluence.

Per configurare l'accesso Single Sign-On di Azure AD con Kantega SSO for Confluence, seguire questa procedura:

  1. Nella pagina di integrazione dell'applicazione Kantega SSO for Confluence del portale di Azure fare clic su Single Sign-On.

    Configura accesso Single Sign-On

  2. Nella finestra di dialogo Single Sign-On selezionare Accesso basato su SAML per Modalità per abilitare l'accesso Single Sign-On.

    Configura accesso Single Sign-On

  3. In modalità avviata IDP nella sezione URL e dominio Kantega SSO for Confluence eseguire l'operazione seguente:

    Configura accesso Single Sign-On

    a. Nella casella di testo Identificatore digitare l'URL adottando il modello seguente: https://<server-base-url>/plugins/servlet/no.kantega.saml/sp/<uniqueid>/login

    b. Nella casella di testo URL di risposta digitare l'URL usando il modello seguente: https://<server-base-url>/plugins/servlet/no.kantega.saml/sp/<uniqueid>/login

  4. In modalità avviata SP selezionare Mostra impostazioni URL avanzate ed eseguire l'operazione seguente:

    Configura accesso Single Sign-On

    Nella casella di testo URL di accesso digitare l'URL usando il modello seguente: https://<server-base-url>/plugins/servlet/no.kantega.saml/sp/<uniqueid>/login

    Nota

    Poiché questi non sono i valori reali, aggiornarli con l'identificatore, l'URL di risposta e l'URL di accesso effettivi. Questi valori vengono ricevuti durante la configurazione del plug-in Confluence descritto più avanti nell'esercitazione.

  5. Nella sezione Certificato di firma SAML fare clic su XML di metadati e quindi salvare il file dei metadati nel computer.

    Configura accesso Single Sign-On

  6. Fare clic sul pulsante Salva .

    Configura accesso Single Sign-On

  7. In un'altra finestra del Web browser accedere al portale di amministrazione di Confluence come amministratore.

  8. Passare il puntatore del mouse sulla rotellina e scegliere Add-ons (Componenti aggiuntivi).

    Configura accesso Single Sign-On

  9. Nella scheda ATLASSIAN MARKETPLACE (MARKETPLACE DI ATLASSIAN) fare clic su Find new add-ons (Trova nuovi componenti aggiuntivi).

    Configura accesso Single Sign-On

  10. Cercare Kantega SSO for Confluence SAML Kerberos e fare clic su Install (Installa) per installare il nuovo plug-in di SAML.

    Configura accesso Single Sign-On

  11. Viene avviata l'installazione del plug-in.

    Configura accesso Single Sign-On

  12. Al termine dell'installazione, Fare clic su Close.

    Configura accesso Single Sign-On

  13. Fare clic su Manage.

    Configura accesso Single Sign-On

  14. Fare clic su Configure (Configura) per configurare il nuovo plug-in.

    Configura accesso Single Sign-On

  15. Questo nuovo plug-in è disponibile anche nella schedaUSERS & SECURITY (UTENTI E SICUREZZA).

    Configura accesso Single Sign-On

  16. Nella sezione SAML Selezionare Azure Active Directory (Azure AD) dall'elenco a discesa Add identity provider (Aggiungi provider di identità).

    Configura accesso Single Sign-On

  17. Selezionare il livello di sottoscrizione Basic (Di base).

    Configura accesso Single Sign-On

  18. Nella sezione App properties (Proprietà app) seguire questa procedura:

    Configura accesso Single Sign-On

    a. Copiare il valore URI ID app e usarlo come Identificatore, URL di risposta e URL di accesso nella sezione URL e dominio Kantega SSO for Confluence nel portale di Azure.

    b. Fare clic su Avanti.

  19. Nella sezione Metadata import (Importazione metadati) seguire questa procedura:

    Configura accesso Single Sign-On

    a. Selezionare Metadata file on my computer (File metadati in questo computer) e caricare il file di metadati scaricato dal portale di Azure.

    b. Fare clic su Avanti.

  20. Nella sezione Name and SSO location (Nome e percorso SSO) seguire questa procedura:

    Configura accesso Single Sign-On

    a. Aggiungere il nome del provider di identità nella casella di testo Identity provider name (Nome provider di identità), ad esempio Azure AD.

    b. Fare clic su Avanti.

  21. Verificare il certificato di firma e fare clic su Next (Avanti).

    Configura accesso Single Sign-On

  22. Nella sezione Confluence user accounts (Account utente Confluence) seguire questa procedura:

    Configura accesso Single Sign-On

    a. Selezionare Create users in Confluence's internal Directory if needed (Crea utenti nella directory interna di Confluence se necessario) e immettere il nome appropriato del gruppo per gli utenti (è possibile specificare più gruppi separati da virgola).

    b. Fare clic su Avanti.

  23. Fare clic su Fine.

    Configura accesso Single Sign-On

  24. Nella sezione Known domains for Azure AD (Domini noti per Azure AD) seguire questa procedura:

    Configura accesso Single Sign-On

    a. Selezionare Known domains (Domini noti) dal pannello sinistro della pagina.

    b. Immettere il nome di dominio nella casella di testo Known domains (Domini noti).

    c. Fare clic su Salva.

Suggerimento

Un riepilogo delle istruzioni è disponibile all'interno del portale di Azure durante la configurazione dell'app. Dopo aver aggiunto l'app dalla sezione Active Directory > Applicazioni aziendali è sufficiente fare clic sulla scheda Single Sign-On e accedere alla documentazione incorporata tramite la sezione Configurazione nella parte inferiore. Altre informazioni sulla funzione di documentazione incorporata sono disponibili in Azure AD embedded documentation (Documentazione incorporata di Azure AD).

Creazione di un utente test di Azure AD

Questa sezione descrive come creare un utente test denominato Britta Simon nel portale di Azure.

Creare un utente di Azure AD

Per creare un utente test in Azure AD, eseguire la procedura seguente:

  1. Nel portale di Azure fare clic sull'icona di Azure Active Directory nel riquadro di spostamento sinistro.

    Creazione di un utente test di Azure AD

  2. Passare a Utenti e gruppi e fare clic su Tutti gli utenti per visualizzare l'elenco di utenti.

    Creazione di un utente test di Azure AD

  3. Nella parte superiore della finestra di dialogo fare clic su Aggiungi per aprire la finestra di dialogo Utente.

    Creazione di un utente test di Azure AD

  4. Nella pagina della finestra di dialogo Utente seguire questa procedura:

    Creazione di un utente test di Azure AD

    a. Nella casella di testo Nome digitare BrittaSimon.

    b. Nella casella di testo Nome utente digitare l'indirizzo di posta elettronica di BrittaSimon.

    c. Selezionare Mostra password e prendere nota del valore della Password.

    d. Fare clic su Crea.

Creazione di un utente test di Kantega SSO for Confluence

Per consentire agli utenti di Azure AD di accedere a Confluence, è necessario effettuarne il provisioning in Confluence. In Kantega SSO for Confluence il provisioning è un'attività manuale.

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

  1. Accedere al sito aziendale Kantega SSO for Confluence come amministratore.

  2. Passare il puntatore del mouse e fare clic su User management (Gestione utenti).

    Aggiungere un dipendente

  3. Nella sezione Users (Utenti) fare clic sula scheda Add users (Aggiungi utenti). Nella pagina della finestra di dialogo "Add a User" (Aggiungi un utente) eseguire la procedura seguente:

    Aggiungere un dipendente

    a. Nella casella di testo Username (Nome utente) digitare l'indirizzo di posta elettronica di un utente, ad esempio Brittasimon@contoso.com.

    b. Nella casella di testo Full Name (Nome completo) digitare il nome completo dell'utente, ad esempio Britta Simon.

    c. Nella casella di testo Email digitare l'indirizzo di posta elettronica dell'utente, ad esempio Brittasimon@contoso.com.

    d. Nella casella di testo Password digitare la password dell'utente.

    e. Fare clic sul pulsante Confirm (Conferma) e immettere di nuovo la password.

    f. Fare clic sul pulsante Aggiungi.

Assegnazione dell'utente test di Azure AD

In questa sezione Britta Simon viene abilitata per l'uso dell'accesso Single Sign-On di Azure concedendole l'accesso a Kantega SSO for Confluence.

Assegna utente

Per assegnare Britta Simon a Kantega SSO for Confluence, seguire questa procedura:

  1. Nel portale di Azure aprire la visualizzazione delle applicazioni e quindi la visualizzazione delle directory e passare ad Applicazioni aziendali, quindi fare clic su Tutte le applicazioni.

    Assegna utente

  2. Nell'elenco di applicazioni selezionare Kantega SSO for Confluence.

    Configura accesso Single Sign-On

  3. Scegliere Utenti e gruppi dal menu a sinistra.

    Assegna utente

  4. Fare clic sul pulsante Aggiungi. Selezionare quindi Utenti e gruppi nella finestra di dialogo Aggiungi assegnazione.

    Assegna utente

  5. Nella finestra di dialogo Utenti e gruppi selezionare Britta Simon nell'elenco Utenti.

  6. Fare clic sul pulsante Seleziona nella finestra di dialogo Utenti e gruppi.

  7. Fare clic sul pulsante Assegna nella finestra di dialogo Aggiungi assegnazione.

Test dell'accesso Single Sign-On

In questa sezione viene testata la configurazione dell'accesso Single Sign-On di Azure AD usando il pannello di accesso.

Quando si fa clic sul riquadro Kantega SSO for Confluence nel pannello di accesso, si dovrebbe accedere automaticamente all'applicazione Kantega SSO for Confluence. Per altre informazioni sul pannello di accesso, vedere Introduzione al Pannello di accesso.

Risorse aggiuntive