Gli amministratori della sicurezza dell'organizzazione possono seguire i passi seguenti per configurare le impostazioni SAML single sign-on dell'organizzazione. Il single sign-on (SSO) basato su SAML consente ai membri di accedere a Workiva attraverso un provider di identità (IdP). Prima di configurare le impostazioni, assicurati di aver controllato Cos'è SAML single sign-on?.
Nota: gli amministratori della sicurezza dell'organizzazione devono essere aggiunti a un workspace per poter accedere all'amministrazione dell'organizzazione.
Passo 1: accedi alle impostazioni di SAML SSO
- Vai all'Amministratore dell'organizzazione.
- Fai clic su Gestione identità e accessi nel menu di sinistra.
- Assicurati di essere nella scheda Autenticazione.
- Fai clic sulla pagina Configurazione SSO.
Se disponi di una configurazione SSO esistente, la pagina apparirà così:
Passo 2: crea la tua configurazione SAML SSO e seleziona il tuo provider di identità
- Fai clic su Crea configurazione SSO.
- Inserisci un Nome configurazione e seleziona il Provider di identità (IdP) dal menu a discesa.
- Fai clic su Crea configurazione per procedere.
Passo 3: invia i metadati Workiva all'amministratore del tuo provider di identità
- Nella sezione Metadati Workiva, trovi l'Identificatore (Entity ID) e l'URL di risposta.
- Fai clic su Opzioni avanzate per visualizzare l'URL di accesso e l'URL di logout.
Questi URL sono unici per ciascuna organizzazione, non possono essere modificati e conterranno uno dei seguenti indicatori di regione: app.wdesk.com, apac.wdesk.com, ca.wdesk.com o eu.wdesk.com. - Invia questi URL dei metadati Workiva all'amministratore del provider di identità.
Puoi anche fare clic su Scarica XML metadati Workiva per scaricare e inviare invece il file XML dei metadati Workiva all'amministratore del provider di identità. -
Puoi regolare la Tolleranza disallineamento orologio. La tolleranza disallineamento orologio è la differenza di tempo massima consentita tra il tuo provider di identità SAML e Workiva. Il valore predefinito è 300 secondi (5 minuti).
Suggerimento: un valore maggiore amplia la "finestra di accettazione" per le differenze di tempo. Sebbene questo migliori l'affidabilità riducendo le richieste rifiutate, introduce anche dei rischi per la sicurezza e le prestazioni. In alternativa, un valore più piccolo aumenta la probabilità di errori di autenticazione dovuti a timeout.
- Se utilizzi Microsoft Azure come provider di identità, l'amministratore del provider di identità può fare riferimento al Passo 2 nella scheda Azure in Configurare SAML SSO con il provider di identità.
- Se utilizzi Okta come provider di identità, l'amministratore del provider di identità può fare riferimento al Passo 3 nella scheda Okta in Configurare SAML SSO con il provider di identità.
- Se usi un provider di identità diverso da Microsoft Azure o Okta, contatta il supporto clienti del tuo provider di identità se hai bisogno di assistenza.
Passo 4: inserisci i metadati del provider di identità in Workiva
Prerequisito: prima di procedere, devi ottenere le informazioni richieste sui metadati del provider di identità dall'amministratore del provider di identità.
- Se utilizzi Microsoft Azure come provider di identità, l'amministratore del provider di identità può fare riferimento al Passo 4 nella scheda Azure in Configurare SAML SSO con il provider di identità.
- Se utilizzi Okta come provider di identità, l'amministratore del provider di identità può fare riferimento al Passo 2 nella scheda Okta in Configurare SAML SSO con il provider di identità.
- Se utilizzi un provider di identità diverso da Microsoft Azure o Okta, contatta l'assistenza clienti del tuo provider di identità per ottenere le informazioni.
Nella sezione dei metadati del provider di identità (ad esempio, Metadati Microsoft Azure), inserisci i metadati del provider di identità.
- Per prima cosa, nel menu a discesa Metodo di inserimento preferito seleziona come vuoi inserire i metadati del provider di identità. Puoi inserire un URL metadati federazione, caricare un file XML metadati o inserire i metadati tramite l'Inserimento manuale.
-
Nella finestra di dialogo di selezione file, seleziona il file contenente le informazioni sui metadati del provider di identità, quindi fai clic su Importa.
In alternativa, puoi inserire i valori manualmente:
Passaggio 5: impostare la mappatura utenti
Nella sezione Mappatura utenti, fai clic sul menu a discesa e seleziona una di queste opzioni:
- Mappare gli utenti con il loro nome utente Workiva (consigliato)
- Mappare gli utenti manualmente
Nota: se hai inserito le informazioni sui metadati del provider di identità manualmente, devi attivare le Opzioni avanzate per questa sezione.
Mappare gli utenti con il loro nome utente Workiva
Se hai selezionato Mappa gli utenti al loro nome utente Workiva nel menu a discesa, al momento dell'accesso dell'utente Workiva si aspetterà che l'attributo Primary NameID in entrata corrisponda al nome utente Workiva, ignorando la distinzione tra maiuscole e minuscole. Ad esempio, questo permette a User.Name.Example di corrispondere a user.name.example.
Puoi quindi fare clic sul menu a discesa Imposta mappatura e selezionare Imposta tutti gli ID SSO al nome utente Workiva per popolare la tabella.
Fai clic su Crea configurazione per procedere.
Mappatura manuale degli utenti
Se hai selezionato Mappa utenti manualmente nel menu a discesa, per prima cosa controlla le opzioni avanzate. Sotto Posizione NameIdentifier, per la maggior parte delle configurazioni sarà selezionata l'opzione NameIdentifier è nella dichiarazione Soggetto. Ciò significa che Workiva verificherà la presenza dell'elemento NameIdentifier nella dichiarazione Oggetto.
Tuttavia, puoi selezionare l'opzione NameIdentifier è usato in un attributo di un altro elemento e inserire l'attributo dell'elemento NameIdentifier, in modo che l'applicazione cerchi l'attributo nella risposta SAML.
Nota: la maggior parte degli amministratori della sicurezza dell'organizzazione non modifica la posizione del NameIdentifier rispetto all'impostazione predefinita. Prima di apportare modifiche, contatta il Workiva Support per ricevere assistenza.
Mappa gli utenti tramite importazione file
Fai clic su Imposta mappatura e seleziona Importa ID SSO tramite file per mappare gli utenti agli ID SSO in un file di mappatura .csv (vedi Requisiti del file di mappatura .csv dell'ID SAML).
- Nel file di mappatura non sono necessarie intestazioni.
- Tutte le righe verranno elaborate e le righe non valide verranno ignorate.
- In caso di nomi utente duplicati, verrà usata solo la prima riga con quel nome utente.
- Se un nome utente fornito ha già una mappatura esistente, la mappatura verrà aggiornata con il valore contenuto nel file di mappatura.
- Se le righe vengono saltate, gli errori verranno registrati nel registro delle attività di SAML single sign-on.
Mappa gli utenti singolarmente
Se hai bisogno di impostare o modificare gli ID SSO per gli utenti singolarmente, cerca l'utente o usa il filtro Stato ID SSO per trovare più facilmente l'utente. Poi nella tabella, fai doppio clic sul campo ID SSO accanto all'utente e inserisci l'ID SSO corretto.
Dopo aver impostato la mappatura utenti, fai clic su Crea configurazione per procedere.
Requisiti del file di mappatura ID SAML .csv
Una riga valida nel file di mappatura ID SAML .csv si attiene al seguente formato:
samlId,username Una riga può essere non valida se:
- Ci sono meno di due elementi nella riga
- L'ID SAML e/o il nome utente non sono stati forniti
- Il nome utente fornito non esiste
- L'utente con il nome utente fornito non è un membro dell'organizzazione
- L'organizzazione principale dell'utente con il nome utente fornito non è la stessa dell'organizzazione che si sta modificando
- L'ID SAML fornito è già stato preso da un altro utente
Un esempio di file di mappatura valido è il seguente:
exampleSamlId,exampleUsername exampleSamlId2,exampleUsername2 exampleSamlId3,exampleUsername3
Passo 6: attiva la tua configurazione SAML SSO
Dopo aver creato la tua configurazione SAML SSO, dovrai attivarla esplicitamente affinché entri in vigore.
Fai clic su Attiva nella configurazione. La tua configurazione apparirà quindi come Attiva.
Passo 7: aggiorna le opzioni di autenticazione SAML SSO
Workiva consiglia vivamente di forzare l'accesso tramite SSO per gli utenti come best practice per semplificare il processo di login e offrire una migliore esperienza complessiva. Dopo aver creato e attivato la tua configurazione SAML SSO:
- Nella scheda Single sign-on, la sezione Forza SSO ed eccezioni presenta due opzioni di autenticazione:
-
Forza gli utenti ad accedere con SSO (Consigliato): gli utenti non amministratori devono usare SSO, mentre gli amministratori della sicurezza dell'organizzazione possono continuare ad accedere con nome utente e password. Questa opzione funziona meglio se la tua azienda vuole forzare l'SSO ma consentire comunque agli Amministratori della sicurezza dell'organizzazione di accedere alla piattaforma in caso di problemi con l'SSO.
Nota: assicurati di condurre test completi e di essere completamente sicuro della tua configurazione SAML SSO prima di abilitare questa opzione.
- Forza gli amministratori della sicurezza dell'organizzazione ad accedere con SSO: gli amministratori della sicurezza dell'organizzazione devono usare SSO. Questa opzione funziona meglio se le politiche di sicurezza dell'azienda non vogliono esentare gli utenti dal requisito SSO. Per abilitare questa opzione, devi anche selezionare Forza gli utenti ad accedere con SSO. Si trova nella pagina Requisiti SSO, nella scheda Autenticazione.
-
- Dopo aver selezionato le opzioni, fai clic su Salva.
Se lo desideri, puoi consentire a utenti specifici di accedere senza SAML SSO aggiungendoli all'elenco delle eccezioni SSO.
Nota: prima di forzare SAML SSO, assicurati di aggiungere gli utenti necessari all'elenco delle eccezioni SSO per evitare che non possano più accedere ai propri account.
Configurare SAML SSO con il provider di identità
L'amministratore del provider di identità può fare riferimento ai passi seguenti per configurare SAML SSO con i provider di identità comuni.
Caratteristiche supportate
- SSO avviato da SP
- SSO avviato da IdP
- SLO (Single Logout) avviato da IdP
- Elenco delle eccezioni SSO
- Crittografia asserzione opzionale
Passo 1: aggiungere l'integrazione
- Accedi al portale di amministrazione Okta e, in Applicazioni, seleziona Sfoglia catalogo app.
- Nel Catalogo delle integrazioni delle app, cerca Workiva e selezionala. Quindi clicca su Aggiungi integrazione.
- Configura le impostazioni generali in base alle tue politiche e procedure IT. Quindi fai clic su Avanti.
Passo 2: inserire i metadati Okta in Workiva
Nella sezione SAML 2.0, lascia vuoto il campo Stato inoltro predefinito. Scarica il file XML metadati da caricare su Workiva come descritto nel Passo 4 in Workiva: inserisci i metadati del provider di identità in Workiva.
Un modo per scaricare il file XML è copiare l'URL dei metadati, incollarlo in un browser e salvare la pagina come file XML.
Passaggio 3: inserire i metadati Workiva in Okta
Utilizzando gli URL di Workiva che si trovano nel Passo 3 in Workiva: invia i metadati Workiva all'amministratore del tuo provider di identità:
- Copia e incolla l'URL ACS di Workiva nel campo URL ACS di Okta.
- Copia e incolla l'URL pubblico di Workiva nel campo URL pubblico di Okta.
Passaggio 4: modificare gli attributi e le attestazioni
In Attributi e richieste di Okta, si consiglia di abbinare il nome utente di Workiva (senza distinzione tra maiuscole e minuscole) all'attributo Primary NameID, in modo che Workiva mappi automaticamente l'attributo al nome utente di Workiva quando l'utente effettua il primo accesso con SSO. Tuttavia, questa mappatura dipende dalle tue specifiche politiche IT.
Se questi attributi non corrispondono, dovrai mappare manualmente l'attributo al nome utente corrispondente come descritto in Passo 5 in Workiva: Impostare la mappatura degli utenti prima che l'utente possa accedere con SSO.
Processo SSO avviato da SP
Il processo di accesso viene avviato dall'URL SP (app.wdesk.com, apac.wdesk.com, ca.wdesk.com o eu.wdesk.com) della tua organizzazione di origine.
- Dal tuo browser, vai alla pagina di accesso di Workiva.
- Inserisci il tuo nome utente Workiva.
- Clicca su Accedere con Single Sign-On.
- Verrai reindirizzato alla pagina di accesso della tua organizzazione.
- Inserisci le credenziali e completa le eventuali verifiche aggiuntive previste dai criteri della tua organizzazione.
- Verrai reindirizzato a Workiva e accederai all'interfaccia.
Passo 1: crea l'applicazione
- Accedi al portale di amministrazione Azure e vai su Microsoft Entra ID > Applicazioni aziendali.
- Clicca su Nuova applicazione.
- Cerca Workiva e selezionalo.
Tieni presente che se intendi implementare SCIM, devi creare un'applicazione personalizzata. - Dai un nome all'applicazione, poi clicca su Crea.
- Dopo aver creato l'applicazione, vai su Single sign-on > SAML.
Passaggio 2: inserire i metadati Workiva in Microsoft Azure
- Modifica la configurazione SAML di base.
- Utilizzando gli URL di Workiva che si trovano nel Passo 3 in Workiva: invia i metadati Workiva all'amministratore del tuo provider di identità:
- Copia e incolla l'Identificatore (ID entità) di Workiva nel campo Identificatore (ID entità) di Azure.
- Copia e incolla l'URL di risposta di Workiva nel campo URL di risposta (URL del servizio consumer di asserzione) di Azure.
- (Facoltativo) Copia e incolla l'URL di accesso di Workiva nel campo URL di accesso di Azure.
- Lascia vuoto il campo Stato inoltro.
- (Facoltativo) Copia e incolla l'URL di logout di Workiva nel campo URL di logout di Azure.
Passaggio 3: modificare gli attributi e le attestazioni
Una volta salvata la configurazione, modifica gli Attributi e attestazioni. Si consiglia di abbinare il nome utente di Workiva (senza distinzione tra maiuscole e minuscole) all'attributo Primary NameID, in modo che Workiva mappi automaticamente l'attributo al nome utente di Workiva quando l'utente effettua il primo accesso con SSO. Tuttavia, questa mappatura dipende dalle tue specifiche politiche IT.
- Se questi attributi non corrispondono, dovrai mappare manualmente l'attributo al nome utente corrispondente come descritto in Passo 5 in Workiva: Impostare la mappatura degli utenti prima che l'utente possa accedere con SSO.
- Workiva esamina solo le richieste obbligatorie Identificatore univoco dell'utente (NameID) per gli utenti e qualsiasi altra richiesta viene ignorata.
Passaggio 4: inserire i metadati Microsoft Azure in Workiva
Se inserisci i metadati Microsoft Azure in Workiva tramite URL dei metadati di federazione, puoi trovare l'URL dei metadati di federazione nella configurazione Azure SAML SSO.
Se stai inserendo i metadati di Microsoft Azure in Workiva tramite il file XML metadati, nella sezione Certificati SAML fai clic su Scarica accanto a XML metadati federazione. Quindi carica il file XML dei metadati in Workiva.
Nota: se usi Microsoft Azure come provider di identità, assicurati che il campo URL di accesso di Workiva (nelle opzioni avanzate) sia lasciato vuoto, altrimenti si verificheranno errori di accesso.
Se vuoi un URL di logout (nelle opzioni avanzate) ma tale valore non è presente nel file XML dei metadati caricato, dovrai incollarlo manualmente.