Esercitazione: Configurazione di Samanage per il provisioning utenti automaticoTutorial: Configuring Samanage for Automatic User Provisioning

Questa esercitazione descrive le procedure da eseguire in Samanage e Azure AD per effettuare automaticamente il provisioning e il deprovisioning degli account utente da Azure AD a Samanage.The objective of this tutorial is to show you the steps you need to perform in Samanage and Azure AD to automatically provision and de-provision user accounts from Azure AD to Samanage.

PrerequisitiPrerequisites

Per lo scenario descritto in questa esercitazione si presuppone che l'utente disponga di quanto segue:The scenario outlined in this tutorial assumes that you already have the following items:

  • Tenant di Azure Active DirectoryAn Azure Active directory tenant
  • Tenant di Samanage con il piano Professional o superiore abilitatoA Samanage tenant with the Professional plan or better enabled
  • Account utente in Samanage con autorizzazioni di amministratoreA user account in Samanage with Admin permissions

Nota

L'integrazione del provisioning di Azure AD è basata sull'API REST di Samanage disponibile per i team Samanage con piano Professional o superiore.The Azure AD provisioning integration relies on the Samanage REST API, which is available to Samanage teams on the Professional plan or better.

Assegnazione di utenti a SamanageAssigning users to Samanage

Per determinare gli utenti che dovranno ricevere l'accesso alle app selezionate, Azure Active Directory usa il concetto delle "assegnazioni".Azure Active Directory uses a concept called "assignments" to determine which users should receive access to selected apps. Nel contesto del provisioning automatico degli account utente vengono sincronizzati solo gli utenti e i gruppi che sono stati "assegnati" a un'applicazione in Azure AD.In the context of automatic user account provisioning, only the users and groups that have been "assigned" to an application in Azure AD is synchronized.

Prima di configurare e abilitare il servizio di provisioning, è necessario stabilire quali utenti e/o gruppi in Azure AD rappresentano gli utenti che devono accedere all'app Samanage.Before configuring and enabling the provisioning service, you need to decide what users and/or groups in Azure AD represent the users who need access to your Samanage app. Dopo averlo stabilito, è possibile assegnare gli utenti all'app Samanage seguendo le istruzioni riportate in:Once decided, you can assign these users to your Samanage app by following the instructions here:

Assegnare un utente o gruppo a un'app aziendaleAssign a user or group to an enterprise app

Suggerimenti importanti per l'assegnazione di utenti a SamanageImportant tips for assigning users to Samanage

  • È consigliabile assegnare un singolo utente di Azure AD a Samanage per testare la configurazione del provisioning.It is recommended that a single Azure AD user is assigned to Samanage to test the provisioning configuration. È possibile assegnare utenti e/o gruppi aggiuntivi in un secondo momento.Additional users and/or groups may be assigned later.

  • Quando si assegna un utente a Samanage, è necessario selezionare il ruolo Utente o un altro ruolo specifico dell'applicazione valido, se disponibile, nella finestra di dialogo di assegnazione.When assigning a user to Samanage, you must select either the User role, or another valid application-specific role (if available) in the assignment dialog. Poiché il ruolo Accesso predefinito non è applicabile per il provisioning, i relativi utenti vengono ignorati.The Default Access role does not work for provisioning, and these users are skipped.

Nota

Per praticità, il servizio di provisioning legge tutti i ruoli personalizzati definiti in Samanage e li importa in Azure AD dove è possibile selezionarli nella finestra di dialogo Seleziona ruolo.As an added feature, the provisioning service reads any custom roles defined in Samanage, and imports them into Azure AD where they can be selected in the Select Role dialog. Questi ruoli saranno visibili nel portale di Azure dopo l'abilitazione del servizio di provisioning e l'esecuzione di un ciclo di sincronizzazione.These roles will be visible in the Azure portal after the provisioning service is enabled and one synchronization cycle has completed.

Configurazione del provisioning utenti in SamanageConfiguring user provisioning to Samanage

Questa sezione illustra la connessione di Azure AD all'API per il provisioning degli account utente di Samanage e la configurazione del servizio di provisioning per la creazione, l'aggiornamento e la disabilitazione degli account utente assegnati in Samanage in base all'assegnazione di utenti e gruppi in Azure AD.This section guides you through connecting your Azure AD to Samanage's user account provisioning API, and configuring the provisioning service to create, update, and disable assigned user accounts in Samanage based on user and group assignment in Azure AD.

Suggerimento

Si può anche scegliere di abilitare l'accesso Single Sign-On basato su SAML per Samanage, seguendo le istruzioni disponibili nel portale di Azure.You may also choose to enabled SAML-based Single Sign-On for Samanage, following the instructions provided in Azure portal. L'accesso Single Sign-On può essere configurato indipendentemente dal provisioning automatico, nonostante queste due funzionalità siano complementari.Single sign-on can be configured independently of automatic provisioning, though these two features compliment each other.

Configurare il provisioning automatico degli account utente in Samanage in Azure AD:Configure automatic user account provisioning to Samanage in Azure AD:

  1. Nel portale di Azure passare alla sezione Azure Active Directory > App aziendali > Tutte le applicazioni.In the Azure portal, browse to the Azure Active Directory > Enterprise Apps > All applications section.

  2. Se Samanage è già stato configurato per l'accesso Single Sign-On, cercare l'istanza di Samanage usando il campo di ricerca.If you have already configured Samanage for single sign-on, search for your instance of Samanage using the search field. In caso contrario, selezionare Aggiungi e cercare Samanage nella raccolta di applicazioni.Otherwise, select Add and search for Samanage in the application gallery. Selezionare Samanage nei risultati della ricerca e aggiungerlo all'elenco delle applicazioni.Select Samanage from the search results, and add it to your list of applications.

  3. Selezionare l'istanza di Samanage e quindi la scheda Provisioning.Select your instance of Samanage, then select the Provisioning tab.

  4. Impostare Modalità di provisioning su Automatico.Set the Provisioning Mode to Automatic.

    Provisioning di Samanage

  5. Nella sezione Credenziali amministratore immettere nome utente e password dell'amministratore dell'account Samanage.Under the Admin Credentials section, input the Admin Username&Admin Password of your Samanage's account.

  6. Nel portale di Azure fare clic su Test connessione per verificare che Azure AD possa connettersi all'app Samanage.In the Azure portal, click Test Connection to ensure Azure AD can connect to your Samanage app. Se la connessione non riesce, verificare che l'account Samanage abbia autorizzazioni di amministratore e ripetere il passaggio 5.If the connection fails, ensure your Samanage account has Admin permissions and try step 5 again.

  7. Immettere l'indirizzo di posta elettronica di una persona o un gruppo che riceverà le notifiche di errore relative al provisioning nel campo Messaggio di posta elettronica di notifica e selezionare la casella di controllo "Invia una notifica di posta elettronica in caso di errore".Enter the email address of a person or group who should receive provisioning error notifications in the Notification Email field, and check the checkbox "Send an email notification when a failure occurs."

  8. Fare clic su Salva.Click Save.

  9. Nella sezione Mapping selezionare Synchronize Azure Active Directory Users to Samanage (Sincronizza utenti di Azure Active Directory in Samanage).Under the Mappings section, select Synchronize Azure Active Directory Users to Samanage.

  10. Nella sezione Mapping degli attributi esaminare gli attributi utente che vengono sincronizzati da Azure AD a Samanage.In the Attribute Mappings section, review the user attributes that are synchronized from Azure AD to Samanage. Gli attributi selezionati come proprietà corrispondenti vengono usati per trovare le corrispondenze con gli account utente in Samanage per le operazioni di aggiornamento.The attributes selected as Matching properties are used to match the user accounts in Samanage for update operations. Selezionare il pulsante Salva per eseguire il commit delle modifiche.Select the Save button to commit any changes.

  11. Per abilitare il servizio di provisioning di Azure AD per Samanage, impostare Stato del provisioning su nella sezione ImpostazioniTo enable the Azure AD provisioning service for Samanage, change the Provisioning Status to On in the Settings section

  12. Fare clic su Salva.Click Save.

L'operazione avvia la sincronizzazione iniziale di tutti gli utenti e/o i gruppi assegnati a Samanage nella sezione Utenti e gruppi.This operation starts the initial synchronization of any users and/or groups assigned to Samanage in the Users and Groups section. La sincronizzazione iniziale richiede più tempo delle sincronizzazioni successive, che saranno eseguite circa ogni 20 minuti per tutto il tempo che il servizio è in esecuzione.The initial sync takes longer to perform than subsequent syncs, which occur approximately every 20 minutes as long as the service is running. È possibile usare la sezione Dettagli sincronizzazione per monitorare lo stato di avanzamento e selezionare i collegamenti ai report delle attività di provisioning che descrivono tutte le azioni eseguite dal servizio di provisioning.You can use the Synchronization Details section to monitor progress and follow links to provisioning activity reports, which describe all actions performed by the provisioning service.

Per altre informazioni sulla lettura dei log di provisioning di Azure AD, vedere Esercitazione: creazione di report sul provisioning automatico degli account utente.For more information on how to read the Azure AD provisioning logs, see Reporting on automatic user account provisioning.

Risorse aggiuntiveAdditional resources

Passaggi successiviNext steps