Home Onze Technologieën Microsoft Power Platform API-koppelingen Diensten · Maatwerk Blogs Over Plan kennismaking

Connector consent in Copilot Studio uitzetten

← Alle blogs
Copilot Studio · Bijgewerkt op · 11 min leestijd

Connector consent in Copilot Studio uitzetten

Maarten
Eigenaar Fluentics
Illustratie van connector consent in Copilot Studio als goedkeuringsstap tussen een agent en een connector

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.

Connector consent uitzetten in Copilot Studio: met consent aan geeft de gebruiker eerst akkoord, met AdminConsentBypass wordt de consent card overgeslagen maar blijven de rechten gelijk
Het uitzetten van consent haalt de bevestigingsvraag weg, niet de rechten van de verbinding.

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.
Beslisboom voor het uitzetten van connector consent per agent: standard harness, scenario zonder gebruiker en centrale goedkeuring via DLP
Pas als alle drie de vragen met ja beantwoord zijn, is uitzetten een verantwoorde keuze.

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.

OnderdeelWat je nodig hebt
RolPower Platform Administrator (minste rechten), AI Administrator of Global Administrator
Entra-appSingle-tenant app, type public client, redirect naar http://localhost
PermissieGedelegeerde Power Platform API-permissie CopilotStudio.AdminActions.Invoke
IdentifiersTenant-ID, client-ID, environment-ID en bot-ID
ToolsPowerShell, 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

  1. 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.

  2. 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 vink CopilotStudio.AdminActions.Invoke aan. Geef daarna consent als het beleid van je tenant daarom vraagt.
  3. 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.

  1. 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.
  2. 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
  3. 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>"
  4. Lees de huidige stand. Dit commando leest alleen en verandert niets:
    Get-AdminCopilotStudioBotConnectorConsentBypass `
      -EnvironmentId "<environment-id>" -BotId "<bot-id>"
  5. Zet de bypass aan.
    Set-AdminCopilotStudioBotConnectorConsentBypass `
      -EnvironmentId "<environment-id>" -BotId "<bot-id>" -BypassConsent $true
  6. 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.

Stappen om connector consent per agent te lezen en te zetten met PowerShell, met de betekenis van de foutcodes 403, 404 en 405
Lees altijd eerst de huidige stand en controleer na het zetten of hij klopt.

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 $false

Werkt het niet?

Wat je zietOorzaakOplossing
Not authenticated. Run Connect-CopilotStudioAdmin first.Je bent niet ingelogd in dit PowerShell-vensterDraai stap 6 opnieuw, in hetzelfde venster
Melding dat het uitvoeren van scripts is uitgeschakeldDe execution policy blokkeert niet-ondertekende scriptsDraai het Set-ExecutionPolicy-commando uit stap 5
Het script wordt geblokkeerd na downloadenWindows heeft het bestand als onveilig gemarkeerdDraai Unblock-File uit stap 5
HTTP 400De environment-ID of bot-ID is geen geldig GUIDKopieer de ID’s opnieuw uit de URL, zonder schuine strepen of spaties
HTTP 403Je account mist een van de drie beheerdersrollenLaat de rol toewijzen (stap 3), open een nieuw venster en log opnieuw in
HTTP 404De agent bestaat niet in deze environment, of je hebt de ID’s omgewisseldControleer de volgorde: eerst environment, dan bot
HTTP 405Uitzetten via dit script wordt voor jouw omgeving niet ondersteundHier kun je zelf niets aan veranderen; de consent cards blijven staan
Inloggen mislukt met een AADSTS-meldingDe app-registratie klopt niet, bijvoorbeeld een verkeerd redirect-platform of een ontbrekende permissieControleer stap 1 en 2: public client, http://localhost en de gedelegeerde permissie
Get geeft True, maar de kaart verschijnt nogDe agent draait op de GitHub Copilot harnessDeze 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 Get vooraf 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

  1. De agent draait op de standard harness.
  2. Er is echt geen gebruiker die de kaart kan of hoeft te zien, en het connectorgebruik is centraal goedgekeurd.
  3. De Entra-app bestaat, met de gedelegeerde permissie CopilotStudio.AdminActions.Invoke.
  4. Je account heeft de rol Power Platform Administrator.
  5. Je hebt de oude stand gelezen, de nieuwe gezet en met Get gecontroleerd.
  6. 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.

Vragen over dit onderwerp?

Plan een kennismaking →