Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Wanneer u een agent maakt, richt Azure automatisch identiteitsbronnen in. In dit artikel wordt uitgelegd wat er wordt gemaakt, waarom er twee identiteiten bestaan en hoe connectors deze gebruiken.
Zie Agentmachtigingen voor informatie over hoe uw agent machtigingen krijgt voor Azure-resources (RBAC-rollen, machtigingsniveaus, namensstroom).
Wat wordt gemaakt
Er worden samen met uw agent twee beheerde identiteiten gemaakt.
| Identiteit | Wat het is | Wat je ermee doet |
|---|---|---|
| Door de gebruiker toegewezen beheerde identiteit (UAMI) | Een zelfstandige identiteitsresource in uw resourcegroep | Wijs RBAC-rollen toe en selecteer deze bij het instellen van connectors. Dit is de identiteit die u beheert |
| Door het systeem toegewezen beheerde identiteit | Een interne identiteit die wordt gebruikt door de infrastructuur van de agent | Niets: deze identiteit wordt automatisch beheerd en alleen gebruikt voor interne bewerkingen |
De UAMI is de standaardidentiteit waarmee je werkt. Deze wordt weergegeven in uw resourcegroep, u wijst er RBAC-rollen aan toe en selecteert u deze bij het instellen van connectors. Het aanmaken van een optionele Microsoft Entra-agentidentiteit is los van het selecteren van een identiteit voor toegang tot Azure-bronnen.
Aanbeveling
Wanneer u een vervolgkeuzelijst voor beheerde identiteit in de portal ziet (voor connectors, opslagplaatsen of andere integraties), selecteert u de UAMI van uw agent. Dit is de identiteit die overeenkomt met uw RBAC-roltoewijzingen.
Waar de UAMI van uw agent wordt gebruikt
De UAMI van uw agent is de primaire identiteit voor de meeste bewerkingen.
| Operatie | Identiteit | Aantekeningen |
|---|---|---|
| Azure resource operations (Azure Resource Manager, CLI, diagnostiek) | UAMI standaard | De RBAC-rollen die aan de geconfigureerde identiteit zijn toegewezen, bepalen waar de agent toegang toe heeft |
| Communicatieconnectoren (Outlook, Teams) | UAMI + uw OAuth-referenties | U meldt zich aan via OAuth; de UAMI handelt de verificatie voor de connector-resource af. |
| Dataconnectors (Azure Data Explorer) | UAMI | De UAMI-machtigingen verlenen voor het Kusto-doelcluster |
| Source code connectors (GitHub, Azure DevOps) | UAMI (voor door Azure DevOps beheerde identiteit) | Azure DevOps-connector maakt gebruik van UAMI; GitHub maakt gebruik van OAuth |
| MCP-connectoren | Varies | U geeft eindpunt-URL en referenties op; eventueel een beheerde identiteit toewijzen voor downstream Azure-aanroepen |
| Interne infrastructuur | UAMI | Automatisch gebruikt voor de interne bewerkingen van de agent |
| Key Vault | UAMI (bij voorkeur) of toegewezen door het systeem | Valt terug op systeem toegewezen als er geen UAMI is opgegeven |
Microsoft Entra-agentidentiteit (preview)
Kies voor een gereguleerde identiteit in Microsoft Entra Agent-ID tijdens het aanmaken van de agent, in geavanceerde configuratie. Het wordt niet standaard aangemaakt en vervangt de beheerde identiteiten van de agent niet.
| Vermogen | UAMI | Microsoft Entra-agentidentiteit |
|---|---|---|
| Oprichting | Gemaakt met de agent. | Optioneel tijdens het aanmaken van een agent in de geavanceerde installatie, of tijdens de Teams-installatie. |
| Governance | Azure RBAC roltoewijzingen. | Microsoft Entra-sponsors, aanmeldlogboeken en accountbesturing. |
| Teams-aanwezigheid | Biedt geen Teams-gebruikersaccount. | Het selecteren van Agentidentiteit instellen tijdens het aanmaken van de agent maakt ook een agentgebruikersaccount aan. Het verbinden met Teams en het toewijzen van de licentie zijn gescheiden. |
Het aanmaken van een Agent ID verandert de geselecteerde identiteit voor Azure-resource-toegang of overdracht van roltoewijzingen niet. De UAMI blijft de standaard. Beheerde identiteitsconnectors en service-infrastructuur behouden hun beheerde identiteiten. Ga door met het beheren van toegang via agentmachtigingen.
Waar export beschikbaar is, maakt het hebben van de agentidentiteit standaard Agent 365-contentexport mogelijk voor door personen gestart portaal- en Teams-chatbeurten, zonder afmelden per agent. De regels voor gegevensverwerking en locatie zijn los van Azure-resource-toegangsrechten en de implementatieregio van de agent.
Hoe connectors identiteit gebruiken
Verschillende connectortypen gebruiken identiteiten anders. Het belangrijkste onderscheid is of de connector via Azure Resource Manager (ARM) moet gaan om de externe service te bereiken.
Communicatieconnectors (Outlook, Teams)
Wanneer u een communicatieconnector instelt, gebeuren er twee dingen:
- Je logt in met je account via OAuth, waardoor de connector je gebruikersreferenties krijgt.
- U selecteert een UAMI uit de identiteitskeuzemenu, dat de connector gebruikt om te authenticeren bij de connectorresource.
De connector slaat uw OAuth-token veilig op in een connectorresource. De connector-dienst fungeert als een beveiligde brug. De resource bevat uw referenties, zodat de agent geen directe toegang tot deze resources nodig heeft. Er wordt gebruikgemaakt van de UAMI om de verificatie te brokeren wanneer de agent namens u een e-mailbericht verzendt of een Teams-bericht plaatst.
De Agent-gebruiker chat gebruikt de aparte Teams-integratie (preview). Iedereen meldt zich aan bij die integratie met zijn of haar werkaccount via een privé-Teams-kaart; het maakt geen gebruik van de outbound-connector autorisatie van de setup-administrator.
Gegevensconnectoren (Azure Data Explorer/Kusto)
Voor Kusto-connectors gebruikt de agent de UAMI rechtstreeks om te verifiëren bij uw Azure Data Explorer-cluster. Er is geen OAuth-aanmelding nodig. Geef de UAMI de vereiste machtigingen, zoals de rol Kijker op het Kusto-cluster.
Broncode-connectors (GitHub, Azure DevOps)
Broncode-connectors gebruiken verschillende authenticatiemethoden, afhankelijk van het platform.
- Azure DevOps: Gebruikt UAMI voor beheerde identiteitsauthenticatie. Selecteer de UAMI in de vervolgkeuzelijst identiteit en geef deze toegang tot uw Azure DevOps-organisatie.
- GitHub: Gebruikt OAuth-authenticatie. Meld u aan met uw GitHub-account. Er is geen beheerde identiteit nodig voor de GitHub-verbinding zelf.
Aangepaste MCP-connectors
MCP-connectors maken gebruik van verificatie op basis van eindpunten. Geef de URL van de MCP-server op, samen met referenties, zoals een API-sleutel, Bearer-token of OAuth. U kunt eventueel een beheerde identiteit toewijzen voor de MCP-server die moet worden gebruikt bij het maken van downstream Azure API-aanroepen.
UAMI van uw agent zoeken
U kunt de door de gebruiker toegewezen beheerde identiteit van uw agent vinden via de agentportal, De Azure-portal of de Azure CLI.
Vanuit het agentportaal:
- Ga naar Instellingen>Algemeen en zoek de sectie Azure-instellingen.
- De identiteitsnaam verschijnt in het veld Beheerde identiteit .
- Selecteer Ga naar identiteit om deze te openen in Azure Portal.
Vanuit het Azure-portaal:
- Ga naar de resourcegroep van uw agent.
- Zoek de
id-*beheerde identiteitsresource. - Kopieer de object-id (principal). Gebruik deze waarde voor RBAC-roltoewijzingen.
Vanuit Azure CLI:
Dit commando retourneert alleen gekoppelde door de gebruiker toegewezen beheerde identiteiten, niet de beheerde Agent ID of agentgebruiker. Gebruik Instellingen>Algemeen>Agentidentiteit om de naam van de beheerde identiteit te vinden.
# List user-assigned identities on the agent resource
az resource show \
--resource-group <RESOURCE_GROUP_NAME> \
--name <AGENT_NAME> \
--resource-type Microsoft.App/agents \
--api-version 2026-07-01 \
--query identity.userAssignedIdentities
Gebruik voor de geconfigureerde UAMI de principalId van de overeenkomende vermelding voor roltoewijzingen, niet de resource-ID of clientId.
Volgende stap
Verwante inhoud
- Machtigingen voor agents: Leer hoe u RBAC-rollen en machtigingsniveaus voor uw agent configureert.
- Connectors: Configureer connectortypen en ontdek hoe ze de mogelijkheden van uw agent uitbreiden.
- Gebruikersrollen en -machtigingen: Bepaal wie uw agent kan bekijken, ermee interageren en beheren.
- Stel Microsoft Entra Agent-ID in: Maak een gereguleerde identiteit aan en verifieer deze tijdens het aanmaken van een agent.
- Stel de Teams-integratie in: Hergebruik een bestaande identiteit of voltooi de instelling van een nieuwe identiteit en agentgebruiker voor Teams-chat.