pomerium / pomerium / 26511145226

52%

Build Type

push

github

Committed by web-flow

Commit Message

core/config: add internal-address, envoy admin to config (#6353)

## Summary
Add a new `netutil.InternalAddress` type to represent an address
suitable for communication between Pomerium components or between
Pomerium and Envoy. This type has several methods:

- `Listen`: to start a network listener on the address
- `Dial`: to create a network connection to the listener
- `EnvoyAddress`: to convert the address into an envoy address protobuf
type

Internal addresses are represented by a URL. There are currently 3
supported address types:

- Unix socket addresses: `unix:/example`
- Abstract unix socket addresses: `unix-abstract:example` (same as
`@example`)
- TCP addresses: `tcp://127.0.0.1:1234`

The default behavior is to create an abstract UUID socket on linux and a
filesystem UUID socket (in the temp dir, or `POMERIUM_SOCKET_DIRECTORY`)
on macos.

This internal socket is used for the envoy admin interface. The listener
will be created by envoy and exposed by envoy if the admin address is
set. It is also used for draining connections.


## AI disclosure
none

## Checklist

- [ ] reference any related issues
- [x] updated unit tests
- [x] add appropriate label (`enhancement`, `bug`, `breaking`,
`dependencies`, `ci`)
- [x] disclosed AI usage (or wrote "none") per AI_POLICY.md
- [x] ready for review

Coverage Stats

84 of 112 new or added lines in 5 files covered. (75.0%)

2 existing lines in 2 files now uncovered.

36746 of 80148 relevant lines covered (45.85%)

305.81 hits per line