Een beheerde connector instellen

Maak een geauthenticeerde verbinding aan met een externe dienst, zoals Office 365 Outlook, Microsoft Teams, Google Gmail, Yammer/Viva Engage, Box, Confluence, OneDrive of SharePoint, met goedkeuringscontroles per tool en parametervergrendeling. Uw agent krijgt alleen toegang tot de bewerkingen die u inschakelt met de governance-instellingen die u configureert.

Prerequisites

  • Een agent in de Azure SRE Agent-portal
  • de rol 'SRE Agent Author' of 'Administrator' op de agent (zie Gebruikersrollen)
  • Een account op de dienst die je wilt verbinden (bijvoorbeeld een Microsoft 365-account, Google Gmail-account, Viva Engage-toegang of een Box workspace-lidmaatschap)

Hoe beheerde connectors je inloggegevens beschermen

Wanneer je een connector authenticeert, slaat SRE Agent je token of sleutel op in een beveiligde verbindingsbron die gescheiden is van de agent-runtime. Tijdens runtime authenticeert de agent zich door zijn eigen identiteit te gebruiken en roept de dienst via die verbinding aan. De agent ziet je gegevens nooit. Als de omgeving van de agent wordt gecompromitteerd, wordt je token niet blootgesteld. Je kunt de toegang van de agent intrekken zonder je eigen wachtwoord te wijzigen.

De dienst waarmee je verbinding maakt ziet nog steeds de identiteit die de verbinding autoriseerde. Acties die de agent onderneemt, zoals het versturen van een e-mail of het plaatsen van een kanaalupdate, verschijnen onder jouw naam.

Stap 1: Open de wizard voor beheerde connectors

  1. Open uw agent in de Azure SRE Agent-portal.
  2. Vouw Builder uit in de zijbalk aan de linkerkant.
  3. Selecteer Connectors.
  4. Selecteer Connector toevoegen.

De connectorpicker opent en toont beschikbare connectoren georganiseerd per tabblad: Telemetrie, Notificatie, MCP, Incidenten, Deployment en Overige.

Note

Broncode-diensten (GitHub, Azure DevOps, GitLab) zijn verbonden via de Builder>Code Access-pagina, niet via deze wizard. Zie Connect a source code service.

Preview-connectorkaarten tonen een Preview-badge . Gebruik het zoekvak om een connector op naam te vinden op alle tabbladen.

Stap 2: Selecteer een beheerde connector en verifieer

Selecteer de verbindingskaart voor de service waarmee u verbinding wilt maken en selecteer vervolgens Volgende.

De verificatiestap wordt weergegeven. Wat u ziet, is afhankelijk van de connector:

OAuth-connectors (de meeste services)

Voor Office 365 Outlook, Microsoft Teams, Google Gmail, Yammer/Viva Engage, Box, Confluence, OneDrive, SharePoint en soortgelijke diensten:

  1. Selecteer Aanmelden (of meld u aan bij [Service]).
  2. Er wordt een OAuth-pop-up geopend. Meld u aan met uw account voor die service.
  3. Wanneer het pop-upvenster wordt gesloten, wordt op de verbindingskaart een groen vinkje en uw geverifieerde naam weergegeven.

Multi-auth connectoren

Sommige connectoren bieden meerdere authenticatiemethoden als radioknoppen:

  1. Kies de voorkeursmethode.
  2. Vul de inlogvelden, token-, app- of beheerde identiteitsvelden in die door de wizard worden getoond.

Runtime-gedefinieerde connectoren

Sommige connectors halen hun authenticatiemethoden en -bewerkingen op van de beheerde API tijdens de installatie. Volg de keuzes die door de tovenaar zijn getoond in plaats van een vaste authenticatielijst aan te nemen.

Connectoren gebaseerd op tokens en headers

  1. Voer de token-, header- of verbindingswaarden in die de connector toont.
  2. Selecteer Maak verbinding met.

Nadat de verificatie is geslaagd, selecteert u Volgende om door te gaan.

Tip

Als de pop-up van OAuth niet wordt weergegeven, controleert u de pop-upblokkering van uw browser. Sta pop-ups van sre.azure.com toe.

Stap 3: Stel tools in

De stap 'Instellingen tools ' toont elke beschikbare tool voor de connector in een tabel met kolommen Toolnaam, Parameterbeleid en Toestemming .

  1. Selecteer het selectievakje voor elke operatie die je wilt dat de agent gebruikt.
  2. Gebruik het selectievakje in de Toolnaam-header om alle momenteel gefilterde bewerkingen te selecteren of te wissen.
  3. Gebruik het zoekvak om tools te filteren op naam of beschrijving.

Het geselecteerde aantal (bijvoorbeeld 12 van de 47 geselecteerde) toont hoeveel tools je hebt geselecteerd van het totaal beschikbare totaal.

Note

Selecteer alleen de bewerkingen die u nodig hebt. Minder hulpprogramma's betekent beter beheer en nauwkeuriger agentgedrag.

Configureer governance voor elke geselecteerde bewerking in dezelfde tabel:

Parameterwaarden vergrendelen (parameterbeleid)

  1. Zet de Parameter-beleidschakelaar aan voor een geselecteerd tool.
  2. Het hulpprogramma wordt uitgebreid om alle bijbehorende parameters weer te geven.
  3. Typ een waarde in een parameterveld om deze te vergrendelen. De agent gebruikt deze exacte waarde elke keer.
  4. Laat een veld leeg voor de agent om het tijdens runtime te vullen op basis van context.

Zie beheerde connectoren voor meer informatie over hoe parametervergrendeling werkt.

Goedkeuringsvereisten instellen (machtiging)

Voor elk geselecteerd gereedschap wissel je de Toestemming tussen:

  • Toestaan: Agent wordt vrij uitgevoerd (standaard). Gebruiken voor leesbewerkingen.
  • Vraag: Agent onderbreekt en vraagt uw goedkeuring aan voor elke uitvoering. Gebruiken voor schrijfbewerkingen waarmee resources worden gemaakt, gewijzigd of verwijderd.

Warning

In de autonome modus (geplande taken, HTTP-triggers), wordt elk hulpprogramma dat is ingesteld op Ask , uitgevoerd zonder menselijke goedkeuring. Schakel alleen de autonome modus in voor werkstromen waarvoor u alle ingeschakelde bewerkingen vertrouwt. Zie Uitvoeringsmodi.

Selecteer Next nadat je tools hebt geselecteerd en governance hebt geconfigureerd.

Stap 4: controleren en maken

De stap Review & Create toont een samenvatting:

  • MCP Servernaam (automatisch gegenereerd)
  • Connectoren & Operaties
  • Werking en parametertellingen
  1. Bekijk de samenvatting.
  2. Klik op Creëren.

SRE-agent maakt de connector direct aan. Het verschijnt in je lijst met connectors, en je makelaar kan direct de ingeschakelde tools gebruiken.

Controleren of de connector werkt

Nadat u de connector hebt gemaakt:

  1. Controleer de lijst met connectors. De nieuwe connector moet de status Verbonden weergeven.
  2. Open een chatgesprek met uw agent en vraag het om een van de ingeschakelde bewerkingen te gebruiken.

Als je bijvoorbeeld een notificatiedienst verbindt met een verzendoperatie ingeschakeld:

"Stuur een samenvatting van het laatste incident naar het oproepkanaal"

Een connector bewerken of verwijderen

Edit

Selecteer een bestaande beheerde connector om de wizard opnieuw te openen. U kunt wijzigen welke bewerkingen zijn ingeschakeld, parameterwaarden bijwerken en goedkeuringsinstellingen wijzigen.

Delete

Als u een connector wilt verwijderen, selecteert u deze in de lijst met connectors en selecteert u Verwijderen.

Een beheerde connector instellen met de REST API

U kunt beheerde connectors ook programmatisch maken en beheren met behulp van de REST API.

1. Een token ophalen

TOKEN=$(az account get-access-token --resource https://azuresre.dev --query accessToken -o tsv)
ENDPOINT="https://{agentEndpoint}"

2. Beschikbare connectoren weergeven

curl -s -H "Authorization: ******" \
  "$ENDPOINT/api/v2/connectorV2/managedApis"

3. Bewerkingen ophalen voor een connector

CONNECTOR_NAME="{connectorName}"
curl -s -H "Authorization: ******" \
  "$ENDPOINT/api/v2/connectorV2/connectors/$CONNECTOR_NAME/operations"

Gebruik het operatieantwoord als bron van waarheid voor bewerkingsnamen en parameters. Preview-connectoren kunnen veranderen wat ze teruggeven.

4. Een verbinding maken (OAuth-connectors vereisen aanmelding via de portal)

curl -X PUT -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  "$ENDPOINT/api/v2/connectorV2/connections/$CONNECTOR_NAME" \
  -d '{ "properties": {} }'

5. Maak de configuratie van de MCP-server met governance

curl -X PUT -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  "$ENDPOINT/api/v2/connectorV2/mcpservers/$CONNECTOR_NAME" \
  -d '{
    "properties": {
      "description": "Managed connector",
      "state": "Enabled",
      "connectors": [{
        "name": "{connectorName}",
        "connectionName": "{connectorName}",
        "displayName": "{Connector display name}",
        "operations": [
          {
            "name": "{ReadOperationName}",
            "displayName": "{Read operation display name}",
            "agentParameters": []
          },
          {
            "name": "{WriteOperationName}",
            "displayName": "{Write operation display name}",
            "requiresApproval": true,
            "userParameters": [
              { "name": "{DestinationParameter}", "value": "{Locked destination}" }
            ],
            "agentParameters": []
          }
        ]
      }]
    }
  }'

In dit voorbeeld wordt de leesoperatie zonder goedkeuring uitgevoerd. De schrijfoperatie vereist goedkeuring (requiresApproval: true) en vergrendelt de bestemmingsparameter.

Zie API-naslaginformatie voor de volledige lijst met eindpunten.

Troubleshooting

Issue Oorzaak Repareren
OAuth-pop-up wordt niet weergegeven Pop-upblokkering van browser Pop-ups toestaan van sre.azure.com
De knop Aanmelden blijft uitgeschakeld Machtigingscontrole is mislukt Controleer of u de rol SRE Agent Author of Administrator hebt voor de agent (zie Gebruikersrollen)
Verbindingslijn niet zichtbaar in de kiezer Functie niet ingeschakeld Controleer of de preview van beheerde connectors is ingeschakeld voor uw agent
Agent gebruikt de connector niet Geen bewerkingen geselecteerd Bewerk de connector en controleer of ten minste één bewerking is ingeschakeld
Dynamische vervolgkeuzelijst wordt langzaam geladen De service reageert langzaam Wacht even of typ de waarde handmatig

Verwante inhoud

  • Last updated on