Configurare la registrazione client dinamica

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.

La registrazione dinamica del client (DCR) consente a un plug-in di registrare automaticamente un client OAuth con il provider di identità, senza richiedere la creazione manuale di un ID client e di un segreto in anticipo. Invece di registrare staticamente un'app OAuth e copiare le credenziali in una configurazione di autenticazione, il server di autorizzazione rilascia le credenziali client su richiesta in base a RFC 7591.

DCR si basa sul flusso del codice di autorizzazione OAuth 2.0. A differenza di OAuth statico, non è necessario configurare manualmente un URI di reindirizzamento o le credenziali client: l'archivio token Enterprise registra il client e gestisce i dettagli in background. Per concetti generali su OAuth, vedere Configurare l'autenticazione OAuth 2.0.

Nota

  • DCR è supportato per i plug-in MCP (Model Context Protocol).
  • DCR senza segreto client non è ancora supportato. Il server di autorizzazione deve rilasciare un segreto client durante la registrazione.
  • PKCE è abilitato per impostazione predefinita per DCR.

Avviso

DCR non è disponibile per un server MCP protetto da Microsoft Entra ID. Microsoft Entra ID non pubblica un endpoint di registrazione RFC 7591, quindi non c'è nulla per l'archivio token Enterprise contro cui registrare un client. Per un server protetto da Microsoft Entra ID, registrare invece il client OAuth in modo statico. Per altre informazioni, vedere Configurare l'autenticazione OAuth 2.0.

Configurare DCR in due passaggi: confermare i prerequisiti e creare la configurazione dell'autenticazione DCR.

Passaggio 1: Confermare i prerequisiti

  • Il server MCP espone i metadati delle risorse protetti OAuth 2.0 all'endpoint .well-known/oauth-protected-resource (RFC 9728), identificando il server di autorizzazione che lo protegge.
  • Il server di autorizzazione pubblica i propri metadati nell'endpoint (RFC 8414), incluso un registration_endpointe supporta la .well-known/oauth-authorization-server registrazione dinamica del client (RFC 7591) che rilascia un segreto client. Microsoft Entra ID non pubblica questo endpoint, quindi un server MCP protetto da Microsoft Entra ID non può usare DCR.

Passaggio 2: Creare la configurazione di autenticazione DCR

L'autenticazione DCR si basa su una configurazione di autenticazione (auth config), un record archiviato nell'archivio token Microsoft Enterprise usato da Microsoft 365 Copilot per ottenere e aggiornare i token per il plug-in MCP. Iniziare con WIQD per un progetto pro-code supportato; le procedure Toolkit e developer-skill rimangono disponibili come alternative.

Nota

Il portale per sviluppatori di Microsoft Teams non supporta ancora DCR. Utilizzare il flusso di lavoro dell'azione WIQD MCP o una delle alternative automatizzate seguenti.

Utilizzare wiqd agent add action con l'endpoint HTTPS del server all'interno --mcp-server-url e selezionare --mcp-auth-type oauth-dynamic. Il server e il provider di autorizzazione devono soddisfare i requisiti di metadati e segreti client descritti nel passaggio 1. DCR non è disponibile per un server protetto da Microsoft Entra ID.

Seguire le indicazioni del comando di azione WIQD MCP e completare il flusso di lavoro di provisioning del progetto. Il comando existing-manifest wiqd agent add auth non offre un tipo di autenticazione DCR. Per questo schema, usare la route di azione MCP.

Usare Microsoft 365 Agents Toolkit

Quando crei un agente con un plug-in MCP in Microsoft 365 Agents Toolkit e selezioni la registrazione dinamica del client come tipo di autenticazione, non sono necessari ulteriori input. Agents Toolkit recupera i dettagli di registrazione dall'endpoint noto del server MCP, registra automaticamente un nuovo client con il server di autorizzazione, crea la configurazione di autenticazione nell'archivio dei token Enterprise e aggiorna 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. Per DCR, la competenza registra il client, 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.

Manifesto del plug-in

Questa sezione mostra la configurazione del manifesto del plug-in risultante come riferimento. DCR utilizza lo stesso oggetto di autenticazione di runtime di OAuth 2.0: la type proprietà è impostata su OAuthPluginVault, ed reference_id è impostata sull'ID di configurazione dell'autenticazione.

"auth": {
  "type": "OAuthPluginVault",
  "reference_id": "auth config ID"
},