Connector consent in Copilot Studio uitzetten

Gebruikt je agent een connector voor het eerst namens een gebruiker, dan verschijnt er een consent card in het gesprek: de gebruiker moet eerst akkoord geven. Sinds kort kun je die connector consent per agent uitzetten via de Power Platform API. Handig voor agents die niemand voor zich hebben zitten, maar je haalt er wel een bewuste goedkeuringsstap mee weg. Hieronder lees je hoe je het inricht, en net zo belangrijk: wanneer je het beter laat staan.
Kort gezegd doe je drie dingen: je registreert eenmalig een app in Microsoft Entra ID, je laadt een PowerShell-script van Microsoft, en je zet met één commando per agent de waarde AdminConsentBypass op True. Na deze handleiding kun je die stand lezen, aanzetten, controleren en weer terugdraaien.
Wat is een connector consent card?
Een connector is de koppeling waarmee een agent met een ander systeem praat, zoals Outlook, SharePoint of Dataverse. Om die koppeling te gebruiken is een verbinding (connection) nodig: een set inloggegevens die aan een gebruiker hangt. Wil een agent bijvoorbeeld een mail versturen of een record bijwerken, dan doet hij dat met de verbinding van de gebruiker die op dat moment met hem praat.
De eerste keer vraagt de agent daar toestemming voor met een kaartje in het gesprek. De gebruiker ziet welke connector het betreft en geeft akkoord. Dat kaartje is de consent card.

Dat werkt prima in een chatgesprek waar iemand meekijkt. Het werkt minder goed als er niemand is om op de knop te drukken. Precies daar zit de aanleiding voor deze instelling.
Waarom zou je connector consent uitzetten?
Er zijn een paar scenario’s waarin die kaart vooral in de weg zit:
- Agents die zonder toezicht draaien. Een autonome agent die ’s nachts een proces afhandelt, kan niet wachten tot iemand toestemming geeft.
- Gedeelde of publieke kanalen. Bij een agent op een website of infozuil is een technische toestemmingsvraag verwarrend voor de bezoeker.
- Brede uitrol binnen de organisatie. Rol je één agent uit naar duizenden medewerkers, dan krijgt iedereen die kaart eenmalig te zien. Als de organisatie het gebruik van die connector al centraal heeft goedgekeurd, is dat vooral ruis.
In al die gevallen is de afweging dezelfde: de toestemming is organisatorisch al geregeld, dus de vraag aan de individuele gebruiker voegt niets toe. Alleen moet dat eerste deel dan wel echt waar zijn.
Wanneer je dit beter niet doet
De consent card is geen willekeurige drempel. Het is het moment waarop een gebruiker ziet dat een agent met zijn verbinding aan de slag gaat. Zet je dat uit, dan verdwijnt dat moment, terwijl de agent nog steeds handelt met de rechten die aan die verbinding hangen. De agent krijgt er geen rechten bij, maar de gebruiker weet minder goed wat er namens hem gebeurt.
Praktische richtlijnen die wij aanhouden:
- Zet het per agent, nooit als standaardbeleid voor een hele omgeving.
- Doe het alleen als de organisatie het gebruik van die connectoren aantoonbaar heeft goedgekeurd, bijvoorbeeld via je DLP-beleid.
- Leg vast wélke agent het aan heeft en waarom. Het is een instelling die je alleen via de API kunt uitlezen, dus zonder documentatie is hij onzichtbaar voor de volgende beheerder.
- Neem hem mee in je periodieke controle. Een agent die van doel verandert, moet opnieuw langs deze afweging.

Let op: alleen voor de standard harness
Een harness is de motor onder je agent in Copilot Studio: het deel dat bepaalt wanneer het taalmodel wordt aangeroepen en welke tools het gebruikt. Volgens de documentatie van Microsoft werkt deze instelling alleen voor agents op de standard harness, de motor voor agents met vaste topics en regels. Voor agents op de GitHub Copilot harness geldt hij niet.
Bouw je nieuwe agents op die nieuwe harness, dan heb je hier dus niets aan. Dat is geen detail: het bepaalt of deze hele exercitie voor jouw situatie zin heeft. Microsoft zet de verschillen op een rij in het overzicht van harnesses.
Wat heb je nodig?
Er is geen knop in het admin center. Je regelt dit met PowerShell tegen de Power Platform API, en daar hoort wat eenmalig inrichtwerk bij. Microsoft levert het script ConsentBypass-CopilotStudio.ps1 op de documentatiepagina.
| Onderdeel | Wat je nodig hebt |
|---|---|
| Rol | Power Platform Administrator (minste rechten), AI Administrator of Global Administrator |
| Entra-app | Single-tenant app, type public client, redirect naar http://localhost |
| Permissie | Gedelegeerde Power Platform API-permissie CopilotStudio.AdminActions.Invoke |
| Identifiers | Tenant-ID, client-ID, environment-ID en bot-ID |
| Tools | PowerShell, het script als .ps1-bestand, en internettoegang tot de PowerShell Gallery: het script installeert zelf de module MSAL.PS als die ontbreekt |
Heb je de app-registratie al eens gedaan? Sla dan deel A over en begin bij stap 4.
Deel A: eenmalig inrichten in Microsoft Entra ID
- Registreer de app. Ga in de Azure portal naar Microsoft Entra ID > App registrations en kies New registration. Vul in:
- Name: bijvoorbeeld
CopilotStudioConsentBypassPS - Supported account types: Accounts in this organizational directory only (single tenant)
- Redirect URI: platform Public client/native (mobile and desktop), adres
http://localhost
Kies Register. Kopieer op de overzichtspagina de Application (client) ID en de Directory (tenant) ID.
- Name: bijvoorbeeld
- Geef de app de juiste permissie. Open in de app API permissions > Add a permission > APIs my organization uses. Zoek Power Platform API (applicatie-ID
8578e004-a5c6-46e7-913e-12f58912df43), kies Delegated permissions en vinkCopilotStudio.AdminActions.Invokeaan. Geef daarna consent als het beleid van je tenant daarom vraagt. - Wijs de beheerdersrol toe. Een Global Administrator gaat naar Microsoft Entra ID > Roles and administrators, kiest Power Platform Administrator en voegt onder Assignments de persoon toe die het script gaat draaien.
Je hebt nu een app die namens een ingelogde beheerder de Power Platform API mag aanroepen. Een client secret is niet nodig: je logt steeds interactief in via de browser.
Deel B: connector consent uitzetten voor één agent
Als voorbeeld nemen we een agent die ’s nachts facturen verwerkt en daarbij de Outlook-connector gebruikt. Er kijkt niemand mee, dus de consent card zou het proces blokkeren.
- Zoek de environment-ID en bot-ID. Open de agent in Copilot Studio. De URL heeft de vorm
https://copilotstudio.microsoft.com/environments/{environmentId}/bots/{botId}/overview. Het eerste GUID is de environment, het tweede de agent. - Zet het script klaar. Kopieer het script van de Microsoft-pagina naar een bestand
ConsentBypass-CopilotStudio.ps1(let op: niet.txt). Open PowerShell in die map en sta het script toe voor alleen dit venster:Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force Unblock-File -Path .\ConsentBypass-CopilotStudio.ps1 - Laad de functies en log in. Vervang de placeholders door je eigen tenant-ID en client-ID uit stap 1. Er opent een browservenster: log in met het account met de beheerdersrol.
. .\ConsentBypass-CopilotStudio.ps1 Connect-CopilotStudioAdmin -TenantId "<tenant-id>" -ClientId "<client-id>" - Lees de huidige stand. Dit commando leest alleen en verandert niets:
Get-AdminCopilotStudioBotConnectorConsentBypass ` -EnvironmentId "<environment-id>" -BotId "<bot-id>" - Zet de bypass aan.
Set-AdminCopilotStudioBotConnectorConsentBypass ` -EnvironmentId "<environment-id>" -BotId "<bot-id>" -BypassConsent $true - Controleer het resultaat. Draai het
Get-commando uit stap 7 opnieuw.
De token blijft alleen in dit PowerShell-venster geldig. Open je later een nieuw venster, herhaal dan stap 5 en 6.
Wat zie je als het gelukt is?
Het script meldt [200] OK en toont een klein overzicht met drie waarden: de EnvironmentId, de BotId en AdminConsentBypass. Die laatste vertelt je genoeg:
True: de consent cards worden overgeslagen.False: de consent cards worden gewoon getoond. Dat is de normale stand.
Voor de factuuragent staat er na stap 9 dus AdminConsentBypass : True. Test het daarna in de praktijk met een gebruiker die de agent nog nooit heeft gebruikt: de consent card hoort niet meer te verschijnen.

Terugdraaien
Terugdraaien doe je met hetzelfde commando en de waarde $false. Daarna laat de agent de consent cards weer gewoon zien. Controleer ook dit met het Get-commando.
Set-AdminCopilotStudioBotConnectorConsentBypass `
-EnvironmentId "<environment-id>" -BotId "<bot-id>" -BypassConsent $falseWerkt het niet?
| Wat je ziet | Oorzaak | Oplossing |
|---|---|---|
Not authenticated. Run Connect-CopilotStudioAdmin first. | Je bent niet ingelogd in dit PowerShell-venster | Draai stap 6 opnieuw, in hetzelfde venster |
| Melding dat het uitvoeren van scripts is uitgeschakeld | De execution policy blokkeert niet-ondertekende scripts | Draai het Set-ExecutionPolicy-commando uit stap 5 |
| Het script wordt geblokkeerd na downloaden | Windows heeft het bestand als onveilig gemarkeerd | Draai Unblock-File uit stap 5 |
| HTTP 400 | De environment-ID of bot-ID is geen geldig GUID | Kopieer de ID’s opnieuw uit de URL, zonder schuine strepen of spaties |
| HTTP 403 | Je account mist een van de drie beheerdersrollen | Laat de rol toewijzen (stap 3), open een nieuw venster en log opnieuw in |
| HTTP 404 | De agent bestaat niet in deze environment, of je hebt de ID’s omgewisseld | Controleer de volgorde: eerst environment, dan bot |
| HTTP 405 | Uitzetten via dit script wordt voor jouw omgeving niet ondersteund | Hier kun je zelf niets aan veranderen; de consent cards blijven staan |
| Inloggen mislukt met een AADSTS-melding | De app-registratie klopt niet, bijvoorbeeld een verkeerd redirect-platform of een ontbrekende permissie | Controleer stap 1 en 2: public client, http://localhost en de gedelegeerde permissie |
Get geeft True, maar de kaart verschijnt nog | De agent draait op de GitHub Copilot harness | Deze instelling geldt alleen voor de standard harness |
Veelgemaakte fouten
- Environment-ID en bot-ID omwisselen. Ze zijn allebei een GUID en lijken op elkaar. Het resultaat is een 404. Neem ze in de volgorde over waarin ze in de URL staan.
- Een client secret aanmaken. Uit gewoonte maken beheerders vaak een secret en een Web-redirect aan. Dit script logt interactief in als public client, dus een secret is niet nodig en een Web-redirect kan het inloggen juist laten mislukken.
- Zetten zonder eerst te lezen. Zonder de
Getvooraf weet je niet wat de oude stand was, en kun je niet netjes terug. - Denken dat de agent andere rechten krijgt. De bypass verandert niets aan wat de verbinding mag. Wil je de rechten beperken, doe dat dan in de connector en je DLP-beleid.
- Niets vastleggen. Er is geen overzicht in het admin center. Houd per agent bij dat de bypass aanstaat, wie hem heeft gezet en waarom.
Checklist
- De agent draait op de standard harness.
- Er is echt geen gebruiker die de kaart kan of hoeft te zien, en het connectorgebruik is centraal goedgekeurd.
- De Entra-app bestaat, met de gedelegeerde permissie
CopilotStudio.AdminActions.Invoke. - Je account heeft de rol Power Platform Administrator.
- Je hebt de oude stand gelezen, de nieuwe gezet en met
Getgecontroleerd. - De keuze staat gedocumenteerd en komt terug in je periodieke controle.
Kortom: gebruik het waar de goedkeuringsvraag echt geen betekenis heeft, en laat hem staan waar een gebruiker wél iets aan die bevestiging heeft.
Veelgestelde vragen
Krijgt mijn agent hier extra rechten door?
Nee. De agent werkt nog steeds met de verbinding en de rechten die daar al aan hangen. Wat vervalt is de bevestigingsvraag aan de gebruiker, niet de onderliggende autorisatie.
Kan ik dit voor alle agents tegelijk instellen?
Nee, de instelling geldt per agent. Je geeft bij elk commando een environment-ID en een bot-ID op. Dat is bewust: het dwingt je om per agent een afweging te maken.
Werkt dit ook voor agents op de GitHub Copilot harness?
Nee. Microsoft vermeldt expliciet dat het uitzetten van consent alleen geldt voor agents op de standard harness. Bouw je op de GitHub Copilot harness, dan is deze instelling niet van toepassing.
Hoe zie ik later terug of het aanstaat?
Met het Get-commando uit dit artikel, per agent. Er is geen overzicht in het admin center, dus houd zelf bij welke agents het aan hebben staan.
Is er een alternatief zonder PowerShell?
Soms. Bij een connector-tool in Copilot Studio kun je onder Credentials to use kiezen voor Maker-provided credentials. Dan gebruikt de agent de verbinding van de maker in plaats van die van de gebruiker, zodat de gebruiker zelf geen verbinding hoeft te maken. Daarvoor moet de agent een kanaal met authenticatie gebruiken. Let op: alles gebeurt dan onder het account van de maker. Dat is een andere afweging dan de bypass, want bij de bypass blijft de agent namens de gebruiker zelf werken. Zie connectors in Copilot Studio.
Verder lezen
Wil je meedenken over wanneer dit verantwoord is in jouw omgeving, of je agent-governance op orde brengen? Neem contact met ons op.


