setup blueprint: identifierUris set to api://<appId> instead of api://botid-<appId>, breaking Teams message delivery
@ajmfehr ci sta già lavorando.
Dal 1/8/2026.
Valutazione
Questa issue non è ancora stata valutata.
Descrizione
Description
a365 setup blueprint / a365 setup all stamps the blueprint Entra app's identifierUris as api://<appId>. Teams requires the botid- prefix (api://botid-<appId>) for Activity Protocol routing and token exchange. Without it, messages sent to an agent instance are silently never delivered to the configured Notification URL — no error surfaces anywhere.
The offending line is BlueprintSubcommand.cs#L1260:
var identifierUri = $"api://{appId}";
applied at L1264 via PATCH /v1.0/applications/{objectId}.
The CLI's own dry-run output disagrees with what it does. Three places print the prefixed form:
PublishCommand.cs#L318—webApplicationInfo.resource -> api://botid-{ClientAppId}, but L353 writeswebInfo["resource"] = $"api://{blueprintId}"NonDwSetupOrchestrator.cs#L61, L95, L96— printsapi://botid-<appId>, but that method is a stub (LogWarningat L50: "not yet fully implemented")
Possible provenance: #191 specified $IdentifierUri = "api://<blueprint-id>" in its repro script, and that appears to have been implemented literally. The botid- text in NonDwSetupOrchestrator looks like a holdover from the classic Azure Bot / App Registration flow, which did apply the prefix — which is why developers who onboarded via the older path never hit this.
Behavior is identical across --authmode obo|s2s|both, --m365, --aiteammate, and standalone setup blueprint.
Expected behavior
identifierUris is set to api://botid-<appId>, matching the CLI's dry-run output, and messages sent to an agent instance reach the configured Notification URL.
SDK Version
1.1.214
Language/Runtime
.NET 8 (a365 CLI global tool); agent runtime Node.js 20 / TypeScript Teams SDK
OS
macOS 14
How to Reproduce
a365 setup all --agent-name <name> --m365- Start a Teams SDK app on a public HTTPS endpoint; set that endpoint as the blueprint's Notification URL (Agent Type: API Based) in Developer Portal
- Publish + activate the generated package via M365 Admin Center
- Create an agent instance from the Teams Store
- Send the instance a chat message
The app receives nothing. No error in the app, in Developer Portal, or from the CLI.
Output
$ az ad app show --id <blueprint-id> --query identifierUris -o json
[
"api://<blueprint-id>"
]
After manually applying the prefix, messages are delivered immediately on the next send:
$ az ad app update --id <blueprint-id> --identifier-uris "api://botid-<blueprint-id>"
Note that once messages do flow, a separate missing-grant problem surfaces as AADSTS65001 naming the instance app rather than the blueprint — which sends you looking at instance consent instead of blueprint inheritance. Filing that separately.
Screenshots
N/A
Code of Conduct
- I agree to follow the Microsoft Open Source Code of Conduct.
- Lingua principale
- C#
- Stelle
- 60
- Fork
- 34
- Merge medio
- 8g 8h
- PR unite (30g)
- 1
Guida per i contributori
Apri la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di microsoft/Agent365-devTools
-
enhancement escalated feature P1 security
microsoft/Agent365-devTools#493 · 3 commenti · 1 assegnatario ·
-
bug escalated P1 security
microsoft/Agent365-devTools#486 · 3 commenti · 1 assegnatario ·
Tutte le issue di microsoft/Agent365-devTools
Issue simili
-
bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 75/100
nightscout/nocturne#1425 ·
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 70/100
RayWangQvQ/BiliBiliToolPro#1137 ·
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 65/100
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 75/100
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 70/100