Condividi tramite

Esercitazione: Integrazione dell'accesso Single Sign-On (SSO) di Microsoft Entra con Documo

  • Articolo

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

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

Descrizione dello scenario

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

  • Documo supporta l'accesso SSO avviato da SP e IDP .
  • Documo supporta il provisioning utenti automatizzato.

Nota

Dal momento che l'identificatore di questa applicazione è un valore stringa fisso, è possibile configurare una sola istanza in un solo tenant.

Per configurare l'integrazione di Documo in Microsoft Entra ID, è necessario aggiungere Documo 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 Documo nella casella di ricerca.
  4. Selezionare Documo 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 Documo

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

Per configurare e testare l'accesso SSO di Microsoft Entra con Documo, 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 Documo: per configurare le impostazioni di Single Sign-On sul lato applicazione.
    1. Creare l'utente di test di Documo: per avere una controparte di B.Simon in Documo 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 ad Applicazioni di identità>Applicazioni>aziendali>Documo>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 sezione Configurazione SAML di base l'utente non deve eseguire alcuna operazione perché l'app è già preintegrata in Azure. Se l'account Documo ha un dominio personalizzato, è necessario disporre anche di un dominio API personalizzato per il funzionamento dell'accesso Single Sign-On. Sostituire i valori predefiniti con il dominio API personalizzato, https://mycustomapidomain.com ad esempio e https://mycustomapidomain.com/assert.

  6. Fare clic su Impostare URL aggiuntivi e seguire questa procedura se si vuole configurare l'applicazione in modalità avviata da SP:

    Nella casella di testo URL di accesso digitare l'URL:
    https://app.documo.com/sso

  7. Fare clic su Salva.

  8. Nella sezione Certificato di firma SAML della pagina Configura l'accesso Single Sign-On con SAML individuare il file XML dei metadati della federazione e selezionare Scarica per scaricare il certificato e salvarlo nel computer.

    The Certificate download link

  9. Nella sezione Configura Documo copiare gli URL appropriati in base alle esigenze.

    Copy 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 Documo.

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

  1. Accedere al sito Web Documo come amministratore.

  2. Passare a Account Impostazioni ->Security.

    screenshot for security page.

  3. Nella scheda Sicurezza fare clic sul pulsante Configura SSO nella parte inferiore della pagina.

    screenshot for configure button.

  4. Seguire questa procedura nella pagina Setup SAML (Configurazione SAML ).

    screenshot for configuration page.

    a. Nella casella di testo Entity Id (ID entità) incollare il valore di Microsoft Entra Identifier copiato in precedenza.

    b. Nella casella di testo SSO URL (URL di reindirizzamento) incollare il valore di URL di accesso copiato in precedenza.

    c. Assegnare il valore dominio di posta elettronica nella casella di testo.

    d. Immettere il valore nella casella di testo Nome campo nel token SAML contenente l'indirizzo di posta elettronica di identità.

    e. Aprire il file XML metadati federazione scaricato in Blocco note. Trovare il <X509Certificate> tag e incollare il contenuto nella casella di testo Certificato firmatario.

    f. Fare clic su Invia.

Creare l'utente di test di Documo

In questa sezione viene creato un utente di nome B.Simon in Documo.

  1. Passare alla pagina Utenti nell'app Documo.
  2. Fare clic sul pulsante Nuovo utente .
  3. Compilare il modulo utente con nome, posta elettronica, numero di telefono, ruolo utente e informazioni sulla password. Assicurarsi che il campo email corrisponda al messaggio di posta elettronica per B.Simon in Microsoft Entra ID.
  4. Fai clic su Crea.

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 Documo in cui è possibile avviare il flusso di accesso.

  • Passare direttamente all'URL di accesso di Documo 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 Documo 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 di Documo nella 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 Documo per cui si è configurato l'accesso SSO. Per altre informazioni su App personali, vedere l'introduzione ad App personali.

Passaggi successivi

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