Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Suggerimento
Consigliato: Inizia con Work IQ Dev Tools per scenari di agenti dichiarativi e plug-in pro-code supportati. Vedere la guida introduttiva di WIQD. Le istruzioni basate su toolkit rimangono disponibili per i progetti e i flussi di lavoro esistenti che le richiedono. Controlla il supporto per le funzionalità e l'esperienza di destinazione prima di scegliere uno strumento: WIQD non si rivolge agli agenti del motore personalizzato.
L'autenticazione Single Sign-On (SSO) di Microsoft Entra consente agli utenti di eseguire l'autenticazione con le credenziali di Microsoft Entra ID esistenti. Questa integrazione semplifica la gestione degli accessi e garantisce connessioni sicure ai server o alle API MCP (Model Context Protocol) senza richiedere credenziali aggiuntive. Il server MCP o l'API devono utilizzare Entra ID per controllare l'accesso.
Questo articolo utilizza i plug-in MCP come procedura predefinita per la procedura dettagliata. Gli stessi passaggi si applicano ai plug-in API compilati da un documento OpenAPI, tranne dove specificato.
Configurare l'autenticazione SSO di Entra in quattro passaggi: registrare un'app Entra per proteggere il server MCP, creare la configurazione di autenticazione, aggiornare la registrazione dell'app Entra e aggiungere il nuovo gruppo di destinatari del token all'API.
Passaggio 1: registra un'app Entra per proteggere il tuo server MCP
Il server MCP o l'API devono essere protetti da una registrazione dell'app Entra. Se non se ne ha già una, registrare un'app nell'Interfaccia di amministrazione di Microsoft Entra. Prendi nota dell'ID client dell'app, che viene fornito quando crei la configurazione dell'autenticazione nel passaggio 2.
Passaggio 2: Creare la configurazione di autenticazione SSO Entra
L'autenticazione SSO di Entra si basa su una configurazione di autenticazione (auth config), un record archiviato nell'archivio token Microsoft Enterprise usato da Microsoft 365 Copilot per ottenere token per il plug-in MCP. Iniziare con WIQD per un progetto pro-code supportato. Le procedure Toolkit, Competenze per sviluppatori e Portale per sviluppatori di Teams rimangono disponibili come alternative.
Comunque la si crei, la configurazione di autenticazione ha un ID di configurazione di autenticazione e un URI dell'ID applicazione. Usare l'URI dell'ID applicazione nei passaggi 3 e 4.
Importante
Indipendentemente da come si crea la configurazione dell'autenticazione, è comunque necessario completare i passaggi 3 e 4.
Usa gli strumenti di sviluppo di Work IQ (scelta consigliata)
Per un'azione MCP, utilizzare wiqd agent add action con --mcp-server-url, --mcp-auth-type entra-sso, e --mcp-client-id impostare sull'ID client dell'app Entra dal passaggio 1. Per un'azione OpenAPI, usa --openapi-auth-identity-provider microsoft-entra e --openapi-auth-client-id. Per le altre opzioni di azione necessarie, vedere la Guida al comando Comando azione DQIT.
Per un manifesto di plug-in esistente, utilizzare wiqd agent add auth con --plugin-manifest, --auth-namee --auth-type microsoft-entra. Fornisci le opzioni del provider di identità documentate per quel comando, tra cui --oauth-client-id. Completa il flusso di lavoro di provisioning del progetto, ottieni l'URI dell'ID applicazione della configurazione di autenticazione e continua con i passaggi 3 e 4.
Usare Microsoft 365 Agents Toolkit
Quando crei un agente con un plug-in MCP in Microsoft 365 Agents Toolkit, il toolkit richiede un tipo di autenticazione quando aggiungi il plug-in del server MCP. Selezionare Microsoft Entra SSO e specificare l'ID client dell'app Entra dal passaggio 1. Agents Toolkit crea la configurazione di autenticazione nell'archivio dei token Enterprise, genera l'ID di configurazione di autenticazione e aggiorna automaticamente l'oggetto di autenticazione di runtime nel manifesto del plug-in.
Usare la competenza per lo sviluppo dell'agente dichiarativo
La declarative agent developer skill (declarative-agent-developer) è una skill dell'agente in Microsoft Work IQ che racchiude le conoscenze necessarie per creare agenti dichiarativi. Invece di eseguire comandi o modificare i manifesti manualmente, descrivi cosa vuoi Copilot o l'interfaccia della riga di comando di GitHub in linguaggio naturale. L'abilità esegue lo scaffolding dell'agente dichiarativo, aggiunge il plug-in MCP e gestisce automaticamente la configurazione dell'autenticazione. La skill supporta solo plug-in MCP. Quando aggiungi un server MCP che utilizza Entra SSO, la skill crea la configurazione di autenticazione nell'archivio token Enterprise e aggiorna il manifesto del plug-in senza passaggi manuali.
Suggerimento
Per una procedura dettagliata sull'utilizzo della competenza per gli sviluppatori di agenti dichiarativi, vedere Creare agenti dichiarativi con la competenza per gli sviluppatori di agenti dichiarativi.
Usare il portale per sviluppatori di Teams
La registrazione al portale per sviluppatori di Teams è facoltativa se si usa Agents Toolkit o la competenza per sviluppatori di agenti dichiarativi. Usalo quando vuoi creare manualmente la configurazione di autenticazione o, più comunemente, per gestire una configurazione di autenticazione già creata da Agents Toolkit o dalla skill. Nel portale è possibile limitare la configurazione dell'autenticazione a un'app di Teams specifica o a un'organizzazione di Microsoft 365 e modificare altre proprietà.
Aprire il portale per sviluppatori di Teams. Seleziona Strumenti ->Registrazione ID client Microsoft Entra SSO.
Se non sono presenti registrazioni esistenti, selezionare Registra ID cliente. Se sono presenti registrazioni esistenti, selezionare Registrazione nuovo cliente.
Compila i seguenti campi.
- Nome di registrazione: un nome descrittivo per la registrazione.
-
URL di base: URL di base dell'API. Questo valore deve corrispondere all'URL
urlnella proprietà dell'oggetto spec del server MCP nel manifesto del plug-in per i plug-in basati su MCP o a una voce nell'arrayserversnel documento OpenAPI per i plug-in API. - Limitare l'utilizzo per organizzazione: selezionare l'organizzazione di Microsoft 365 che ha accesso all'app per accedere agli endpoint dell'API.
- Limitare l'utilizzo in base all'app: se non si conosce l'ID app finale, selezionare un'app di Teams . Dopo aver pubblicato l'app, associa questa registrazione all'ID app pubblicato.
- ID client: ID client dell'app registrata in Entra.
- Ambito: le autorizzazioni richieste dal plug-in a Entra. Come per OAuth 2.0, usa i valori di ambito richiesti dall'app e dall'API Entra.
Selezionare Salva.
Il completamento della registrazione crea la configurazione di autenticazione e genera un ID di configurazione di autenticazione (attualmente denominato ID di registrazione SSO di Microsoft Entra nel portale per sviluppatori di Teams) e un URI ID applicazione.
Aggiungere l'ID di configurazione dell'autenticazione al manifesto del plug-in
Quando si crea manualmente la configurazione dell'autenticazione nel portale per sviluppatori di Teams, impostare la type proprietà dell'oggetto di autenticazione di runtime su OAuthPluginVaulte quindi reference_id sull'ID di configurazione dell'autenticazione. Agents Toolkit e la capacità di sviluppatore agente dichiarativo fanno tutto questo per te.
"auth": {
"type": "OAuthPluginVault",
"reference_id": "auth config ID"
},
Passaggio 3: Aggiornare la registrazione dell'app Entra
Indipendentemente da come hai creato la configurazione di autenticazione nel passaggio 2, completa i passaggi seguenti.
Apri l'Interfaccia di amministrazione di Microsoft Entra. Aggiornare la registrazione dell'app Entra che protegge il server MCP o l'API con l'URI ID applicazione dalla registrazione SSO. Se un URI dell'ID dell'applicazione esistente è mappato alla registrazione dell'app, usare l'editor del manifesto per aggiungere un altro URI nella sezione identifierUris .
"identifierUris": [ "<<URI1>>", "<<URI2>>" ]Nota
Non è possibile aggiungere più URI tramite l'interfaccia utente dell'interfaccia di amministrazione di Entra. L'interfaccia utente visualizza solo il primo URI dell'elenco. L'aggiunta di più URI non influisce sugli URI e sugli ambiti esistenti, anche se vengono visualizzati in modo diverso nell'interfaccia utente.
Selezionare Autenticazione in Gestisci. Aggiungere
https://teams.microsoft.com/api/platform/v1.0/oAuthConsentRedirectagli URI di reindirizzamento nella piattaforma Web .Selezionare Esponi un'API in Gestisci. Selezionare Aggiungi un'applicazione client e aggiungere l'ID client dell'archivio token di Microsoft Enterprise.
ab3be6b7-f5df-413d-ac2d-abf1e3fd9c0b
Passaggio 4: aggiungere i nuovi destinatari del token all'API
Aggiorna il server o l'API MCP per consentire il nuovo identificatore URI come destinatari del token. Se il server o l'API MCP convalida l'ID dell'applicazione client, assicurarsi che l'ID client dell'archivio token Microsoft Enterprise (ab3be6b7-f5df-413d-ac2d-abf1e3fd9c0b) venga aggiunto come applicazione client consentita.
Suggerimento
Se il server o l'API MCP utilizza il flusso per conto di per ottenere l'accesso a un'altra API Web che richiede all'utente di concedere il consenso, restituisce un 401 Unauthorized errore per indurre l'agente a richiedere all'utente di accedere per concedere il consenso.