App cloud Envoy

Utilizzando lo standard SAML 2.0, puoi configurare il Single Sign-On (SSO) per una serie di app cloud. Dopo aver configurato SSO, gli utenti possono utilizzare le proprie credenziali di Google Workspace per accedere a un'app utilizzando SSO.

Utilizzare SAML per configurare l'accesso SSO per Envoy

Per questa attività, devi aver eseguito l'accesso come super amministratore.

Passaggio 1: configura Google come provider di identità SAML

  1. Nella Console di amministrazione Google, vai al Menu e poi Appe poiApp web e mobile.

    Per questa attività, devi aver eseguito l'accesso come super amministratore.

  2. Fai clic su Aggiungi appe poiCerca app.
  3. In Inserisci il nome dell'app, digita Envoy.
  4. Nei risultati di ricerca, posiziona il puntatore su Envoy e fai clic su Seleziona.

  5. Nella finestra Dettagli del provider di identità Google, in Opzione 2: copia l'URL SSO, l'ID entità e il certificato:

    1. Accanto a URL SSO, fai clic su Copia e salva l'URL.
    2. Accanto a Certificato, fai clic su Scarica e salva il certificato.
      Questi dettagli sono necessari per completare la configurazione in Envoy.
  6. Fai clic su Continua.
    Nella pagina Dettagli del fornitore di servizi, i dettagli dell'app sono configurati per impostazione predefinita.
  7. Fai clic su Continua.
  8. (Facoltativo) Per mappare gli attributi della directory Google agli attributi dell'app corrispondenti, nella finestra Mappatura attributi:
    1. Fai clic su Aggiungi mappatura.
    2. Fai clic su Seleziona campoe poiseleziona un attributo della directory Google.
    3. Per Attributi app, inserisci l'attributo app corrispondente.
  9. (Facoltativo) Per inserire i nomi dei gruppi pertinenti per questa app:
    1. In (Facoltativo) Appartenenza al gruppo, fai clic su Cerca un gruppo, inserisci una o più lettere del nome del gruppo e seleziona il nome del gruppo.
    2. Se necessario, aggiungi altri gruppi (massimo 75).
    3. Per Attributo app, inserisci il nome dell'attributo dei gruppi corrispondente del fornitore di servizi.

    Indipendentemente dal numero di nomi di gruppi che inserisci, la risposta SAML include solo i gruppi a cui un utente appartiene direttamente o indirettamente. Per saperne di più, vai a Informazioni sulla mappatura dell'iscrizione al gruppo.

  10. Fai clic su Fine.

Passaggio 2: configura Envoy come fornitore di servizi SAML 2.0

Prima di iniziare: utilizza uno strumento online per convertire il certificato scaricato nel passaggio 1 in un'impronta del certificato. Per completare i passaggi che seguono, devi avere il fingerprint del certificato

  1. Apri una finestra del browser in incognito, vai alla pagina di accesso di Envoy e accedi con il tuo account amministratore Envoy.
  2. Vai a https://dashboard.envoy.co/settings/integrations.
  3. Seleziona SAML.
  4. In Fingerprint (Impronta), incolla l'impronta del certificato.
  5. In Identity Provider HTTP SAML URL (URL SAML HTTP del provider di identità), incolla l'URL SSO che hai copiato nel passaggio 1.
  6. Fai clic su Salva.

Passaggio 3: avvia l'app per gli utenti

Prima di iniziare:per attivare o disattivare il servizio per determinati utenti, raggruppa i loro account in un'unità organizzativa per controllare gli accessi in base al reparto o inseriscili in un gruppo di accesso per consentire l'accesso degli utenti all'interno del loro reparto o in tutti i reparti dell'organizzazione.

  1. Nella Console di amministrazione Google, vai al Menu e poi Appe poiApp web e mobile.

    Per questa attività, devi aver eseguito l'accesso come super amministratore.

  2. Fai clic su Envoy.
  3. Fai clic su Accesso utenti.

  4. Per attivare o disattivare un servizio per tutti gli utenti dell'organizzazione, fai clic su ON per tutti o OFF per tutti, quindi fai clic su Salva.

  5. (Facoltativo) Per attivare o disattivare un servizio per un'unità organizzativa:
    1. A sinistra, seleziona l'unità organizzativa.
    2. Per cambiare lo stato del servizio, seleziona On o Off.
    3. Scegli un'opzione:
      • Se lo stato del servizio è impostato su Ereditato e vuoi mantenere l'impostazione aggiornata, anche se quella dell'unità organizzativa principale viene modificata, fai clic su Ignora.
      • Se lo stato del servizio è impostato su Ignorato, fai clic su Eredita per ripristinare la stessa impostazione dell'unità organizzativa principale oppure fai clic su Salva per mantenere la nuova configurazione, anche se cambia l'impostazione dell'unità organizzativa principale.
        Scopri di più sulla struttura organizzativa.
  6. (Facoltativo) Per attivare un servizio per un insieme di utenti all'interno di una o tutte le unità organizzative, seleziona un gruppo di accesso. Per maggiori dettagli, vedi Personalizza l'accesso ai servizi utilizzando i gruppi di accesso.
  7. Assicurati che i domini email degli account utente di Envoy corrispondano al dominio principale dell'Account Google gestito della tua organizzazione.

Passaggio 4: verifica che il servizio SSO funzioni

Envoy supporta il servizio SSO avviato sia dal provider di identità che dal fornitore di servizi.

Verificare l'SSO avviato dal provider di identità

  1. Nella Console di amministrazione Google, vai al Menu e poi Appe poiApp web e mobile.

    Per questa attività, devi aver eseguito l'accesso come super amministratore.

  2. Fai clic su Envoy.
  3. Nella sezione Envoy, fai clic su Verifica accesso SAML.

    L'app dovrebbe aprirsi in una scheda separata. In caso contrario, risolvi il problema correlato al messaggio di errore e riprova. Per informazioni dettagliate sulla risoluzione dei problemi, vedi Messaggi di errore delle app SAML.

Verificare l'SSO avviato dal fornitore di servizi

  1. Chiudi tutte le finestre del browser.
  2. Vai alla pagina di accesso di Envoy e accedi con il tuo account amministratore Envoy.
    Dovrebbe aprirsi automaticamente la pagina Accedi con Google.
  3. Seleziona il tuo account e inserisci la password.

Una volta autenticate le tue credenziali, l'app dovrebbe aprirsi.


Google, Google Workspace e i marchi e loghi correlati sono marchi di Google LLC. Tutti gli altri nomi di società e prodotti sono marchi delle società a cui sono associati.