Condividi tramite


Configurare Preciate per il provisioning automatico degli utenti

Questo articolo descrive i passaggi da eseguire sia in Preciate che in Microsoft Entra ID per configurare il provisioning automatico degli utenti. Se configurato, Microsoft Entra ID effettua automaticamente il provisioning e il deprovisioning di utenti e gruppi per Preciate usando il servizio di provisioning Di Microsoft Entra. Per informazioni dettagliate sulle caratteristiche e sul funzionamento di questo servizio e per le domande frequenti, consultare la sezione Automatizzare il provisioning e il deprovisioning degli utenti nelle applicazioni SaaS con Microsoft Entra ID.

Capacità supportate

  • Creare utenti in Preciate
  • Rimuovere gli utenti in Preciate quando non richiedono più l'accesso
  • Mantenere sincronizzati gli attributi utente tra Microsoft Entra ID e Preciate

Prerequisiti

Lo scenario descritto in questo articolo presuppone che siano già disponibili i prerequisiti seguenti:

  • Un tenant di Preciate.
  • Un account utente in Preciate con permessi di amministratore.

Passaggio 1: Pianificare la distribuzione dell'approvvigionamento

  1. Scopri come funziona il servizio di provisioning.
  2. Determinare chi sarà incluso nell'ambito di per la fornitura di.
  3. Determinare quali dati mappare tra Microsoft Entra ID e Preciate.

Passaggio 2: Configurare Preciate per supportare il provisioning con Microsoft Entra ID

  1. Accedere al Portale Admin di Preciate e passare alla pagina delle Integrazioni.

    segreto preliminare

  2. Selezionare il pulsante Genera in cui è indicato Active Directory Integration Secret Key (Chiave privata di integrazione di Active Directory).

    Preciate generare

  3. Verrà visualizzata una nuova chiave segreta. Copiare e salvare la chiave privata . Tieni presente che l'URL del tenant è https://preciate.com/api/v1/scim. Questi valori verranno immessi nel campo token segreto e URL tenant nella scheda di provisioning dell'applicazione Preciate.

Nota

Ogni volta che si fa clic sul pulsante Genera viene creata una nuova chiave privata. Ciò invaliderà immediatamente quello corrente. Se un'integrazione usa già attivamente la chiave corrente, la generazione di quella nuova causerà l'interruzione del funzionamento dell'integrazione fino a quando il token segreto non viene aggiornato nell'applicazione Preciate nel portale di Azure.

Aggiungere Preciate dalla raccolta di applicazioni di Microsoft Entra per iniziare a gestire il provisioning in Preciate. Se in precedenza è stato configurato Preciate per l'accesso SSO, è possibile usare la stessa applicazione. Tuttavia, è consigliabile creare un'app separata durante il test iniziale dell'integrazione. Per ulteriori informazioni su come aggiungere un'applicazione dalla raccolta .

Passaggio 4: Definire chi rientra nel provisioning

Il servizio di provisioning di Microsoft Entra consente di delimitare chi viene fornito in base all'assegnazione all'applicazione o in base agli attributi degli utenti o dei gruppi. Se si sceglie di definire l'ambito dell'app in base all'assegnazione, è possibile utilizzare i passaggi per assegnare utenti e gruppi all'applicazione. Se si sceglie di definire l'ambito di cui è stato effettuato il provisioning in base esclusivamente agli attributi dell'utente o del gruppo, è possibile usare un filtro di ambito.

  • Iniziare con pochi elementi. Eseguire il test con un piccolo insieme di utenti e gruppi prima di distribuirlo a tutti. Quando l'ambito per il provisioning è impostato su utenti e gruppi assegnati, è possibile controllarlo assegnando uno o due utenti o gruppi all'app. Quando l'ambito è impostato su tutti gli utenti e i gruppi, è possibile specificare un filtro di ambito basato su attributo .

  • Se sono necessari ruoli aggiuntivi, è possibile aggiornare il manifesto dell'applicazione per aggiungere nuovi ruoli.

Passaggio 5: Configurare il provisioning automatico degli utenti su Preciate

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

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

  1. Accedi al Microsoft Entra admin center come almeno un amministratore di applicazioni cloud.

  2. Passare a Identità>Applicazioni>Applicazioni aziendali

    Pannello delle applicazioni aziendali

  3. Nell'elenco delle applicazioni selezionare Preciate.

    Collegamento preciato nell'elenco delle applicazioni

  4. Selezionare la scheda Provisioning.

    scheda Configurazione

  5. Impostare modalità di provisionamento su Automatico.

    scheda di provisioning automatica

  6. Nella sezione Credenziali Amministratore, immettere l'URL del Preciate Tenant e il Token Segreto. Fare clic su Test connessione per assicurarsi che Microsoft Entra ID possa connettersi a Preciate. Se la connessione non riesce, verificare che l'account Preciate disponga delle autorizzazioni di amministratore e riprovare.

    Token

  7. Nel campo Messaggio di posta elettronica di notifica, immettere l'indirizzo email di una persona o di un gruppo che deve ricevere le notifiche di errore di provisioning e selezionare la casella di controllo Invia una notifica tramite email quando si verifica un errore.

    Messaggio e-mail di notifica

  8. Seleziona Salva.

  9. Nella sezione dei Mapping, selezionare Sincronizza gli utenti di Microsoft Entra su Preciate.

  10. Esaminare gli attributi utente sincronizzati da Microsoft Entra ID su Preciate nella sezione mappatura degli attributi. Gli attributi selezionati come proprietà di corrispondenza vengono usati per abbinare gli account utente in Preciate per le operazioni di aggiornamento. Se si sceglie di modificare l'attributo di destinazione corrispondente , è necessario assicurarsi che l'API Preciate supporti il filtro degli utenti in base a tale attributo. Selezionare il pulsante Salva per confermare le modifiche.

    Attributo TIPO Supportato per il filtraggio
    nome utente Stringa
    attivo Booleano
    nome visualizzato Stringa
    titolo Stringa
    nome.nomeDato Stringa
    nome.cognome Stringa
    nome.formattato Stringa
    Id esterno Stringa
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:dipartimento Stringa
  11. Per configurare i filtri di ambito, vedere le istruzioni seguenti fornite nell'articolo Filtro di ambito.

  12. Per abilitare il servizio di provisioning di Microsoft Entra per Preciate, modificare lo stato del provisioning in Attivo nella sezione Impostazioni.

    Stato di configurazione modificato su

  13. Definire gli utenti e/o i gruppi di cui si vuole eseguire il provisioning in Preciate scegliendo i valori desiderati in Ambito nella sezione impostazioni .

    ambito di approvvigionamento

  14. Quando si è pronti per configurare, fare clic su Salva.

    Salvataggio della configurazione del provisioning

Questa operazione avvia il ciclo di sincronizzazione iniziale di tutti gli utenti e i gruppi definiti in ambito nella sezione Impostazioni. Il ciclo iniziale richiede più tempo rispetto ai cicli successivi, che si verificano approssimativamente ogni 40 minuti, purché il servizio di provisioning di Microsoft Entra sia in esecuzione.

Passaggio 6: Monitorare la distribuzione

Dopo aver configurato il provisioning, usare le risorse seguenti per monitorare la distribuzione:

  1. Usare i log di provisioning per determinare gli utenti di cui è stato eseguito il provisioning correttamente o in modo non riuscito
  2. Controlla la barra di progresso per visualizzare lo stato del ciclo di provisioning e quanto manca al completamento.
  3. Se la configurazione del provisioning sembra essere in uno stato problematico, l'applicazione va in quarantena. Ulteriori informazioni sugli stati di quarantena sono disponibili nell'articolo sulla condizione di quarantena del provisioning dell'applicazione.

Risorse aggiuntive