Concedere diritti amministrativi agli amministratori IA per gestire i connettori

I connettori di Microsoft 365 Copilot consentono alle organizzazioni di creare integrazioni personalizzate per migliorare i sistemi e i servizi di intelligenza artificiale. Gli amministratori di intelligenza artificiale possono gestire i connettori Copilot, ma la registrazione dell'applicazione e il consenso alle autorizzazioni dell'applicazione Microsoft Graph possono richiedere privilegi aggiuntivi. Questo articolo descrive come delegare tali privilegi per i connettori sincronizzati personalizzati usando un ruolo personalizzato Microsoft Entra e criteri di consenso per le app.

Nota

La delega dei diritti amministrativi agli amministratori IA è un passaggio facoltativo per la gestione dei connettori Copilot.

Prerequisiti

  • Licenze Microsoft Entra ID P1 o P2 per i ruoli personalizzati. Vedere Creare un ruolo personalizzato in Microsoft Entra ID.
  • Un amministratore dei ruoli con privilegi per creare i criteri di consenso dell'app, creare il ruolo personalizzato e assegnarlo agli utenti.
  • Utenti di destinazione che necessitano dei privilegi aggiuntivi e delle autorizzazioni dell'applicazione Microsoft Graph richieste dai relativi connettori.
  • Per la procedura automatizzata, PowerShell 5.1 o versione successiva e accesso a PowerShell Gallery. Lo script installa e importa i moduli di PowerShell necessari di Microsoft Graph.

Quali diritti amministrativi possono essere delegati?

Per consentire agli amministratori IA di gestire in modo indipendente la configurazione e il funzionamento dei connettori personalizzati, delegare i diritti amministrativi seguenti:

  • Autorizzazione di registrazione dell'applicazione: la concessione di questa autorizzazione consente agli amministratori IA di registrare le applicazioni dall'interfaccia di amministrazione di Microsoft Entra per configurare connettori personalizzati. Le autorizzazioni di registrazione dell'applicazione sono abilitate per impostazione predefinita per tutti gli utenti di un'organizzazione. Concedere questa autorizzazione solo se l'autorizzazione è disabilitata per l'organizzazione.

  • Privilegi di consenso - Concedere questo privilegio per consentire agli amministratori IA di concedere il consenso dell'amministratore a livello di tenant per le autorizzazioni selezionate dell'applicazione Microsoft Graph, ad esempio ExternalItem.ReadWrite.OwnedBy e ExternalConnection.ReadWrite.OwnedBy, per la creazione di connessioni e l'inserimento di elementi. Il criterio controlla quali autorizzazioni possono essere approvate. Tali autorizzazioni non vengono concesse automaticamente a un'applicazione connettore.

Concedere le autorizzazioni per la registrazione dell'applicazione

Se le autorizzazioni di registrazione dell'applicazione sono abilitate per tutti gli utenti all'interno dell'organizzazione, non è necessaria alcuna configurazione aggiuntiva. Se la registrazione è limitata, seguire Delega autorizzazioni di registrazione app in Microsoft Entra ID per concedere agli utenti necessari l'autorizzazione per registrare le applicazioni. Per una procedura di personalizzazione dei ruoli, vedere Creare un ruolo personalizzato con le autorizzazioni per creare registrazioni di app.

L'autorizzazione di registrazione dell'applicazione e l'autorizzazione di consenso dell'amministratore sono distinte. Concederne uno non concede l'altro.

Usare questa procedura manuale quando è necessario impostare criteri limitati alle autorizzazioni richieste dai connettori, anziché al set di autorizzazioni completo configurato dallo script.

  1. Selezionare le autorizzazioni per l'applicazione necessarie nel riferimento alle autorizzazioni di Microsoft Graph. Per un connettore che crea connessioni e inserisce elementi, iniziare con ExternalConnection.ReadWrite.OwnedBy and ExternalItem.ReadWrite.OwnedBy. Non includere autorizzazioni più ampie a meno che il connettore non le richieda.

  2. Seguire Creare criteri di consenso per le app personalizzati con PowerShell. Configurare le condizioni di inclusione per lo scenario del connettore, anziché copiare le condizioni di autorizzazione delegata dell'esempio:

    • Impostato PermissionType su application.
    • Impostato ResourceApplication sull'ID applicazione Microsoft Graph, 00000003-0000-0000-c000-000000000000.
    • Impostare Permissions gli ID di autorizzazione dell'applicazione selezionati. ID per ExternalConnection.ReadWrite.OwnedBy e ExternalItem.ReadWrite.OwnedBy sono f431331c-49a6-499f-be1c-62af19c34a9d e 8116ae0f-55c2-452d-9944-d18420f5b2c8, rispettivamente.
    • Aggiungere le restrizioni delle applicazioni client ed escludere le condizioni in base alle esigenze dell'organizzazione.
  3. Seguire la procedura di PowerShell in Creare un ruolo personalizzato. Includere microsoft.directory/servicePrincipals/managePermissionGrantsForAll.{id} nel ruolo , sostituendo {id} con l'ID allowedResourceActionsdei criteri. Vedere Autorizzazioni di consenso delle app per i ruoli personalizzati.

  4. Segui Assegna ruoli di Microsoft Entra agli utenti per assegnare il ruolo personalizzato agli amministratori IA previsti nell'ambito della directory. Questo ambito abilita il consenso dell'amministratore a livello di tenant, in base alle condizioni del criterio.

  5. Completare Confermare i risultati con un'applicazione di test prima di utilizzare la delega per i connettori di produzione.

Nota

L'interfaccia di amministrazione di Microsoft Entra non supporta l'aggiunta di autorizzazioni di consenso delle app a una definizione di ruolo personalizzata. Usare Microsoft Graph PowerShell per creare il ruolo di consenso. È quindi possibile gestire le assegnazioni degli utenti nell'interfaccia di amministrazione.

Usare PowerShell per concedere diritti amministrativi

La GrantAppConsentAndManagementPermissionToAiAdmin funzione in Connector.Cmd 2.3 automatizza la creazione di criteri e l'assegnazione di ruoli. L'ambito seguente si basa sull'origine della funzione pubblicata. Rivedi la fonte prima di utilizzare una versione diversa.

Autorizzazioni configurate dallo script

Per impostazione predefinita, lo script crea o riutilizza i criteri Grant-Consent-Permissions-To-AIAdminsdi consenso dell'app. Aggiunge includere le condizioni per le seguenti sei autorizzazioni dell'applicazione Microsoft Graph, non le autorizzazioni delegate o un set di autorizzazioni con caratteri jolly:

Autorizzazione dell'applicazione Accedere all'intelligenza artificiale che l'amministratore può approvare per un'app
ExternalConnection.ReadWrite.OwnedBy Creare connessioni e connessioni in lettura o scrittura a cui l'app è autorizzata ad accedere.
ExternalItem.ReadWrite.OwnedBy Leggere o scrivere elementi nelle connessioni a cui l'app è autorizzata ad accedere.
ExternalConnection.Read.All Leggere tutte le connessioni esterne.
ExternalConnection.ReadWrite.All Leggere e scrivere tutte le connessioni esterne.
ExternalItem.Read.All Leggere tutti gli elementi esterni.
ExternalItem.ReadWrite.All Leggere o scrivere elementi in tutti i set di dati esterni a cui l'app è autorizzata ad accedere.

Per le definizioni complete, vedere le informazioni di riferimento sulle autorizzazioni di Microsoft Graph.

Lo script crea il ruolo Gestione connettori personalizzati per Copilot con queste azioni:

  • microsoft.directory/applications/create: crea registrazioni dell'applicazione.
  • microsoft.directory/applications/permissions/update: aggiorna le autorizzazioni API richieste dalle registrazioni delle applicazioni.
  • microsoft.directory/servicePrincipals/managePermissionGrantsForAll.Grant-Consent-Permissions-To-AIAdmins: concede il consenso dell'amministratore a livello di tenant in base ai criteri. Se si specifica un diverso PolicyName, l'azione userà invece tale ID criterio.

Lo script assegna il ruolo nell'ambito della directory (/), non nell'ambito di un'applicazione o di una connessione. Elenca le attuali assegnazioni dei ruoli di amministratore IA e risolve le entità utente. Non espande l'appartenenza al gruppo né assegna il ruolo personalizzato agli utenti che hanno solo un'assegnazione di ruolo idonea e inattiva.

Importante

Questa delega è più ampia dell'autorizzazione ad approvare solo le due .OwnedBy autorizzazioni. Consente inoltre il consenso alle autorizzazioni nella tabella e le azioni di gestione delle applicazioni si applicano all'ambito .All della directory. Se tale ambito supera i requisiti, usare Concedi privilegi di consenso per creare un criterio più restrittivo.

Se esiste già un criterio con lo stesso ID, lo script aggiunge condizioni di inclusione mancanti senza rimuovere quelle esistenti. Se è presente un ruolo personalizzato con lo stesso nome visualizzato, lo script lo riutilizza senza aggiornarne la definizione. Esaminare i criteri e i ruoli esistenti prima di eseguire lo script. Le loro autorizzazioni effettive possono essere diverse da una nuova configurazione.

Eseguire lo script

  1. Installare e importare la versione descritta in questo articolo in una nuova sessione di PowerShell.

    Install-Module -Name Connector.Cmd -RequiredVersion 2.3 -Scope CurrentUser
    Import-Module -Name Connector.Cmd -RequiredVersion 2.3
    
  2. Usare il comando seguente per richiamare lo script.

    GrantAppConsentAndManagementPermissionToAiAdmin
    
  3. Alla richiesta di accesso, confermare che si desidera procedere e accedere come amministratore del ruolo privilegiato. Lo script richiede le autorizzazioni RoleManagement.ReadWrite.Directorydelegate di Microsoft Graph , Policy.ReadWrite.PermissionGrante User.Read.All. Queste autorizzazioni consentono alla sessione di installazione di gestire ruoli e criteri e leggere gli utenti; Non sono autorizzazioni del connettore concesse a un'app dai criteri personalizzati.

  4. Esaminare gli utenti visualizzati e le autorizzazioni. Continuare solo se entrambe corrispondono alla delega che si intende approvare.

  5. Esaminare il riepilogo del completamento e gli eventuali errori di assegnazione, quindi completare Conferma risultati.

Lo script delega la possibilità di concedere il consenso. Un amministratore di intelligenza artificiale deve comunque esaminare e concedere il consenso alle autorizzazioni necessarie per ogni applicazione di connessione.

Conferma i risultati

In primo luogo, in qualità di amministratore che ha configurato la delega, verificare le condizioni di inclusione ed esclusione dei criteri, le azioni del ruolo personalizzato e le relative assegnazioni utente. Vedere Elencare i criteri di consenso delle app esistenti e Assegnare ruoli di Microsoft Entra agli utenti.

Usare quindi un'applicazione di test e un account amministratore IA con il ruolo personalizzato, ma senza un altro ruolo che conceda in modo indipendente il consenso dell'amministratore:

Nota

Il test seguente usa le due .OwnedBy autorizzazioni dell'applicazione. Non verifica tutte le autorizzazioni incluse nello script. L'esecuzione di query sulle connessioni in Graph Explorer usa un'autorizzazione delegata separata; ExternalConnection.Read.Alli criteri di autorizzazione dell'applicazione dello script non includono tale autorizzazione delegata. Vedere Trovare l'ID del connettore eseguendo una query sui connettori in Graph Explorer.

  1. Accedi all'interfaccia di amministrazione di Microsoft Entra come amministratore IA.
  2. Vai alleregistrazioni dell'appEntra ID> e crea un'applicazione di prova.
  3. Nelle autorizzazioni API dell'applicazione, selezionare Aggiungi un'autorizzazione>Autorizzazioni applicazioneMicrosoft Graph>. Aggiungere ExternalItem.ReadWrite.OwnedBy e ExternalConnection.ReadWrite.OwnedBy se entrambi sono inclusi nei criteri.
  4. Selezionare Concedi consenso amministratore per il tenant e verificare che le autorizzazioni vengano visualizzate come concesse.

Registrare l'ID criterio, l'ID ruolo, gli utenti assegnati, il set di autorizzazioni approvato e i risultati dei test. L'esito positivo del test conferma la delega per le autorizzazioni verificate. Non verifica l'inserimento del connettore o tutte le autorizzazioni nel criterio.

Domande frequenti

No. Per un nuovo criterio, la versione 2.3 consente agli amministratori IA assegnati di concedere il consenso alle sei autorizzazioni dell'applicazione elencate in Autorizzazioni configurate dallo script. Un amministratore di intelligenza artificiale deve comunque esaminare e concedere il consenso separatamente per ogni applicazione del connettore. Il criterio non include automaticamente tutte le autorizzazioni correnti o future con un ExternalItem prefisso OR ExternalConnection o gli equivalenti delegati. Le .All autorizzazioni sono più ampie delle due .OwnedBy autorizzazioni, quindi verifica se tutte e sei sono appropriate per la tua organizzazione.

Cosa succede se l'applicazione connettore richiede autorizzazioni esterne al criterio?

Un amministratore autorizzato ad acconsentire a tali autorizzazioni deve esaminare la richiesta. Non ampliare i criteri solo per aggirare un errore di consenso. Se l'organizzazione approva l'estensione della delega:

  1. Aggiornare le condizioni di inclusione dei criteri con il tipo di autorizzazione, l'API delle risorse e gli ID di autorizzazione specifici, seguendo Gestisci criteri di consenso delle app.
  2. Se si crea un criterio diverso, aggiornare l'azione di consenso del ruolo personalizzato in modo che faccia riferimento al relativo ID. Le modifiche a un criterio esistente si applicano ai ruoli che già vi fanno riferimento.
  3. Esaminare le assegnazioni di ruolo interessate e ripetere il test di consenso per le autorizzazioni approvate.

Come posso revocare i privilegi concessi agli amministratori IA?

Per rimuovere i privilegi delegati da un utente, rimuovere l'assegnazione di ruolo personalizzata in Ruoli ID Entra>& amministratori nell'interfaccia di amministrazione di Microsoft Entra. Eliminare il ruolo personalizzato solo se nessun utente deve conservarlo. Vedere Assegnare e rimuovere assegnazioni di ruolo.

La rimozione dell'assegnazione di ruolo non revoca le autorizzazioni già concesse per le applicazioni del connettore. Esaminare e, se necessario, revocare separatamente le concessioni di autorizzazione esistenti delle applicazioni .

Screenshot della pagina Ruoli & amministratori nell'interfaccia di amministrazione di Microsoft Entra

I privilegi si applicano automaticamente agli amministratori IA appena assegnati?

No. Lo script assegna un ruolo personalizzato separato agli utenti trovati in fase di esecuzione. Per i nuovi amministratori IA, esaminare gli utenti e le autorizzazioni previsti prima di eseguire nuovamente lo script o assegnare manualmente il ruolo personalizzato. La rimozione del ruolo di amministratore IA di un utente non rimuove nemmeno l'assegnazione di ruolo personalizzata separata; Rivedere e rimuovere l'assegnazione quando la delega non è più necessaria.

Screenshot della pagina Assegnazioni nell'interfaccia di amministrazione di Microsoft Entra

È obbligatorio concedere questi privilegi agli amministratori di intelligenza artificiale?

No, la concessione di questi privilegi è facoltativa. Le organizzazioni possono scegliere se delegare le autorizzazioni in base ai propri processi interni. Se si preferisce il controllo centralizzato, gli amministratori globali possono mantenere la responsabilità di tali attività.