OEE IntelliSuite · guida dell’amministratore

Connettere Microsoft Entra ID

Registrare un’applicazione Microsoft per il broker di accesso della suite, associare i gruppi Entra ai ruoli della suite e verificare l’accesso a Pulse ed Explorer.

Prima di iniziare

Questa guida è rivolta a un amministratore Azure / Entra e alla persona che gestisce la distribuzione della suite. L’autenticazione e il broker di accesso condiviso della suite devono essere abilitati. Recuperare l’origine HTTPS pubblica del broker della distribuzione, ad esempio https://auth.plant.example.com, e coordinare le modifiche alla configurazione con l’operatore della suite.

Il broker riceve una sola volta l’accesso Microsoft e condivide la sessione con le applicazioni configurate della suite. Explorer è un client OIDC separato del broker e non richiede una seconda registrazione Microsoft. Il broker, le origini delle app e l’origine di Explorer devono rientrare nel dominio cookie configurato; il routing edge deve indirizzare il nome host del broker a Pulse. La configurazione di distribuzione della suite deve usare un unico segreto di autenticazione condiviso tra le app abilitate.

Solo esempi. Sostituire tutti i nomi host e gli UUID riportati di seguito con i valori del tenant e della distribuzione. Non inserire mai un segreto client reale in un ticket, uno screenshot o nel controllo del codice sorgente.

1 · Registrare l’applicazione

  1. Nel Centro di amministrazione Microsoft Entra → Registrazioni app → Nuova registrazione, registrare un’applicazione web nel tenant a cui appartengono gli utenti. Selezionare Solo account in questa directory dell’organizzazione (tenant singolo). Annotare l’ID applicazione (client) e ID directory (tenant). Istruzioni di registrazione Microsoft
  2. In Autenticazione, aggiungere un URI di reindirizzamento alla piattaforma Web, usando esattamente l’origine pubblica del broker:
    https://auth.plant.example.com/api/auth/callback/microsoft
    
    L’origine deve corrispondere alla distribuzione, inclusa l’eventuale porta. Aggiungere un URI esatto distinto per ogni ambiente che usa questa registrazione; preferire registrazioni e credenziali separate per ciascun ambiente. Regole Microsoft per gli URI di reindirizzamento
  3. In Certificati e segreti → Segreti client, creare un segreto e acquisirne immediatamente il valore nel vault dei segreti approvato. Fornirlo in modo sicuro all’operatore della suite e registrare la scadenza e il responsabile della rotazione. Il provider Microsoft attuale della suite accetta un ID client e un segreto client; una credenziale con certificato Entra non è un sostituto diretto per questa configurazione. Istruzioni Microsoft per le credenziali
  4. Applicare i criteri del tenant relativi a consenso, guest, MFA e Accesso condizionale. Una registrazione a tenant singolo può includere gli ospiti ammessi nel tenant. Eseguire test con gli account e i criteri previsti; la sola registrazione dell’app non concede l’accesso alla suite a tutti gli utenti.

2 · Configurare gruppi e ruoli

Creare o scegliere gruppi di sicurezza Entra per i ruoli della suite e annotare l’ID oggetto, non il nome visualizzato. Nella registrazione dell’app, configurare le attestazioni dei gruppi in modo che il token ID contenga un array groups con gli ID oggetto dei gruppi Entra. Ad esempio, scegliere Gruppi di sicurezza nella configurazione delle attestazioni dei gruppi; non emettere i gruppi come ruoli e non sostituirli con nomi, SID o attributi locali. Verificare il token risultante per un utente di test. Configurazione Microsoft delle attestazioni dei gruppi

Ruolo della suite Accesso tipico
viewer Accesso in sola lettura a dispositivi, lavori e report.
employee Accesso di base, inclusa la registrazione dei lavori.
supervisor Gestione del team e delle operazioni, report ed esportazioni.
admin Amministrazione completa della suite, inclusi utenti e impostazioni di sistema.

Questi sono ruoli della suite. L’integrazione attuale associa gli ID dei gruppi nella configurazione della suite; non legge l’attestazione Entra roles. Definire ruoli app Entra o assegnare un gruppo a un ruolo app Entra non concede da solo il ruolo corrispondente della suite. Il percorso supportato è: appartenenza al gruppo → token ID groups → associazione nella suite. Riferimento Microsoft ai ruoli app

Mantenere completa l’attestazione. Microsoft omette l’array groups quando viene superato il limite di gruppi del JWT (200 gruppi); la suite non risolve il superamento tramite Graph e rifiuterà l’accesso. Se si limita l’attestazione a Gruppi assegnati all’applicazione, è necessario assegnare i gruppi associati all’applicazione aziendale e fare in modo che gli utenti ne siano membri diretti: in questa modalità le appartenenze annidate non sono incluse. L’assegnazione dei gruppi richiede la licenza Entra appropriata (P1/P2). Dettagli Microsoft su assegnazione e licenze

3 · Configurare la suite

Fornire all’operatore della suite l’ID tenant, l’ID client, il segreto tramite un canale approvato e l’associazione ID oggetto del gruppo → ruolo. Nella configurazione client della distribuzione, questi valori vanno nelle env-vars di Pulse del broker. La configurazione del broker è gestita dalla distribuzione; non creare manualmente il valore derivato AUTH_BROKER_JSON.

MICROSOFT_TENANT_ID=<tenant-uuid>
MICROSOFT_CLIENT_ID=<application-client-id>
MICROSOFT_CLIENT_SECRET=<secret-value>
AUTH_MICROSOFT_GROUP_ROLES_JSON={"aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa":"viewer","bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb":"admin"}

La mappa deve essere un oggetto JSON non vuoto con UUID di gruppo distinti e nomi di ruolo esatti in minuscolo. L’impostazione tenant deve essere l’UUID dello stesso tenant singolo. L’associazione è facoltativa: se AUTH_MICROSOFT_GROUP_ROLES_JSON è assente, il comportamento di accesso Microsoft esistente rimane invariato e non si applica il rifiuto dei gruppi non associati descritto qui. L’operatore applica la configurazione con la normale procedura di distribuzione e poi verifica il broker.

Appartenenze multiple: prevale il ruolo associato più alto, in questo ordine: viewer → employee → supervisor → admin. Verificare le appartenenze sovrapposte prima di concedere l’accesso.

4 · Concedere e verificare l’accesso

  1. Aggiungere ogni utente previsto a un gruppo di sicurezza associato. Se l’applicazione aziendale richiede un’assegnazione, assegnare anche l’utente o il gruppo idoneo. L’assegnazione all’applicazione aziendale e la mappa gruppo-ruolo della suite sono verifiche separate.
  2. Aprire la pagina di accesso della suite e selezionare Continue with Microsoft. Autenticarsi con l’account tenant e soddisfare eventuali richieste di MFA o consenso del tenant. È possibile creare una nuova identità Microsoft associata al primo accesso anche se è impostato AUTH_DISABLE_SIGN_UP=true.
  3. Verificare il ruolo e l’accesso previsto dell’utente in Pulse, quindi aprire Explorer da Pulse e verificare il dashboard e l’accesso desiderati. Un utente senza gruppi associati, con attestazione di gruppo mancante o malformata, proveniente da un tenant esterno o con una risposta di overflow viene rifiutato anziché ricevere un ruolo predefinito.
  4. Testare un utente non associato, un utente appartenente a gruppi sovrapposti e sia utenti esistenti sia nuovi. Per collegare un account locale esistente non ancora collegato, il ruolo attuale della suite deve già corrispondere a quello associato. Il collegamento tramite email in un tenant singolo si affida all’identità e ai controlli di ammissione degli ospiti del tenant; verificarne l’adeguatezza prima di farvi affidamento.
Dashboard Pulse del laboratorio SSO dopo l’accesso con un account Microsoft
Laboratorio SSO: Pulse dopo l’accesso Microsoft. In una verifica separata dell’associazione gruppi-ruoli sono state provate le mappature admin, supervisor e viewer e gli utenti non associati sono stati rifiutati; questa immagine mostra la destinazione dopo l’accesso, non l’attestazione del ruolo.

Per l’esperienza di accesso dell’utente finale, consultare la Guida Microsoft all’accesso singolo.

Operazioni e risoluzione dei problemi

  • Modifica o rimozione del ruolo: la suite aggiorna il ruolo di un utente Microsoft collegato al successivo accesso Microsoft. Se il ruolo cambia o l’utente non è più associato al momento dell’accesso, le sessioni del database vengono rimosse; le cache delle sessioni firmate possono restare valide fino alla scadenza. Ciò non garantisce una revoca immediata avviata dalla directory. Quando necessario per urgenza, usare i controlli di accesso agli incidenti e le procedure di revoca delle sessioni.
  • Accesso rifiutato: controllare l’assegnazione al tenant e all’applicazione aziendale, l’appartenenza dell’utente, gli ID oggetto associati esatti e le attestazioni tid, oid e groups del token ID. Verificare l’eventuale overflow dei gruppi e se il filtro dei gruppi assegnati richiede l’appartenenza diretta. Trattare i token come informazioni sensibili e non incollarli nei ticket di assistenza.
  • Errore di reindirizzamento: confrontare carattere per carattere l’URI di reindirizzamento Web registrato con l’origine pubblica e il percorso di callback del broker; verificare il routing HTTPS e gli ID client e tenant configurati.
  • L’account esistente non viene collegato: confrontare il ruolo associato con quello esistente nella suite e con l’email dell’account. Se Microsoft non restituisce l’email, il broker può usare preferred_username come nome di accesso non verificato. Verificare la titolarità dell’account con l’amministratore della suite prima di modificare un ruolo o collegare identità.
  • Rotazione delle credenziali: creare un nuovo segreto client, aggiornare la configurazione sicura di distribuzione della suite, applicarla e verificare l’accesso prima di rimuovere il vecchio segreto. Tenere traccia della scadenza e non esporne il valore nei log.

Riferimenti

Pagine Microsoft Learn consultate il 9 novembre 2026. I dettagli del prodotto riflettono il broker della suite e l’implementazione di gruppi e ruoli; il laboratorio SSO ha verificato esempi associati e non associati il 6 novembre 2026.