@@ -69,7 +69,7 @@ In this setup, the Teleport SSH Service performs RBAC checks as well as audits a
69
69
configured. This must be done * before* your Teleport cluster is upgraded to Teleport 14.
70
70
71
71
If you are having issues registering OpenSSH nodes or need to upgrade your
72
- Teleport cluster to Teleport 14 before registering all of your OpenSSH nodes, you can
72
+ Teleport cluster to Teleport 14 before registering all of your OpenSSH nodes, you can
73
73
pass the ` TELEPORT_UNSTABLE_UNLISTED_AGENT_DIALING ` environment variable to your
74
74
Proxy Service and set it to ` yes ` . This will allow connections to unregistered
75
75
OpenSSH nodes but will be removed in Teleport v15.
@@ -104,10 +104,19 @@ Change the command-line options to assign the following values:
104
104
- <Var name = " teleport.example.com:443" /> Set to the address and port of your Teleport Proxy Service.
105
105
- <Var name = " (=presets.tokens.first=)" /> Set to the join token value.
106
106
107
- Check that your new node is listed with ` tsh ls ` or in the Web UI. You can edit the
108
- hostname and labels with ` tctl edit nodes/<hostname> ` . If the hostname isn't unique, get the UUID
109
- from ` tctl nodes ls -v ` and edit with ` tctl edit nodes/<uuid> ` . After you've confirmed the node
110
- was registered successfully you can delete the copied ` teleport ` binary.
107
+ Check that your new node is listed with ` tsh ls ` or in the Web UI.
108
+
109
+ You can edit the node with ` tctl edit nodes/<hostname> ` or
110
+ ` tctl edit nodes/<UUID> ` . The node's UUID can be found in the output of
111
+ ` tctl nodes ls -v ` . Be careful when changing the node's hostname, as the
112
+ hostname is a principal embedded in the host certificate that was generated
113
+ with ` teleport join openssh ` . If you want to modify the node's hostname,
114
+ you should either change the hostname of the instance and re-run
115
+ ` teleport join openssh ` , or manually issue a new host certificate with
116
+ ` tctl auth sign --format=openssh ` .
117
+
118
+ After you've confirmed the node was registered successfully you can delete the
119
+ copied ` teleport ` binary.
111
120
112
121
## Step 2/3. Generate an SSH client configuration
113
122
@@ -327,7 +336,7 @@ host's SSH port.
327
336
328
337
<Details title = " Using trusted clusters?" >
329
338
330
- You can log in to a host in a trusted leaf cluster by placing the name of
339
+ You can log in to a host in a trusted leaf cluster by placing the name of
331
340
the leaf cluster between the name of the node and the name of the root cluster:
332
341
333
342
``` code
0 commit comments