Skip to content

fix(apps): log inbound activities at info, warn on missing Authorization#425

Merged
corinagum merged 3 commits into
mainfrom
cg/silent-401
May 21, 2026
Merged

fix(apps): log inbound activities at info, warn on missing Authorization#425
corinagum merged 3 commits into
mainfrom
cg/silent-401

Conversation

@corinagum

@corinagum corinagum commented May 8, 2026

Copy link
Copy Markdown
Contributor

Summary

Test plan

  • uv run poe check (ruff format + ruff check, all pass)
  • uv run pyright src/microsoft_teams/apps/http/http_server.py (0 errors)
  • uv run poe test (580/580 pass)
  • Reviewer eyeball: confirm log message wording

Copilot AI review requested due to automatic review settings May 8, 2026 21:02
…zation header

Inbound activities only logged at debug (and only after auth+parse), and the
missing-Bearer-token path returned 401 with no log line. At default info level
this made it impossible to tell "request never arrived" from "request arrived
and was silently 401'd by the SDK." Adds an info-level entry log on every
inbound and a warn log when rejecting for a missing or malformed Authorization
header.

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds additional diagnostics to the Apps HTTP ingress path (HttpServer.handle_request) to make it easier to determine whether inbound Teams activities are reaching the SDK and why they may be rejected.

Changes:

  • Log an inbound activity summary (type/id) at info level at the start of request handling.
  • Emit a warning when the Authorization header is missing or doesn’t contain a Bearer token (before returning 401).

Comment thread packages/apps/src/microsoft_teams/apps/http/http_server.py Outdated
Comment thread packages/apps/src/microsoft_teams/apps/http/http_server.py Outdated
…ype/id

Addresses Copilot review feedback on #425:
- Activity type/id come from the untrusted request body before auth runs.
  Strip control characters and cap length before formatting them into log
  lines so an attacker cannot forge multi-line log entries.
- Include type/id on the missing-Authorization-header warn, so users running
  at WARNING level can correlate the rejection with a specific activity
  without needing the preceding info entry.

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
@corinagum
corinagum marked this pull request as draft May 8, 2026 21:45
Per review feedback: the info-level entry log on every inbound activity is
redundant with the existing debug log nearby, and operators who want
diagnostic visibility into "did the request reach the SDK" can already get
it by flipping the logger to debug. The genuinely new diagnostic value is
the warn on the missing-or-malformed Authorization header path, which is
silent at every log level today; that stays.

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
@corinagum
corinagum merged commit f5c513e into main May 21, 2026
7 checks passed
@corinagum
corinagum deleted the cg/silent-401 branch May 21, 2026 15:59
corinagum added a commit that referenced this pull request May 27, 2026
## Summary

Brings `origin/main` into `release` for the **2.0.12** release. **No
carve-outs this time** — Quoted Replies (PR #321) is included.

`version.json`: `2.0.11` → `2.0.12`.

Aligns with teams.ts/teams.net cadence.

## What's in this release (delta from 2.0.11)

**Features**
- Quoted Replies & new quotes features (#321) — previously held back
- SuggestedActionSubmitActivity for `suggestedAction/submit` invoke
(#434)
- Default targeted replies for targeted inbound messages (#439)
- Reactions API marked GA (#427) — already shipped in 2.0.11 actually,
ignore if duplicate
- Prompt Preview support (#397)
- Sample: opt targeted-messages into slash commands (#430)
- Sample: a2a-in-teams (#401)
- Sample: proactive message update (#405)
- Allow custom HTTP client via `AppOptions` (#416)

**Security & fixes**
- Lock JsonWebToken trust-boundary contract (#432)
- Bump starlette 1.0.0 -> 1.1.0 for PYSEC-2026-161 / BadHost (#441)
- warn when bot starts without credentials (#435)
- fix(apps): support AAD v1 issuers in Entra token validation (#422)
- fix(apps): log inbound activities at info, warn on missing
Authorization (#425)
- fix(http-stream): wait for in-flight flush before sending final close
(#419)
- Mark reactions API as GA and fix sample remove flow (#427)
- Revert serviceUrl allowlist (ADO 5310460) (#415)
- Route `app.get_app_graph` + `ctx.*_graph` to sovereign endpoints via
`cloud.graph_scope` (#402)

**Deprecations / package changes**
- Remove ai, openai, mcpplugin, a2a, and devtools packages (#413)
- Restore and deprecate devtools package (#410)
- Deprecate ai, openai, mcpplugin, a2a packages (#406)
- Add agent framework example, remove chatprompt/mcp client samples
(#386)

**Dependency bumps**
- urllib3 2.6.3 → 2.7.0 (#426)
- python-multipart 0.0.26 → 0.0.27 (#424)
- microsoft-kiota-http 1.9.7 → 1.9.9 (#423)
- idna 3.11 → 3.15 (#431)
- starlette 1.0.0 → 1.1.0 (#441, security)
- /examples/tab/Web: qs, postcss, uuid, follow-redirects bumps

## Quoted Replies inclusion notes

- Teams client rendering is in-sync with the wire format as of
2026-05-06.
- APX QR rollout completed: Public 2026-04-10, GCCH/DoD/Gallatin
2026-04-14.
- Builder methods (`prepend_quote()`, `add_quote()`), `ctx.quote()`, and
the quote-aware `ctx.reply()` behavior are all present in this release.
- `examples/quoting` is included.

## Conflict resolution

The 2.0.11 release branch had the QR-removed shape for four files; took
`main`'s (QR-included) version for all of them:
- `examples/targeted-messages/src/main.py`
- `packages/api/src/microsoft_teams/api/activities/message/message.py`
- `packages/apps/src/microsoft_teams/apps/routing/activity_context.py`
- `packages/apps/tests/test_activity_context.py`

`version.json` conflict resolved to `2.0.12`.

## Test plan

- [x] `uv sync` clean
- [x] `poe check` (ruff format + lint) — clean
- [x] `poe test` — 609 passed
- [x] `pyright` — 0 errors, 0 warnings
- [ ] Pipeline build + test stages green on `release` after merge
- [ ] Publish pipeline run with **Public** → ESRP approval → PyPI
- [ ] `pip install microsoft-teams-apps==2.0.12` smoke install

---------

Signed-off-by: dependabot[bot] <[email protected]>
Co-authored-by: Aamir Jawaid <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Claude Opus 4.6 (1M context) <[email protected]>
Co-authored-by: Shanmathi Mayuram Krithivasan <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants