Condividi tramite

Esercitazione: Configurare Bonusly per il provisioning utenti automatico

  • Articolo

Questa esercitazione descrive i passaggi da eseguire in Bonusly e Microsoft Entra ID per configurare Microsoft Entra ID per effettuare automaticamente il provisioning e il deprovisioning di utenti e/o gruppi in Bonusly.

Nota

Questa esercitazione descrive un connettore basato sul servizio di provisioning utenti di Microsoft Entra. Per informazioni dettagliate sulle caratteristiche e sul funzionamento di questo servizio e per le domande frequenti, vedere Automatizzare il provisioning e il deprovisioning utenti in applicazioni SaaS con Microsoft Entra ID.

Prerequisiti

Per lo scenario descritto in questa esercitazione si presuppone che l'utente disponga di quanto segue:

  • Un tenant di Microsoft Entra
  • Un tenant Bonusly
  • Un account utente in Bonusly con autorizzazioni di amministratore

Nota

L'integrazione del provisioning di Microsoft Entra si basa sull'API REST Bonusly, disponibile per gli sviluppatori Bonusly.

Prima di configurare Bonusly per il provisioning utenti automatico con Microsoft Entra ID, è necessario aggiungere Bonusly dalla raccolta di applicazioni Microsoft Entra all'elenco di applicazioni SaaS gestite.

Per aggiungere Bonusly dalla raccolta di applicazioni Microsoft Entra, seguire questa procedura:

  1. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.

  2. Passare a Identità>Applicazioni>Applicazioni aziendali>Nuova applicazione.

  3. Nella casella di ricerca digitare Bonusly, selezionare Bonusly nel pannello dei risultati e quindi fare clic sul pulsante Aggiungi per aggiungere l'applicazione.

    Bonusly nell'elenco risultati

Assegnazione di utenti a Bonusly

Per determinare quali utenti avranno l'accesso alle app selezionate, Microsoft Entra ID usa il concetto delle cosiddette “assegnazioni”. Nel contesto del provisioning utenti automatico, vengono sincronizzati solo gli utenti e/o i gruppi "assegnati" a un'applicazione in Microsoft Entra ID.

Prima di configurare e abilitare il provisioning utenti automatico, è necessario decidere quali utenti e/o gruppi in Microsoft Entra ID devono accedere a Bonusly. Dopo aver definito questo aspetto, è possibile assegnare gli utenti e/o i gruppi a Bonusly seguendo le istruzioni riportate di seguito:

Suggerimenti importanti per l'assegnazione di utenti a Bonusly

  • È consigliabile assegnare un singolo utente di Microsoft Entra a Bonusly per testare la configurazione del provisioning utenti automatico. È possibile assegnare utenti e/o gruppi aggiuntivi in un secondo momento.

  • Quando si assegna un utente a Bonusly, è necessario selezionare qualsiasi ruolo specifico dell'applicazione valido, se disponibile, nella finestra di dialogo di assegnazione. Gli utenti con il ruolo Accesso predefinito vengono esclusi dal provisioning.

Configurazione del provisioning utenti automatico in Bonusly

Questa sezione illustra la procedura per configurare il servizio di provisioning di Microsoft Entra per creare, aggiornare e disabilitare utenti e/o gruppi in Bonusly in base alle assegnazioni di utenti e/o gruppi in Microsoft Entra ID.

Suggerimento

È anche possibile scegliere di abilitare l'accesso Single Sign-On basato su SAML per Bonusly, seguendo le istruzioni contenute nell'esercitazione sull'accesso Single Sign-On per Bonusly. L'accesso Single Sign-On può essere configurato indipendentemente dal provisioning utenti automatico, anche se queste due funzionalità sono complementari.

Per configurare il provisioning utenti automatico per Bonusly in Microsoft Entra ID:

  1. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.

  2. Passare a Applicazioni di identità>Applicazioni>aziendali>Bonusly.

    Pannello delle applicazioni aziendali

  3. Nell'elenco delle applicazioni selezionare Bonusly.

    Collegamento di Bonusly nell'elenco delle applicazioni

  4. Selezionare la scheda Provisioning.

    Screenshot della scheda Bonusly - Provisioning. In Gestisci il provisioning è evidenziato.

  5. Impostare Modalità di provisioning su Automatico.

    Screenshot che mostra una casella di riepilogo Modalità di provisioning con l'opzione Automatica selezionata ed evidenziata.

  6. Nella sezione Credenziali amministratore immettere il Token segreto del proprio account Bonusly come descritto nel passaggio 6.

    Screenshot della sezione Credenziali amministratore. La casella Token segreto è vuota, ma la casella è evidenziata.

  7. Il token segreto per l'account Bonusly si trova in Integrazioni aziendali > di amministrazione>. Nella sezione Se si vuole scrivere codice , fare clic su API > Create New API Access Token (Crea nuovo token di accesso API) per creare un nuovo token segreto.

    Screenshot del menu Bonusly. In Admin (Amministratore) l'opzione Company (Società) è evidenziata. In Società è evidenziata l'opzione Integrazioni.

    Screenshot della sezione If you want to code of the Bonusly site, with A P I evidenziata.

    Screenshot del sito Bonusly. La scheda Servizi è aperta. In Token di accesso A P I è evidenziato l'opzione Create new A P I access token (Crea nuovo token di accesso P I).

  8. Nella schermata successiva digitare un nome per il token di accesso nell'apposita casella di testo, quindi premere Crea chiave API. Il nuovo token di accesso verrà visualizzato per pochi secondi in un elemento a comparsa.

    Screenshot della pagina Nuovo token di accesso del sito Bonusly. Una casella senza etichetta contiene Il mio token e il pulsante Crea un tasto P I è evidenziato.

    Screenshot del sito Bonusly. Una notifica è visibile che visualizza Il nuovo token di accesso creato, seguito da un token indecifrabile.

  9. Dopo aver popolato i campi visualizzati nel passaggio 5, fare clic su Test connessione per assicurarsi che Microsoft Entra ID possa connettersi a Bonusly. Se la connessione non riesce, verificare che l'account Bonusly abbia autorizzazioni di amministratore e riprovare.

    Screenshot della sezione Credenziali amministratore. Il pulsante Connessione testo è evidenziato.

  10. Nel campo Messaggio di posta elettronica di notifica immettere l'indirizzo di posta elettronica di una persona o un gruppo che riceverà le notifiche di errore relative al provisioning e selezionare la casella di controllo Invia una notifica di posta elettronica in caso di errore.

    Screenshot che mostra una casella di posta elettronica di notifica vuota. Un'opzione è visibile con l'etichetta Invia una notifica di posta elettronica quando si verifica un errore.

  11. Fare clic su Salva.

  12. Nella sezione Mapping selezionare Synchronize Microsoft Entra users to Bonusly (Sincronizza utenti di Microsoft Entra in Bonusly).

  13. Esaminare gli attributi utente sincronizzati da Microsoft Entra ID a Bonusly nella sezione Mapping attributi . Gli attributi selezionati come proprietà corrispondenti vengono usati per trovare le corrispondenze con gli account utente in Bonusly per le operazioni di aggiornamento. Selezionare il pulsante Salva per eseguire il commit delle modifiche.

    Screenshot della pagina Mapping attributi. Una tabella elenca gli attributi di Microsoft Entra, gli attributi Bonusly corrispondenti e lo stato di corrispondenza.

  14. Per configurare i filtri di ambito, fare riferimento alle istruzioni fornite nell'esercitazione sui filtri per la definizione dell'ambito.

  15. Per abilitare il servizio di provisioning Di Microsoft Entra per Bonusly, impostare Stato del provisioning su Sì nella sezione Impostazioni .

    Screenshot della sezione Impostazioni. L'interruttore Stato provisioning è impostato su Disattivato.

  16. Definire gli utenti e/o i gruppi di cui si vuole eseguire il provisioning in Bonusly selezionando i valori desiderati in Ambito nella sezione Impostazioni.

    Screenshot che mostra la casella di riepilogo Ambito. La casella Sincronizza solo gli utenti e i gruppi assegnati è selezionata.

  17. Quando si è pronti per eseguire il provisioning, fare clic su Salva.

    Ritaglio di schermata del salvataggio della configurazione del provisioning.

L'operazione avvia la sincronizzazione iniziale di tutti gli utenti e/o i gruppi definiti in Ambito nella sezione Impostazioni. La sincronizzazione iniziale richiede più tempo delle sincronizzazioni successive, che saranno eseguite circa ogni 40 minuti quando il servizio di provisioning di Microsoft Entra è in esecuzione. È possibile usare la sezione Dettagli sincronizzazione per monitorare lo stato di avanzamento e seguire i collegamenti al report delle attività di provisioning, che descrive tutte le azioni eseguite dal servizio di provisioning Di Microsoft Entra in Bonusly.

.Per altre informazioni sulla lettura dei log di provisioning di Microsoft Entra, vedere Creazione di report sul provisioning automatico degli account utente.

Risorse aggiuntive

Passaggi successivi