Skip to content

Commit

Permalink
[v17] Machine ID: Document TBOT_USE_PROXY_ADDR (#48672)
Browse files Browse the repository at this point in the history
* Document `TBOT_USE_PROXY_ADDR`

* "1" -> "yes"
  • Loading branch information
strideynet authored Nov 8, 2024
1 parent eb6daa0 commit 7ce2d3c
Showing 1 changed file with 15 additions and 0 deletions.
15 changes: 15 additions & 0 deletions docs/pages/enroll-resources/machine-id/troubleshooting.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -320,3 +320,18 @@ outputs:

Failure to add the `disable_exec_plugin` flag will result in a warning being displayed:
`Destination kubernetes_secret: identity-output must be a directory in exec plugin mode`.

## Configuring `tbot` for split DNS proxies

When you have deployed your Proxy Service in such a way that it is
accessible via two different DNS names, e.g an internal and external address,
you may find that a `tbot` that is configured to use one of these addresses may
attempt to use the other address and that this may cause connections to fail.

This is because `tbot` queries an auto-configuration endpoint exposed by the
Proxy Service to determine the canonical address to use when connecting.

To fix this, set a variable of `TBOT_USE_PROXY_ADDR=yes` in the environment of the
`tbot` process. This configures `tbot` to prefer using the address that you have
explicitly provided. This only functions correctly in cases where TLS
routing/multiplexing is enabled for the Teleport cluster.

0 comments on commit 7ce2d3c

Please sign in to comment.