Guida alla configurazione dell'SSO di Okta: configurare Okta come IdP SAML o OIDC

La soluzione miniOrange Identity Broker consente l'autenticazione cross-protocollo. È possibile configurare Okta come IDP per il Single Sign-On (SSO) nelle proprie applicazioni/siti web. In questo caso, Okta fungerà da Identity Provider (IDP) e miniOrange da broker.

Offriamo una soluzione pre-costruita per l'integrazione con Okta, rendendola più facile e veloce da implementare. Il nostro team può anche aiutarti a configurare Okta come SAML o OIDC IDP per accedere alle tue applicazioni.

Ottieni assistenza gratuita per l'installazione

miniOrange offre assistenza gratuita tramite una consulenza telefonica con i nostri ingegneri di sistema per configurare l'SSO per diverse app utilizzando Okta come IDP nel tuo ambiente, con una prova gratuita di 30 giorni.

Per farlo, è sufficiente inviarci un'e-mail all'indirizzo idpsupport@xecurify.com per prenotare un appuntamento e vi aiuteremo in brevissimo tempo.

Prerequisiti

Assicurati che l'immagine coordinata della tua organizzazione sia già impostata in Personalizzazione >> Immagine coordinata per l'accesso e la registrazione, nel menu a sinistra della dashboard.

Seguire la guida passo passo fornita di seguito per Okta Single Sign-On (SSO)

Passaggio 1: configurare miniOrange come SP in Okta

Di seguito sono indicati i passaggi per configurare Okta come IDP tramite configurazione SAML e OAuth. Segui i passaggi di conseguenza in base alle tue esigenze (SAML o OAuth).

SAML
OAuth

Segui i passaggi per configurare Okta come IdP SAML.

Vai su Console di amministrazione miniOrange e vai a Provider di identità nel menu di navigazione a sinistra. Quindi, fai clic su Aggiungi provider di identità pulsante.

In Scegli il fornitore di identità, selezionare SAML dal menu a discesa.

Okta IDP: seleziona SAML dal menu a discesa

Quindi, cerca Okta e fare clic su di esso.

Sulla Fornitore di identità SAML schermo, fare clic Visualizza le informazioni sui metadati per aprire i metadati SAML di miniOrange (miniOrange come fornitore di servizi).

Azure AD come IDP: provider di identità SAML, visualizzazione delle informazioni sui metadati

Copia ID entità o emittente and URL ACS valori e tenerli a portata di mano. Ciò richiederà la configurazione dell'applicazione sul lato Okta.

Okta SAML IDP: tieni a portata di mano i dettagli dei metadati SP

Ora vai a Okta sito e accedi al tuo Pannello di controllo di Okta.
Quindi fare clic sul Applicazioni dal pannello laterale e quindi selezionare Applicazioni.
Clicca sul Crea l'integrazione dell'app pulsante.

Configura Okta come SAML IDP: fai clic su Applicazioni >> Applicazioni

Seleziona SAML 2.0 as Metodo di accesso e fare clic sul Avanti pulsante.

Nel Impostazioni generali scheda, inserisci il Nome dell'applicazione e cliccare su Avanti pulsante.

Okta come SAML IDP: inserisci il nome dell'app e fai clic su Avanti

Nel Configurare SAML scheda di Okta, inserisci i seguenti dettagli richiesti:

URL di accesso singolo	URL ACS (Assertion Consumer Service) da SSO INIZIATO SP sezione del miniarancione
URI del pubblico (ID entità SP)	ID entità o emittente da SSO INIZIATO SP sezione del miniarancione
RelayState predefinito (facoltativo)	Questo è l'URL a cui vuoi reindirizzare i tuoi utenti dopo l'SSO.
Formato ID nome	Seleziona Indirizzo email come Formato ID nome dall'elenco a discesa
Nome utente dell'applicazione	Nome utente Okta

Configura Okta come SAML IDP: inserisci l'URL ACS e l'ID entità o l'emittente

Configurazione Dichiarazioni di attributo and Dichiarazioni sugli attributi di gruppo (facoltativo) quindi fare clic su Avanti pulsante.

Configura Okta come SAML IDP: aggiungi istruzioni di attributo

Fare clic su Avanti poi Finitura.
Accedere a Assegnazioni scheda di Okta.
Fare clic su Assegna & Selezionare Assegnare alle personeSeleziona l'utente dal popup e fai clic su FattoSe necessario, è anche possibile assegnare gruppi.

Configura Okta come SAML IDP: vai alla scheda Assegnazione e fai clic su Assegna >> seleziona Assegna a persone

Configura Okta come SAML IDP: fai clic sul collegamento Assegna

Passare alla Firmare scheda.

Configura Okta come SAML IDP: fai clic sulla scheda Accedi

Clicca sul Più dettagli opzione per visualizzare i dettagli dei metadati.
copiare il URL metadati, necessario nel passaggio 2 per configurare Okta in miniOrange.

Configura Okta come SAML IDP: copia l'URL dei metadati e tienilo a portata di mano

Segui i passaggi per configurare Okta come IdP tramite la configurazione OAuth.

Vai su Console di amministrazione miniOrange.
Dalla barra di navigazione a sinistra seleziona Fornitori di identità >> clicca Aggiungi provider di identità.

In Scegli il fornitore di identità, selezionare OAuth/OpenID dal menu a discesa.

Okta IDP: seleziona OAuth/OpenID dal menu a discesa

Cercare Okta nell'elenco. Se non lo trovi, cerca Fornitore OAuth e imposta lì la tua applicazione.

Tenere il URL di callback OAuth, che utilizzeremo per configurare Okta come server/provider OAuth.

Okta Single Sign On: copia l'URL di callback OAuth

Ora vai a Okta sito e accedi al tuo Pannello di controllo di Okta.
Quindi fare clic sul Applicazioni dal pannello laterale e quindi selezionare Applicazioni.
Clicca sul Crea l'integrazione dell'app pulsante.

Configura Okta come SAML IDP: vai su Applicazioni e fai clic su Crea integrazione app

Seleziona OIDC - Connessione OpenID as Metodo di accesso and Applicazione web as Tipo di applicazione. Clic Avanti.

Configura Okta come SAML IDP: scegli OIDC - OpenID Connect

Verrai reindirizzato alla pagina dei dettagli dell'app. Inserisci Nome dell'integrazione dell'app and URI di reindirizzamento dell'accesso, che abbiamo copiato come URL di callback OAuth da miniOrange.

Configura Okta come SAML IDP: inserisci Appname e Callback

Scorri verso il basso e vedrai il Assegnazioni sezione. Seleziona un'opzione per Accesso controllato come Consenti a tutti nella tua organizzazione di accedere, deseleziona il Abilita l'accesso immediato con la modalità Federation Broker e quindi fare clic su Salva pulsante.

Configura Okta come SAML IDP: scorri fino ad Assegnazione e seleziona accesso controllato

Ora otterrai il ID cliente and Client SecretTieni a portata di mano queste credenziali per la configurazione Accesso singolo (SSO) al client OAuth miniOrange.

Configura Okta come SAML IDP: copia dell'ID client e del segreto client

Copia il nome del dominio: Dall'intestazione in alto a destra, otterrai il tuo nome di dominio. Tieni il nome di dominio a portata di mano.

Configura Okta come SAML IDP: per ottenere il nome di dominio Okta

Recupera i gruppi Okta:

Clicca sul Firmare nella tua applicazione Okta.

Configura Okta come SAML IDP: vai alla scheda Accedi

Scorrere fino a Token ID di OpenID Connect .
Sotto il Filtro reclami di gruppo sezione, immettere gruppi come nome predefinito, quindi selezionare Corrisponde a regex dall'elenco a discesa e inserisci .* (senza spazi) per restituire tutti i gruppi dell'utente.

Configura Okta come SAML IDP: scorri verso il basso fino a OpenID Connect ID Token

Clicca sul Salva pulsante.

Attributi del profilo per il token ID:

Vai su Dashboard di amministrazione Okta >> Sicurezza >> API.
Fare clic su Aggiungi server di autorizzazione pulsante.
Dopo aver creato un nuovo Server di autorizzazione, Fare clic sul Modifica icona, come mostrato di seguito.

Configura Okta come SAML IDP: vai su Sicurezza e fai clic su API per aggiungere il server di autorizzazione

Vai su Sinistri e seleziona ID opzione token.

Configura Okta come SAML IDP: fai clic su Claims e seleziona ID token

Fare clic su Aggiungi reclamo pulsante.
Dai un Nome al tuo claim/attributo e seleziona il Token ID da Includi nel tipo di token menu a discesa. Ora, inserisci il valore utente.$attributo nella Valore campo in base all'attributo che vuoi ricevere. Mantieni le altre impostazioni come predefinite.

Configura Okta come SAML IDP: aggiungi claim

Clicchi Crea pulsante.

Segui gli stessi passaggi per tutti gli attributi che vuoi visualizzare.

2. Configurare Okta come IDP in miniOrange

SAML
OAuth

Torna alla console di amministrazione miniOrange (avresti dovuto tenerla aperta dal passaggio 1).
Fare clic su Importa metadati IDP.

Configura i metadati IDP di importazione Okta

entra Nome IDP. Selezionare URL pulsante di scelta e inserisci l'URL copiato da Okta.
Fare clic su Importare.

Come mostrato di seguito, il ID entità IDP, URL di Single Sign-On (SSO)e Certificato X.509 I dati di Okta vengono compilati dai metadati che hai importato. Aggiornali su Basic solo se cambiano gli endpoint SAML di Okta o il certificato di firma.

Configurazione di Okta come IdP: URL di Single Sign-On (SSO) e certificato x.509

Clicchi Avanti o apri il file Filtri scheda. Le impostazioni nella tabella sottostante sono opzionale—modificali solo quando la tua configurazione lo richiede; altrimenti mantieni le impostazioni predefinite.

Mappatura del dominio	Può essere utilizzato per reindirizzare uno specifico utente di dominio a uno specifico provider di identità (IDP).
Binding SSO	Per il binding della richiesta SAML; scegliere HTTP-POST or Reindirizzamento HTTP (come nel menu a tendina).
Formato ID Nome	NomeID formato per le asserzioni (ad esempio emailAddress); corrispondenza con Okta / le tue app.
Sovrascrivi l'URL di ritorno	Sovrascrivi l'URL di ritorno predefinito quando l'SSO viene avviato tramite un flusso avviato dall'IdP e non viene ricevuto alcun RelayState.
Firma la richiesta SAML	Consentire a tutti questa opzione per firma le richieste di autenticazione SAML che miniOrange invia a questo IdP.

Configurazione di Okta come IdP SAML: scheda Avanzate (Mappatura del dominio, Associazione SSO, Formato NameId)

Clicchi Avanti per aprire il Opzioni Login scheda. Le impostazioni nella tabella sottostante sono opzionale—modificali solo quando la tua configurazione lo richiede; altrimenti mantieni le impostazioni predefinite.

Abilita per l'accesso dell'utente finale	Consenti agli utenti finali di accedere con questo IdP utilizzando il Collegamento SSO.
Mostra IdP agli utenti	Abilita questa opzione se vuoi mostrare questo IDP a tutti gli utenti durante l'accesso
Richiesta di registrazione utente	Al primo accesso con questo IdP, chiedi all'utente di registrarsi su miniOrange se non esistono già.

Configurazione di Okta come IdP SAML: scheda Opzioni di accesso

Clicchi Salva per applicare la configurazione del provider di identità.

Torna alla console di amministrazione miniOrange (avresti dovuto tenerla aperta dal passaggio 1).

Inserire i seguenti valori.

Display Nome	Inserisci un nome appropriato (ad esempio Okta)
ID cliente	Copiato dagli step precedenti
Client Secret	Copiato dagli step precedenti
Endpoint di autorizzazione	https://{yourOktaDomain}.com/oauth2/default/v1/authorize
Endpoint token	https://{yourOktaDomain}.com/oauth2/default/v1/token
Endpoint informazioni utente (facoltativo)	https://{yourOktaDomain}/oauth2/default/v1/userinfo
Scopes	email del profilo openid

Selezionare OAuth per configurare Okta come IDP: Selezionare OAuth 2.0

Fare clic su Salva per applicare la configurazione.

3. Prova di connessione

Visita il tuo URL della pagina di accesso.
Vai su Provider di identità scheda.
Cerca la tua app, fai clic sui tre punti nel menu Azioni e seleziona Test di connessione rispetto all'Identity Provider (IDP) configurato.

Dopo aver immesso credenziali Okta valide (credenziali dell'utente assegnate all'app creata in Okta), verrà visualizzata una finestra pop-up, come mostrato nella schermata sottostante.

La configurazione di Okta come IDP in miniOrange è quindi completata con successo.

Nota:

Puoi seguire questa guida se desideri configurare SAML/WS-FED , OAuth/OIDC , JWT , Radius ecc.

Configurare la mappatura degli attributi

Vai su Provider di identità.
Fare clic sui tre punti nel menu Azioni e selezionare Mappatura degli attributi rispetto all'Identity Provider (IDP) configurato.

Okta Single Sign-On SSO Seleziona e configura la mappatura degli attributi

Tipo di attributo - UTENTE
Tipo di attributo - ESTERNO

Informazioni sulle mappe, come email e username, durante la creazione utente Just-In-Time (JIT). Gli attributi Email e Username sono necessari per creare il profilo utente.

Clicca sul + Aggiungi attributo pulsante per aggiungere i campi attributo.

Attributo USER della mappa SSO Single Sign-On di Okta

Controlla gli attributi nella finestra Test Connection del passaggio precedente. Scegli qualsiasi nome di attributo che vuoi inviare alla tua applicazione in Attribute Name sent to SP.
Immettere i valori degli attributi provenienti da IdP nel campo Nome attributo da IdP sul lato Xecurify.

Le mappature ESTERNE aiutano a modificare i nomi degli attributi in arrivo prima di inviarli alle app, garantendo che i dati siano nel formato corretto.

Clicca sul + Aggiungi attributo pulsante per aggiungere i campi attributo.

Attributo ESTERNO della mappa SSO Single Sign-On di Okta

Controlla gli attributi nella finestra di connessione di prova dall'ultimo passaggio. Inserisci i nomi degli attributi (qualsiasi nome) che vuoi inviare alla tua applicazione in Attribute Name sent to SP.
Immettere il valore degli attributi provenienti da IdP nel campo Nome attributo da IdP sul lato Xecurify.

Configurare più IDP:

Puoi seguire questa guida se desideri configurare più IDP (Identity Provider) e dare agli utenti la possibilità di selezionare l'IDP che preferiscono per l'autenticazione.

Troubleshooting

Questo messaggio di errore viene visualizzato quando si tenta di eseguire l'accesso SSO a un'applicazione configurata per utilizzare Okta come IdP esterno tramite Single Sign-On (SSO) basato su SAML o OAuth.

Problema riscontrato - Impossibile trovare la pagina

Se riscontri un problema di pagina non trovata durante l'esecuzione del test di connessione o SSO , puoi verificare l' URL ACS/Login di miniOrange in Okta.

Okta come IDP: la pagina non è stata trovata

Errore 404 - Pagina Non Trovata

Se riscontri un errore 404 Pagina non trovata durante il test di connessione o l'SSO , puoi verificare l' URL ACS/Login di Okta nell'app miniOrange.

Emissione di certificato non valido

Se riscontri un problema con un certificato non valido, puoi verificare il certificato x.509 inserito nell'app miniOrange confrontandolo con il certificato del tuo IdP (Okta).

Bloccato nel loop di accesso

Se dopo l'SSO rimani bloccato nel loop di accesso, conferma la mappatura degli attributi.

Segui i passaggi seguenti per lo stesso:

Vai su Provider di identità > Seleziona > Prova connessione.

Ora configura Mappatura degli attributi.

Vai su Provider di identità > Seleziona > Configura mappatura degli attributi.

Okta come IDP: configura il mapping degli attributi JIT

Mappa gli attributi che provengono dal tuo IdP sorgente. Nel tuo caso, Okta.

Errore 403 - App non assegnata

Se riscontri il problema 403 App non assegnata, significa che stai tentando di eseguire l'SSO per quell'utente che non è assegnato a quell'applicazione sul tuo lato Okta

Per risolvere questo problema, segui i passaggi sottostanti:

Vai al tuo Okta sito.
Accedere a Assegnazioni >> Assegna >> Assegna a persone.
Cerca l'utente che vuoi assegnare. Clicca su Assegna.
Clicca su Assegna and Torna indietro pulsante.
Fare clic su Fatto.
Assegnerà a quell'utente l'accesso a quell'applicazione.
Ora esegui l'SSO e il problema verrà risolto.

Contenuti