Externe bedreigingsdetectie en -beveiliging inschakelen voor aangepaste Copilot Studio-agents (preview)

[Dit artikel maakt deel uit van de voorlopige documentatie en kan nog veranderen.]

Aangepaste agents die in Copilot Studio zijn gemaakt, zijn standaard beveiligd. Ze omvatten ingebouwde bescherming tegen verschillende bedreigingen, zoals aanvallen met prompt-injectie van gebruikers (UPIA) en aanvallen met promptinjectie tussen domeinen (XPIA). Tijdens runtime blokkeert de agent aanvallen van deze typen, waardoor het risico op gegevensexfiltratie wordt verminderd.

Om de bewakingsmogelijkheden en beveiliging van aangepaste agents verder te vergroten, kunnen organisaties met Copilot Studio externe detectiesystemen voor bedreigingen configureren voor uitgebreid toezicht. Deze hulpprogramma's werken tijdens de runtime van de agent, waarbij de agentactiviteit continu wordt geëvalueerd. Als het systeem verdachte hulpprogramma's of acties detecteert, kan het optreden om te voorkomen dat ze worden uitgevoerd. Deze detectie van bedreigingen biedt een extra laag van realtime-beveiliging en nalevingshandhaving.

Hoe het werkt

Een extern detectiesysteem voor bedreigingen wordt ingesteld als een webservice, waarbij een REST API wordt weergegeven met een eindpunt voor bedreigingsdetectie. Er wordt een beveiligde verbinding geconfigureerd tussen de agent en het eindpunt. Telkens wanneer de orchestrator tijdens runtime een hulpprogramma aanroept, worden relevante gegevens over het voorgestelde hulpprogramma naar het eindpunt voor detectie van bedreigingen verzonden voor evaluatie. Het detectiesysteem voor bedreigingen analyseert de gegevens en retourneert een beslissing om de aanroep van het hulpprogramma toe te staan of te blokkeren.

Als het detectiesysteem voor bedreigingen een beveiligingsprobleem detecteert tijdens de bewerking van een agent, stopt de agent onmiddellijk met verwerken en meldt de gebruiker dat het bericht is geblokkeerd. Als het systeem daarentegen de bewerking goedkeurt, gaat de agent naadloos door, zonder zichtbaar effect of onderbreking voor de gebruiker.

Opties voor het instellen van externe detectie van bedreigingen

Copilot Studio biedt ondersteuning voor een flexibele "Bring Your Own Protection"-benadering. Organisaties hebben de vrijheid om beveiligingsoplossingen te integreren, die het beste aansluiten bij hun unieke vereisten.

De volgende opties zijn beschikbaar:

• Ontwikkel uw eigen aangepaste bewakingshulpprogramma's of laat iemand deze voor u ontwikkelen. Zie Een detectiesysteem voor runtime-bedreigingen voor Copilot Studio-agents bouwen voor meer informatie over het configureren van het systeemendpoint, zodat uw agent ermee kan verbinden.
• Een robuuste bedrijfsoplossing toepassen door Microsoft Defender
• Producten van andere vertrouwde beveiligingsproviders gebruiken

Welke gegevens worden gedeeld met de provider voor de detectie van bedreigingen?

Zodra u een verbinding met een bedreigingsdetectiesysteem hebt geconfigureerd, deelt de agent gegevens met de externe beveiligingsprovider tijdens de uitvoering. De agent communiceert met de service wanneer deze een hulpprogramma aanroept. Dit delen van gegevens zorgt voor een efficiënte besluitvorming door het geconfigureerde systeem, zonder de ervaring van de agentgebruikers te beperken.

De gegevens die op hoog niveau met het systeem worden gedeeld, omvatten:

• De recente prompt van de gebruiker en de meest recente geschiedenis van chatberichten, die zijn uitgewisseld tussen de agent en de gebruiker.
• Uitvoer van vorige hulpprogramma's die door de agent worden gebruikt.
• Metagegevens van gesprekken: identiteit van de agent, de gebruiker die ermee communiceert, de tenant van de gebruiker en de trigger die deze heeft geactiveerd (indien van toepassing).
• Het hulpprogramma dat de agent wil aanroepen, inclusief door de agent gegenereerde redenering waarom dit hulpprogramma is geselecteerd en de voorgestelde invoer en waarden.

Vereiste voorwaarden

Voordat u begint, hebt u het volgende nodig:

• Een externe service voor detectie van bedreigingen die is ingesteld voor het evalueren van aanvragen voor het gebruik van agenthulpprogramma's. De service moet een REST API-eindpunt beschikbaar maken. Voor de installatie aan de copilot Studio-zijde van de integratie hebt u de basis-URL voor de webservice van de beveiligingsprovider nodig. Dit artikel verwijst naar deze URL als het eindpunt. De agent verzendt aanvragen voor detectie van bedreigingen naar API's op deze basis-URL. U moet deze URL van uw beveiligingsprovider ontvangen.
• Een Microsoft Entra-tenant waar u een toepassing kunt registreren voor verificatie tussen de agent en de service voor detectie van bedreigingen.
• Een gebruiker met de rol Power Platform-beheerder voor het configureren van een verbinding tussen de agent en het externe bedreigingsdetectiesysteem voor zowel het niveau van de afzonderlijke omgeving als het niveau van de omgevingsgroep.

Een systeem voor de externe detectie van bedreigingen configureren

Het proces voor het configureren van een extern detectiesysteem voor bedreigingen voor uw agent bestaat uit twee stappen:

1. Configureer een Microsoft Entra-toepassing.
2. Detectie van bedreigingen configureren in het Power Platform-beheercentrum.

Stap 1: Een Microsoft Entra-toepassing configureren

Er zijn twee paden die u kunt uitvoeren om een Microsoft Entra-toepassing te configureren:

• Optie A: Configureren met behulp van PowerShell-script (aanbevolen)
• Optie B: handmatig configureren met behulp van de Azure Portal

Optie A: Configureren met behulp van PowerShell (aanbevolen)

U kunt een opgegeven PowerShell-script gebruiken om het maken en configureren van uw Microsoft Entra-toepassing te automatiseren.

Vereisten voor PowerShell-configuratie

• Windows PowerShell 5.1 of hoger
• Voldoende machtigingen voor het maken van toepassingsregistraties in uw Microsoft Entra-tenant
• De basis-URL van de webservice voor detectie van bedreigingen. De URL wordt in de volgende scriptparameters aangeduid als Endpoint. U moet deze URL van uw beveiligingsprovider ontvangen.
• De Microsoft Entra-tenant-id van uw organisatie. Het tenant-id wordt in de volgende scriptparameters aangeduid als TenantId.

Het script downloaden en voorbereiden

Download het script Create-CopilotWebhookApp.ps1.

Scriptparameters

Met het script worden de volgende parameters geaccepteerd:

Het script uitvoeren

Om de toepassing te maken:

1. Open Windows PowerShell als beheerder.

2. Ga naar de map met het script.

3. Voer het volgende script uit, waarbij u de tijdelijke aanduidingen voor TenantId, Endpoint, DisplayName en FICName met uw eigen parameters vervangt.

   .\Create-CopilotWebhookApp.ps1 `
   -TenantId "11111111-2222-3333-4444-555555555555" `
   -Endpoint "https://provider.example.com/threat_detection/copilot" `
   -DisplayName "Copilot Security Integration - Production" `
   -FICName "ProductionFIC"
   

Het interactieve script wordt uitgevoerd op de opdrachtregel. Het script voert de app-id uit van de gemaakte Microsoft Entra-toepassing. U hebt de app-id later nodig bij het configureren van detectie van bedreigingen in het Power Platform-beheercentrum.

Optie B: handmatig configureren met behulp van de Azure Portal

Vereisten voor handmatige configuratie

• De Microsoft Entra-tenant-id van uw organisatie. De tenant-id wordt de tenant-id genoemd in de instructies die volgen.
• Voldoende machtigingen voor het maken van toepassingsregistraties in uw Microsoft Entra-tenant.
• De basis-URL van de webservice voor detectie van bedreigingen die u gebruikt. Dit wordt het eindpunt genoemd in de volgende instructies. U moet deze URL van uw beveiligingsprovider ontvangen.

Registreer een Microsoft Entra-toepassing

Volg deze stappen om een Microsoft Entra-toepassingsregistratie te maken. De toepassing wordt gebruikt om verificatie tussen de agent en de webservice voor detectie van bedreigingen te beveiligen. Zie Een toepassing registreren in Microsoft Entra ID voor meer informatie over het maken van een dergelijke app.

1. Meld u aan bij Azure Portal en navigeer naar de pagina Microsoft Entra ID.
2. Selecteer Nieuwe registratie onder App-registraties.
3. Geef een naam op en selecteer Alleen accounts in deze organisatiedirectory (één tenant) als het ondersteunde accounttype.
4. Registreer de app.
5. Nadat de app is gemaakt, kopieert u de app-id. U hebt de app-id later nodig bij het configureren van detectie van bedreigingen in het Power Platform-beheercentrum.

Autoriseer de Microsoft Entra-toepassing met uw provider naar keuze

De agent maakt gebruik van Federatieve Identiteitsreferenties (FIC) als een veilige, zonder geheimen werkende verificatiemethode voor het uitwisselen van gegevens met de provider van systemen voor bedreigingsdetectie. Volg deze stappen om FIC te configureren voor uw Microsoft Entra-toepassing. Zie Een door de gebruiker toegewezen beheerde identiteit configureren om een externe id-provider te vertrouwen voor meer informatie.

1. Open Azure Portal en ga naar App-registraties. Selecteer de toepassing die u in stap 1 hierboven hebt gemaakt.

2. Selecteer in de zijbalk Beheren>Certificaten & geheimen>Federatieve referenties.

3. Selecteer Referentie toevoegen.

4. Selecteer in de vervolgkeuzelijst Federatieve referenties de optie Andere verlener.

5. Vul de velden in volgens deze instructies:

   • Verlener: Voer de volgende URL in, waarbij u {tenantId} de Microsoft Entra-tenant-id van uw organisatie vervangt: https://login.microsoftonline.com/{tenantId}/v2.0

   • Type: Selecteer Expliciete onderwerp-id.

   • Waarde: Voer als volgt een tekenreeks in die is gestructureerd: /eid1/c/pub/t/{base 64 encoded tenantId}/a/m1WPnYRZpEaQKq1Cceg--g/{base 64 encoded endpoint}

     Voer base64-codering uit voor de Microsoft Entra-tenant-id van uw organisatie en de basis-URL van de webservice voor detectie van bedreigingen. Vervang de tijdelijke aanduiding {base 64 encoded tenantId} door de base64-gecodeerde waarde van uw tenant-id en de tijdelijke aanduiding {base 64 encoded endpoint} door de base64-gecodeerde basis-URL.

     Gebruik het volgende PowerShell-script om de base64-codering van uw tenant-id en eindpunt-URL op te halen. Zorg ervoor dat u de placeholderwaarden "11111111-2222-3333-4444-555555555555" en "https://provider.example.com/threat_detection/copilot"" vervangt door uw werkelijke waarden voor tenant-id en eindpunt-URL:

     # Encoding tenant ID
     $tenantId = [Guid]::Parse("11111111-2222-3333-4444-555555555555")
     $base64EncodedTenantId = [Convert]::ToBase64String($tenantId.ToByteArray()).Replace('+','-').Replace('/','_').TrimEnd('=')
     Write-Output $base64EncodedTenantId
     
     # Encoding the endpoint
     $endpointURL = "https://provider.example.com/threat_detection/copilot"
     $base64EncodedEndpointURL = [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes($endpointURL)).Replace('+','-').Replace('/','_').TrimEnd('=')
     Write-Output $base64EncodedEndpointURL
     

   • Naam: kies een beschrijvende naam.

6. Selecteer de knop Toevoegen.

Stap 2: het detectiesysteem voor bedreigingen configureren

Vervolgens moet u het systeem voor bedreigingsdetectie configureren in het Power Platform-beheercentrum om uw agent te verbinden met de externe beveiligingsprovider.

Vereisten voor het configureren van detectie van bedreigingen in het Power Platform-beheercentrum

• De app-id van de Microsoft Entra-toepassing die u in de vorige stap hebt gemaakt.
• De eindpuntkoppeling die wordt geleverd door de provider van uw externe bewakingssysteem. De eindpuntkoppeling is hetzelfde basis-URL-eindpunt dat u gebruikt bij het configureren van de Microsoft Entra-toepassing.
• Een gebruiker met de rol Power Platform-beheerder om de verbinding te configureren.
• Voer eventuele andere stappen uit die uw beveiligingsprovider nodig heeft om uw geregistreerde toepassing te autoriseren. Raadpleeg de documentatie van uw provider (indien van toepassing) voor specifieke onboarding- en autorisatiestappen.

Voer de volgende stappen uit om het systeem voor bedreigingsdetectie in het Power Platform-beheercentrum te configureren:

1. Meld u aan bij het Power Platform-beheercentrum.
2. Selecteer Beveiliging in het navigatiedeelvenster aan de zijkant en selecteer vervolgens Detectie van bedreigingen. De pagina Bedreigingsdetectie wordt geopend.
3. Selecteer Aanvullende detectie van bedreigingen. Er wordt een deelvenster geopend.
4. Selecteer de omgeving waarvoor u de beveiliging van de agent wilt verbeteren en selecteer Instellen. Er wordt een deelvenster geopend.
5. Selecteer Copilot Studio toestaan om gegevens te delen met een provider voor bedreigingsdetectie.
6. Voer onder Azure Entra-app-id de app-id in van de Microsoft Entra-toepassing die u eerder hebt gemaakt.
7. Voer de eindpuntkoppeling in die wordt geleverd door de provider van uw externe bewakingssysteem. De eindpuntkoppeling is hetzelfde basis-URL-eindpunt dat u gebruikt bij het configureren van de Microsoft Entra-toepassing.
8. Definieer onder Foutgedrag instellen het standaardgedrag van het systeem voor wanneer het systeem voor detectie van bedreigingen niet op tijd reageert of reageert met een fout. Dit is standaard ingesteld op Toestaan dat de agent reageert, maar u kunt ook de optie De query blokkeren kiezen om het risico verder te verminderen.
9. Selecteer Opslaan.

Probleemoplossingsproces

Hier vindt u informatie over problemen die kunnen optreden en hoe u deze kunt afhandelen.

Configuratieproblemen met bedreigingsdetectie in het Power Platform-beheercentrum

In de volgende tabel worden veelvoorkomende fouten beschreven die kunnen optreden wanneer u Opslaan in de vorige stap hebt geselecteerd en de manier waarop u deze fouten kunt afhandelen:

Selecteer Foutgegevens kopiëren voor meer foutdetails.

Veelvoorkomende problemen met Microsoft Entra en verificatie

Hier volgen enkele andere veelvoorkomende problemen die kunnen optreden met uw Microsoft Entra-app en -verificatie.

Microsoft Entra-toepassing bestaat niet

Voorbeeld: Kan token niet verkrijgen: AADSTS700016: Toepassing met id '55ed00f8-faac-4a22-9183-9b113bc53ddd4' is niet gevonden in de map Contoso. Dit kan gebeuren als de toepassing niet is geïnstalleerd door de beheerder van de tenant of als er toestemming is gegeven aan een gebruiker in de tenant. Mogelijk hebt u uw verificatieaanvraag naar de verkeerde tenant verzonden.

Procedure: zorg ervoor dat de opgegeven toepassings-id juist is en bestaat in Azure.

Er is geen FIC geconfigureerd in de app

Voorbeeld: Kan geen token verkrijgen: een configuratieprobleem voorkomt verificatie. Controleer het foutbericht van de server voor meer informatie. U kunt de configuratie wijzigen in de portal voor toepassingsregistratie. Zie https://aka.ms/msal-net-invalid-client voor meer informatie. Oorspronkelijke uitzondering: AADSTS70025: De client '57342d48-0227-47cd-863b-1f4376224c21'(Webhooks-test) heeft geen geconfigureerde federatieve identiteitsreferenties.

Hoe om te gaan: De geleverde app heeft geen FIC geconfigureerd. Volg de documentatie en configureer FIC dienovereenkomstig.

Ongeldige FIC-verlener

Voorbeeld: Kan geen token verkrijgen: een configuratieprobleem voorkomt verificatie. Controleer het foutbericht van de server voor meer informatie. U kunt de configuratie wijzigen in de portal voor toepassingsregistratie. Zie https://aka.ms/msal-net-invalid-client voor meer informatie. Oorspronkelijke uitzondering: AADSTS7002111: Er is geen overeenkomende federatieve identiteitsrecord gevonden voor de gepresenteerde verlener van de assertie 'https://login.microsoftonline.com/262d6d26-0e00-40b3-9c2f-31501d4dcbd1/v2.0'. Zorg ervoor dat de verlener van federatieve identiteitsreferenties 'https://login.microsoftonline.com/{tenantId}/v2.0' is.

Procedure: er is geen FIC met de verwachte verlener gevonden in de app. Open uw FIC-configuratie en stel de uitgever in op https://login.microsoftonline.com/{tenantId}/v2.0 (vul uw tenant-id in).

Ongeldig FIC-onderwerp

Voorbeeld: Kan geen token verkrijgen: een configuratieprobleem voorkomt verificatie. Controleer het foutbericht van de server voor meer informatie. U kunt de configuratie wijzigen in de portal voor toepassingsregistratie. Zie https://aka.ms/msal-net-invalid-client voor meer informatie. Oorspronkelijke uitzondering: AADSTS7002137: Geen overeenkomende federatieve identiteitsrecord gevonden voor gepresenteerd assertie-onderwerp '/eid1/c/pub/t/Jm0tJgAOs0CcLzFQHU3L0Q/a/iDQPIrayM0GBBVzmyXgucw/aHR0cHM6Ly9jb250b3NvLnByb3ZpZGVyLmNvbeKAiw'. Zorg ervoor dat het onderwerp van de federatieve identiteitsreferentie '/eid1/c/pub/t/{tenantId}/a/iDQPIrayM0GBBVzmyXgucw/aHR0cHM6Ly9jb250b3NvLnByb3ZpZGVyLmNvbeKAiw' is.

Omgaan met: er is geen FIC met het verwachte onderwerp gevonden in de app. Open uw FIC-configuratie en stel het onderwerp in op de verwachte waarde, zoals wordt voorgesteld in de fout (vul uw tenant-id in). Zorg ervoor dat er geen extra witruimten of lege regels in de onderwerpvelden staan.

App is niet toegestaan bij provider (specifiek voor Microsoft Defender)

Voorbeeld: de toepassings-id in uw verificatietoken komt niet overeen met de geregistreerde toepassing voor webhooktoegang. Zorg ervoor dat u de juiste toepassingsreferenties gebruikt.

Hoe te verwerken: De toepassing staat niet op de toegestane lijst bij de provider. Raadpleeg de providerdocumentatie om de webhooktoegang tot de app te verlenen.

De beveiliging verbreken door het systeem voor bedreigingsdetectie

Als u niet langer wilt dat het detectiesysteem voor bedreigingen uw agent bewaakt, voert u de volgende stappen uit:

1. Meld u aan bij het Power Platform-beheercentrum.
2. Selecteer Beveiliging in het navigatiedeelvenster aan de zijkant en selecteer vervolgens Detectie van bedreigingen. De pagina Bedreigingsdetectie wordt geopend.
3. Selecteer Aanvullende detectie van bedreigingen. Er wordt een deelvenster geopend.
4. Selecteer de omgeving waarvoor u uitgebreide agentbeveiliging wilt uitschakelen en selecteer Instellen. Er wordt een deelvenster geopend.
5. Schakel Copilot Studio toestaan om gegevens te delen met uw geselecteerde provider uit.
6. Selecteer Opslaan.