Argomento
Questo articolo spiega come configurare SCIM (System for Cross-domain Identity Management) con l'applicazione SAML (Security Assertion Markup Language) 2.0 personalizzata di Okta.
Si consiglia di configurare Single Sign-on (SSO) e SCIM utilizzando l'applicazione NinjaOne Okta Integration Network, poiché semplifica notevolmente il processo di configurazione. Utilizzare le seguenti risorse per le istruzioni di configurazione. Se la propria organizzazione richiede configurazioni di identità avanzate non supportate dal modello OIN, questo articolo fornisce i passaggi di configurazione SCIM utilizzando l'app SAML 2.0 personalizzata di Okta.
- Sistema per la gestione delle identità tra domini (SCIM) con Okta
- Configurazione di NinjaOne SAML in Okta
Ambiente
- Gestione degli accessi e delle identità (IAM) NinjaOne
- Integrazioni NinjaOne: Okta
Descrizione
L'integrazione di Okta con NinjaOne tramite SCIM consente di creare, eliminare e fornire automaticamente tecnici e utenti finali all'interno di NinjaOne. Questo articolo funge da punto di partenza per la configurazione SCIM con NinjaOne. La configurazione dipende dalla configurazione specifica di Okta, pertanto si consiglia di consultare la sezione Risorse aggiuntive per trovare i processi correlati.
Per ulteriori dettagli sui concetti alla base della gestione del ciclo di vita con SCIM e Okta, consultare Informazioni su SCIM | Okta Developer (link esterno).
Seleziona una categoria per saperne di più:
- Prerequisiti
- Configurare SCIM in Okta con un'applicazione SAML 2.0 personalizzata
- Configurare la mappatura da gruppo a ruolo in NinjaOne
- Risorse aggiuntive
Prerequisiti
Prima di poter fornire account utente tramite SCIM, è necessario creare l'IDP e abilitare l'SSO. A tal fine, fare riferimento a Configurazione di NinjaOne SAML in Okta.
Configurare SCIM in Okta con un'applicazione SAML 2.0 personalizzata
Per configurare SCIM con l'applicazione SAML 2.0 personalizzata di Okta, procedere come segue:
- Accedere al proprio account Okta come amministratore.
- Nel riquadro di navigazione, espandere il menu a discesa Applicazioni e selezionare Applicazioni.
- Selezionare l'applicazione NinjaOne.

- Aprire la scheda Generale e selezionare SCIM nella sezione Provisioning .

- Fare clic su Salva.
- Aprire la scheda Provisioning e selezionare Modifica. Fare clic su Configura integrazione API.
- In una scheda separata del browser, accedi alla console NinjaOne come amministratore di sistema.
- Passa a Amministrazione → Account → Fornitori di identità e seleziona la voce Okta.
- Fare clic su Modifica nel widget Sistema per la gestione delle identità tra domini.

- Nella finestra modale Configura SCIM, fai clic sull'interruttore per abilitare il provisioning SCIM.
- Fai clic su Genera token.

- Fai clic sull'icona a forma di foglio per copiare il token segreto SCIM e anche l'URL dell'endpoint API SCIM. Torna alla console di amministrazione Okta.

- Dalla posizione precedente nella console di amministrazione Okta (applicazione NinjaOne), incolla l'URL dell'endpoint API SCIM da NinjaOne nell'URL di base del connettore SCIM. Seleziona la casella di controllo Abilita integrazione API, quindi incolla il token segreto SCIM da NinjaOne.
- Imposta il campo Identificatore univoco per gli utenti su un attributo utente Okta che contiene il valore di un indirizzo e-mail. Gli attributi comuni includono userName ( nome utente Okta) e email ( e-mail principale). Per ulteriori informazioni, consulta Profili utente | Okta Developer (link esterno).
- Selezionare le caselle di controllo per le seguenti azioni di provisioning supportate:
- Invia nuovi utenti
- Invia aggiornamenti profilo
- Invia gruppi
- Imposta la modalità di autenticazione su HTTP Header.

- Aprire la scheda Provisioning per trovare le nuove impostazioni disponibili per la configurazione.
- Aprire la scheda To App (All'app) e fare clic su Edit(Modifica).
- Selezionare le caselle di controllo per le seguenti opzioni di provisioning:
- Crea utenti
- Aggiorna attributi utente
- Disattiva utenti

- Scorri fino alla sezione Mappature attributi e fai clic su Vai all'editor del profilo.
-
Se si desidera assegnare gli utenti finali a organizzazioni specifiche, selezionare Aggiungi attributo e quindi configurare i seguenti campi:
Campo attributo Valore Tipo di dati "Stringa" Nome visualizzato Inserisci un identificatore univoco Nome esterno "organizationId" Spazio dei nomi esterno "urn:ietf:params:scim:schemas:extension:ninjaone:2.0:User" Tipo di attributo "Gruppo" (consigliato)

- Se si intende creare account tecnici NinjaOne, è necessario prima rimuovere la mappatura ed eliminare l'attributo di tipo utente predefinito. Fare riferimento ai seguenti passaggi per le istruzioni.
-
Nell'Editor profili, fai clic su Mappature e imposta l'attributo
userTypesu Non mappare. Ripeti questo passaggio nelle schede NinjaOne SCIM a Utente Okta e Utente Okta a NinjaOne SCIM. Al termine, salva le mappature.
Figura 9: Mappature dei profili utente nella configurazione SCIM - Individuare l'attributo Tipo utente nell'elenco Attributi ed eliminare la voce. Attendere alcuni minuti affinché la modifica abbia effetto.
-

- Fare clic su Aggiungi attributo, quindi utilizzare la tabella seguente per configurare i campi applicabili:
| Campo attributo | Valore |
|---|---|
| Tipo di dati | "Stringa" |
| Nome visualizzato | Inserisci un identificatore univoco |
| Nome esterno | "userType" |
| Spazio dei nomi esterno | "urn:ietf:params:scim:schemas:extension:ninjaone:2.0:User" |
| Tipo di attributo | "Gruppo" (consigliato) |
- Torna alla sezione Provisioning dell'applicazione SCIM NinjaOne. Nella sezione To App , rimuovi tutte le mappature dalla sezione Attribute Mappings tranne le seguenti:
| Attributo | Valore |
|---|---|
| userName | Okta imposta automaticamente questo campo |
| nome | "user.firstname" |
| familyName | "user.lastName" |
| organiztionId (facoltativo) | Selezionare un valore qualsiasi |
| tipoUtente | Seleziona un valore qualsiasi |
Crea account tecnico NinjaOne
Quando si creano account tecnico, è necessario assegnare un valore univoco all'attributo userType . In caso contrario, verrà creato un account utente finale.
L'attributo userType ha due valori accettati:
- Impostare l'attributo su "technician" per creare un account tecnico.
- Impostare l'attributo su "endUser" (distinguere tra maiuscole e minuscole) per creare un account utente finale.
Per mappare l'attributo userType , procedere come segue:
- Fare clic sull'icona a forma di matita per modificare i campi.
- Fare riferimento alla tabella seguente come guida per configurare un valore di attributo che soddisfi le esigenze della propria organizzazione:
| Valore dell'attributo | Definizione o scopo |
|---|---|
| Stesso valore per tutti gli utenti | Assegna tutti gli utenti dello stesso tipo all'app NinjaOne Okta. |
| Mappa dal profilo Okta | Crea un account utente finale o tecnico in base al valore dell'attributo del profilo selezionato. |
| Espressione | Crea un utente finale o un tecnico in base al risultato della tua espressione Okta personalizzata. Per ulteriori informazioni, consulta la guida panoramica sul linguaggio di espressione Okta | Okta Developer (link esterno). |

- Selezionare Crea e aggiorna per il campo Applica su .
- Si consiglia di inserire più utenti di prova nel campo Anteprima per verificare che la mappatura degli attributi produca il risultato desiderato.
- Fare clic su Salva.
Assegnare gli utenti finali a un'organizzazione NinjaOne
Se si assegnano account di utenti finali a una specifica organizzazione NinjaOne o a più organizzazioni NinjaOne, è necessario assegnare un valore all'attributo organizationID. Gli account privi di un valore di attributo accettato verranno automaticamente creati come utenti finali globali.
L'attributo organizationID ha due valori accettati:
- Impostare l'attributo su "all" per creare un utente finale globale.
- Imposta l'attributo su "<ID della tua organizzazione>" per assegnare un utente all'organizzazione NinjaOne corrispondente.
Se hai bisogno di aiuto per trovare l'ID organizzazione in NinjaOne, consulta Piattaforma NinjaOne: come trovare un ID organizzazione.
Per mappare l'attributo dell'organizzazione, procedi come segue:
- Fare clic sull'icona a forma di matita per modificare i campi.
- Fai riferimento alla tabella seguente come guida per configurare un valore di attributo che soddisfi le esigenze della tua organizzazione:
| Valore dell'attributo | Definizione o scopo |
|---|---|
| Stesso valore per tutti gli utenti | Assegna tutti gli utenti dello stesso tipo all'app NinjaOne Okta. |
| Mappa dal profilo Okta | Crea un account utente finale o tecnico in base al valore dell'attributo del profilo selezionato. |
| Espressione | Crea un utente finale o un tecnico in base al risultato dell'espressione Okta personalizzata. Per ulteriori informazioni, consulta la guida panoramica sul linguaggio di espressione Okta | Okta Developer (link esterno). |
- Seleziona Crea e aggiorna per il campo Applica su.
- Si consiglia di inserire più utenti di prova nel campo Anteprima per verificare che la mappatura degli attributi produca il risultato desiderato.
- Fare clic su Salva.

Assegnare utenti per il provisioning SCIM
Per assegnare utenti per il provisioning SCIM, procedi come segue:
- Torna alla pagina di configurazione dell'applicazione NinjaOne in Okta e apri la scheda Assegnazioni .
- Fare clic su Assegna e selezionare l'opzione applicabile alle proprie esigenze. Durante l'assegnazione, sarà possibile sovrascrivere le mappature degli attributi e impostare il tipo di utente e l'ID dell'organizzazione. Se si sta assegnando un gruppo, questa modifica avrà effetto su tutti i membri del gruppo.
Il processo di provisioning SCIM avrà inizio.

Configurare la mappatura da gruppo a ruolo in NinjaOne
Facoltativamente, puoi utilizzare la mappatura dei gruppi in Okta per assegnare automaticamente i membri dei gruppi Okta ai ruoli in NinjaOne. A tal fine, procedi come segue.
- In Okta, apri la scheda Push Groups nell'applicazione Ninja SSO e SCIM . Fai clic su Push Groups per impostare i gruppi di destinazione.
- Impostare l'azione su Crea gruppo e salvare. Il completamento di questa azione può richiedere fino a un'ora.

- Accedere a NinjaOne come amministratore di sistema.
- Passa a Amministrazione → Account → Fornitore di identità.
- Seleziona Okta OIN IDP.
- Accanto a Mappatura gruppi, fai clic su Modifica.
- Seleziona i ruoli dal menu a discesa da associare ai gruppi sincronizzati con Okta, se applicabile. Il menu includerà sia i ruoli degli utenti finali che quelli dei tecnici. Il Tipo di utente assegnato all'utente in Okta determina quali ruoli assegnare a ciascun utente. Se devi creare nuovi ruoli, consulta Ruoli e autorizzazioni degli utenti per le istruzioni.
Risorse aggiuntive
Fai riferimento alle seguenti risorse per ulteriori informazioni sulle opzioni SCIM e SAML con NinjaOne e Okta: