Configura il provisioning automatico degli utenti con profili SCIM personalizzati (beta)

Il provisioning automatico degli utenti con profili SCIM personalizzati è una funzionalità beta disponibile solo per un numero limitato di partecipanti. Se non vedi Provisioning automatico nella pagina dei dettagli dell'app, significa che non è ancora disponibile per la tua organizzazione.

Puoi configurare e gestire automaticamente gli account utente in un'app SAML personalizzata o preintegrata che supporta SCIM 2.0 utilizzando il provisioning automatico degli utenti con profili SCIM personalizzati.

Prima di iniziare

Per configurare un profilo SCIM personalizzato, devi disporre di:

• Un account Cloud Identity con un ruolo di super amministratore. Per maggiori dettagli, vai a Ruoli amministrativi predefiniti.
• Un'app SAML personalizzata o preintegrata configurata e attivata per gli utenti nella Console di amministrazione

La tua app deve avere un server SCIM che:

• Supporta SCIM versione 2.0
• Utilizza metodi HTTP standard, tra cui POST, GET, PATCH con fallback a PUT e DELETE
• Supporta l'autenticazione con token di connessione. L'autenticazione tramite token OAuth non è supportata.

Configura il provisioning automatico degli utenti con un profilo SCIM personalizzato

1. Nella Console di amministrazione Google, vai a Menu App App web e mobile.

   Vai ad App web e mobile

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

2. Fai clic sul nome della tua app SAML.
3. In Provisioning automatico, fai clic su Configura il provisioning automatico.
4. Inserisci il token di connessione della tua app in Token di accesso, quindi fai clic su Continua.
5. Inserisci l'URL dell'endpoint SCIM della tua app nel campo Endpoint URL (URL endpoint), quindi fai clic su Continue (Continua). Google si connette al tuo endpoint SCIM per rilevare automaticamente gli attributi supportati.
6. Mappa gli attributi della directory Google agli attributi dell'app corrispondenti. Se la tua app supporta il rilevamento dello schema, la tabella viene precompilata con gli attributi rilevati. Per mappare manualmente gli attributi personalizzati, fai clic su Aggiungi mappatura Continua quando hai finito.
7. (Facoltativo) Se non aggiungi gruppi, viene eseguito il provisioning di tutti gli utenti con accesso all'app SAML. Per limitare il provisioning automatico a gruppi specifici di utenti:
   • In Search groups (Gruppi di ricerca), inserisci una o più lettere del nome del gruppo, seleziona il nome e scegli un ambito.
   • Aggiungi eventuali altri gruppi.
   • (Facoltativo) Per rimuovere un gruppo, fai clic su Rimuovi.
     Se un gruppo comprende utenti che appartengono a un dominio secondario o sono esterni all'organizzazione, questi non saranno sottoposti a provisioning.
8. Stabilisci per quanto tempo gli utenti possono accedere all'app dopo che l'app è stata disattivata per loro o il loro account Google Workspace è stato sospeso o eliminato. Puoi scegliere di sospendere l'account, eliminarlo definitivamente o sospenderlo ed eliminarlo definitivamente. Puoi impostare il periodo di tempo del ritardo singolarmente per ogni azione.
   1. Scegli le opzioni per ciascuno di questi eventi, se necessario:
      • Quando un'app viene disattivata per un utente
      • Quando un utente è sospeso su Google
      • Quando un utente viene eliminato da Google
        Se sospendi un account utente, questo viene contrassegnato come disattivato. Se elimini definitivamente l'account utente, questo viene rimosso definitivamente dall'app. Imposta sempre un periodo di tempo maggiore prima dell'eliminazione definitiva dell'account di un utente. Per maggiori dettagli sulla sospensione e sull'eliminazione, vai a Modifica i periodi di tempo per il deprovisioning.
   2. Fai clic su Continua.

9. Testa la connessione:

   1. In Utente della directory Google, cerca e seleziona un utente che non ha un account nella tua app.

   2. Fai clic su Test.
      

      Google crea un account per l'utente nella tua app, lo aggiorna e poi lo elimina. Ogni operazione mostra Riuscita, Non riuscita o Non eseguita. Per un'operazione non riuscita, esamina il codice HTTP, il tipo di errore SCIM e i dettagli di Visualizza risposta non elaborata della tua app.
      

      Nota: se l'app non restituisce 201 Created per il nuovo utente, ad esempio perché l'utente esiste già, l'operazione Crea utente non va a buon fine e Google salta le operazioni di aggiornamento ed eliminazione. Se l'operazione Elimina utente non va a buon fine, elimina manualmente l'account di test nella tua app.

10. Fai clic su Fine.
    Puoi fare clic su Fine anche se il test non è riuscito e riprovare in un secondo momento. Questo passaggio salva la configurazione, ma non attiva il provisioning automatico. Per attivarla, vai alla pagina dei dettagli dell'app Provisioning automatico e imposta l'opzione su Attivo.
    Nota: l'impostazione è disattivata se l'app non è attiva per alcun utente. Fai clic su Accesso utenti e attiva l'app per abilitare l'attivazione del provisioning automatico.

Modificare le informazioni di provisioning

Disattivare il provisioning automatico ed eliminare le informazioni di configurazione

Puoi disattivare il provisioning automatico per l'app senza perdere le informazioni di configurazione. In alternativa, puoi disattivare il provisioning automatico e rimuovere tutte le informazioni di configurazione.

Esaminare le informazioni sull'utilizzo

• Dopo aver attivato il provisioning automatico, puoi esaminare le informazioni sull'utilizzo. Per maggiori dettagli, vai a Monitorare il provisioning automatico degli utenti.
• Puoi esaminare le seguenti informazioni sull'utilizzo relative agli ultimi 30 giorni:

Evento dei log amministrativi	Descrizione
Creazione utente mediante provisioning automatico	Utenti creati mediante provisioning automatico
Aggiornamento utente di cui è stato eseguito il provisioning automatico	Utenti aggiornati mediante provisioning automatico
Sospensione utente di cui è stato eseguito il provisioning automatico	Utenti sospesi mediante provisioning automatico
Annullamento sospensione utente di cui è stato eseguito il provisioning automatico	Utenti riattivati mediante provisioning automatico
Eliminazione definitiva utente di cui è stato eseguito il provisioning automatico	Utenti eliminati mediante provisioning automatico
Errori	Richieste non riuscite

Se il provisioning automatico non funziona più

Il provisioning automatico smette di funzionare se Google non riesce più a connettersi alla tua app. Ad esempio, il token di connessione potrebbe essere scaduto o essere stato revocato oppure l'URL SCIM dell'app potrebbe essere cambiato. Per risolvere il problema, aggiorna il token o l'URL:

1. Nella Console di amministrazione Google, vai a Menu App App web e mobile.

   Vai ad App web e mobile

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

2. Fai clic sul nome della tua app SAML.
3. Fai clic su Autoprovisioning (Provisioning automatico).
4. Per aggiornare il token di connessione:
   1. In App authorization (Autorizzazione app), fai clic su Reauthorize (Autorizza di nuovo).
   2. In Token di accesso, incolla un nuovo token di connessione dalla tua app.
   3. Fai clic su Autorizza di nuovo.
5. Per aggiornare l'URL di base SCIM, fai clic su Modifica in URL endpoint, inserisci il nuovo URL e poi fai clic su Aggiorna.
6. (Facoltativo) Per verificare la connessione, fai clic su Test in Test connessione.

Per informazioni dettagliate su altri motivi per cui il provisioning automatico potrebbe smettere di funzionare, consulta la documentazione dell'app.