Skip to content

Commit dbdf70a

Browse files
asamborskiranbel
authored andcommitted
Clarify target and infra app setup (#17243)
* Clarify target and infra app setup * Update ssh-infrastructure-access.mdx Removing redundant link * turn note into partial * revise IP address note --------- Co-authored-by: Ranbel Sun <[email protected]>
1 parent 707d4ea commit dbdf70a

File tree

4 files changed

+18
-7
lines changed

4 files changed

+18
-7
lines changed

src/content/docs/cloudflare-one/connections/connect-networks/use-cases/ssh/ssh-infrastructure-access.mdx

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,11 @@ To connect your devices to Cloudflare:
4949
Next, configure your SSH server to trust the Cloudflare SSH CA. This allows Access to authenticate using short-lived certificates instead of traditional SSH keys.
5050

5151
### Generate a Cloudflare SSH CA
52+
53+
<Render file="ssh/ssh-proxy-ca-note" />
54+
55+
To generate a Cloudflare SSH CA and get its public key:
56+
5257
<Render file="ssh/ssh-proxy-ca" />
5358

5459
### Save the public key
@@ -62,7 +67,7 @@ Next, configure your SSH server to trust the Cloudflare SSH CA. This allows Acce
6267

6368
## 8. Connect as a user
6469

65-
Users can use any SSH client to connect to the target, as long as they are logged into the WARP client on their device. Users do not need to modify any SSH configs on their device. For example, to SSH from a terminal:
70+
Users can use any SSH client to connect to the target, as long as they are logged into the WARP client on their device. If the target is located within a particular virtual network, ensure that the WARP client is [connected to that virtual network](/cloudflare-one/connections/connect-networks/private-net/cloudflared/tunnel-virtual-networks/#connect-to-a-virtual-network) before initiating the connection. Users do not need to modify any SSH configs on their device. For example, to SSH from a terminal:
6671

6772
```sh
6873
ssh <username>@<target IP>

src/content/docs/cloudflare-one/policies/gateway/network-policies/ssh-logging.mdx

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -31,10 +31,7 @@ Cloudflare Gateway will take the identity from a token and, using short-lived ce
3131

3232
Instead of traditional SSH keys, Gateway uses short-lived certificates to authenticate traffic between Cloudflare and your origin.
3333

34-
:::note
35-
36-
Other short-lived CAs, such as those used to [secure SSH servers behind Cloudflare Access](/cloudflare-one/applications/non-http/short-lived-certificates-legacy/), are incompatible with the Gateway SSH proxy. For SSH logging to work, you must create a new CA using the `gateway_ca` API endpoint.
37-
:::
34+
<Render file="ssh/ssh-proxy-ca-note" />
3835

3936
To generate a Gateway SSH proxy CA and get its public key:
4037

src/content/partials/cloudflare-one/access/add-target.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,14 +13,14 @@ To create a new target:
1313
<TabItem label="Dashboard">
1414
1. In [Zero Trust](https://one.dash.cloudflare.com/), go to **Network** > **Targets**.
1515
2. Select **Add a target**.
16-
3. In **Target hostname**, enter a user-friendly name for the target resource. We recommend using the server hostname, for example `production-server`. The hostname does not need to be unique and can be reused for multiple targets.
16+
3. In **Target hostname**, enter a user-friendly name for the target resource. We recommend using the server hostname, for example `production-server`. The hostname does not need to be unique and can be reused for multiple targets. Hostnames are used to define the subset of targets included in an infrastructure application and are not used in DNS address resolution.
1717
<Details header="Format restrictions">
1818
- Case insensitive
1919
- Contain no more than 255 characters
2020
- Contain only alphanumeric characters, `-`, or `.` (no spaces allowed)
2121
- Start and end with an alphanumeric character
2222
</Details>
23-
4. In **IP addresses**, enter the private IPv4 and/or IPv6 address of the target resource. If the IP address overlaps across multiple private networks, select the [virtual network](/cloudflare-one/connections/connect-networks/private-net/cloudflared/tunnel-virtual-networks/) where the resource is located.
23+
4. In **IP addresses**, enter the private IPv4 and/or IPv6 address of the target resource. If the IP address overlaps across multiple private networks, select the [virtual network](/cloudflare-one/connections/connect-networks/private-net/cloudflared/tunnel-virtual-networks/) where the resource is located. This IP address and virtual network pairing is now assigned to this target and cannot be reused in another target by design.
2424
:::note[IP address requirements]
2525
- Public IPs are not currently supported.
2626
- The IP address must be reachable through Cloudflare Tunnel.
Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
---
2+
{}
3+
4+
---
5+
6+
:::note
7+
8+
Other short-lived CAs, such as those used to [secure SSH servers behind Cloudflare Access](/cloudflare-one/applications/non-http/short-lived-certificates-legacy/), are incompatible with the Gateway SSH proxy. For SSH logging to work, you must create a new CA using the `gateway_ca` API endpoint.
9+
:::

0 commit comments

Comments
 (0)