Skip to content

Guide for enabling man-in-the-middle (MITM) interception for Actor Egress policy - #1226

Merged
Max Thompson (thompsonmax) merged 1 commit into
agent-substrate:mainfrom
haiyanmeng:guide-sdsmint
Sep 2, 2026
Merged

Guide for enabling man-in-the-middle (MITM) interception for Actor Egress policy#1226
Max Thompson (thompsonmax) merged 1 commit into
agent-substrate:mainfrom
haiyanmeng:guide-sdsmint

Conversation

@haiyanmeng

@haiyanmeng haiyanmeng commented Aug 26, 2026

Copy link
Copy Markdown
Collaborator

An sdsmint egress gateway terminates every TLS connection an actor opens and re-originates it, so what the actor validates is a per-SNI leaf the gateway minted rather than the origin's certificate. That leaf chains to the gateway CA and to no public root, so an actor left on its default trust store fails every HTTPS request it makes.

Fixes #1005

It's a good idea to open an issue first for discussion.

  • Tests pass
  • Appropriate changes to documentation are included in the PR

@bowei Bowei Du (bowei) left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Small comments. There are some TODOs potentially, but outside of the scope of this doc change.

Comment thread docs/egress-trust-bundle.md
Comment thread docs/egress-trust-bundle.md Outdated
Comment thread docs/egress-trust-bundle.md
Comment thread docs/egress-trust-bundle.md Outdated
Comment thread docs/egress-trust-bundle.md
Comment thread README.md Outdated
Comment thread docs/egress-trust-bundle.md
Comment thread docs/egress-trust-bundle.md
Comment thread docs/egress-trust-bundle.md
Comment thread docs/egress-trust-bundle.md Outdated
Comment thread README.md Outdated
@haiyanmeng haiyanmeng changed the title Guide for making actors trust the egress gateway CA Guide for enabling man-in-the-middle (MITM) interception for Actor Egress policy Sep 1, 2026
@bowei

Copy link
Copy Markdown
Collaborator

Seems like we need replies from Max. Doc looks ok overall otherwise.

@bowei

Copy link
Copy Markdown
Collaborator

(LGTM from me, don't block on my review)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

LGTM with a few nits

Comment thread docs/egress-trust-bundle.md
Comment thread docs/egress-trust-bundle.md Outdated
Comment thread docs/egress-trust-bundle.md Outdated
…ress polic

An sdsmint egress gateway terminates every TLS connection an actor opens
and re-originates it, so what the actor validates is a per-SNI leaf the
gateway minted rather than the origin's certificate. That leaf chains to
the gateway CA and to no public root, so an actor left on its default
trust store fails every HTTPS request it makes.
@thompsonmax
Max Thompson (thompsonmax) merged commit 539a17b into agent-substrate:main Sep 2, 2026
9 checks passed
@haiyanmeng
haiyanmeng deleted the guide-sdsmint branch September 3, 2026 00:30
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.

Publish a guide on how to make actors trust the egress MITM trust bundle

4 participants