Skip to content
Cloudflare for Teams
Visit Cloudflare for Teams on GitHub
Set theme to dark (⇧+D)

Configure short-lived certificates

Cloudflare Access can replace traditional SSH key models with short-lived certificates issued to your users based on the token generated by their Access login. In traditional models, users generate a keypair and commit their public key into an infrastructure management tool, like Salt, or otherwise upload it to an administrator. These keys can remain unchanged for months or years.

Cloudflare Access removes the burden on the end user of generating a key, while also improving security of access to infrastructure with ephemeral certificates.

New Drop

1. Secure a server behind Cloudflare Access.

To protect a resource behind Cloudflare Access, first follow these instructions to secure the server.

2. Generate a short-lived certificate public key.

  1. On the Teams dashboard, navigate to Access > Service Auth.

  2. In the drop-down, choose the application that represents the resource you secured in Step 1.

    New Cert

  3. Click Generate certificate. A row will appear with a public key scoped to your application.

  4. Save the key or keep it somewhere convenient for configuring your server. You can return to copy this public key any time in the Service Auth dashboard.

    Pub Key Cert

3. Ensure Unix usernames match user SSO identities

Cloudflare Access will take the identity from a token and, using short-lived certificates, authorize the user on the target infrastructure. Access matches based on the identity that precedes an email domain. Unix usernames must match the identity preceding the email domain.

For example, if the user's identity in your Okta or GSuite provider is then Access will look to match that identity to the Unix user jdoe.

For testing purposes, you can run the following command to generate a Unix user on the machine:

$ sudo adduser jdoe

4. Save your public key

  1. Save the public key generated from the dashboard in Step 2 as a new .pub file in your system.

  2. Use the following command to change directories to the SSH configuration directory on the machine:

$ cd /etc/ssh
  1. Once there, you can use the following command to both generate the file and open a text editor to input the public key.
$ vim
  1. In the file, paste the public key generated in Access without any modifications. Save the file. In some systems, you may need to use the following command to force the file to save depending on your permissions.
:w !sudo tee %:q!

5. Modify your SSHD config

Cloudflare Access requires two changes to the sshd_config file used on the target machine.

The first change requires that you uncomment a field already set in most default configurations; the second change adds a new field.

  1. While staying within the /etc/ssh directory, open the sshd_config file.
$ vim /etc/ssh/sshd_config
  1. Navigate to the row named ubkeyAuthentication. In most default configurations, the row will appear commented out as follows:
# PubkeyAuthentication yes`
  1. Remove the # symbol to uncomment the line; keep the setting yes enabled.

  2. Next, add a new line below PubkeyAuthentication as follows:

TrustedUserCAKeys /etc/ssh/

The change above will tell your SSH configuration to use the public key saved in Step 5 for authorizing users. Save the file and quit the editor. You might need to use the following command again to save and exit.

:w !sudo tee %:q!

6. Restart your SSH server

Once you have modified your SSHD configuration, you still need to restart the SSH service on the machine. Commands are provided below that cover servers running systemd, as well. You can execute both.

$ sudo service ssh restart$ sudo systemctl restart ssh

7. Configure your client SSH config

On the client side, follow these instructions to configure your device to use Cloudflare Access to reach the protected machine. To use short-lived certificates, you must include the following settings in your SSH config file.

To save time, you can use the following cloudflared command to print the required configuration command:

$ cloudflared access ssh-config --hostname --short-lived-cert

If you prefer to configure manually, these are the required commands:

Host    ProxyCommand bash -c '/usr/local/bin/cloudflared access ssh-gen --hostname %h; ssh -tt >&2 <&1'
Host    HostName    ProxyCommand /usr/local/bin/cloudflared access ssh --hostname %h    IdentityFile ~/.cloudflared/    CertificateFile ~/.cloudflared/

Advantages of short-lived certificates over legacy public key models

  • Organizational control of keys to infrastructure. Instead of user-generated certificates securing core resources, Access issues short-lived certificates based on a login with your SSO identity provider.

  • Limited certificate lifespans of minutes, not years. In most organizations, a user generates a public key that remains unchanged for years.

  • Lower risk levels in the event of device loss or compromise. A stolen device can still contain SSH keys that permit infrastructure access. Unless the infrastructure is protected by a password, a malicious user can exploit that vulnerability before an organization has time to revoke both the user identity login and the user-generated SSH key.

  • Consolidated access control and offboarding or revocation. Cloudflare Access controls who can reach sensitive resources using your SSO identity provider. When users authenticate with your identity provider, Access generates a JWT scoped to the user and the application.

  • Comprehensive audit logs. Regardless of your infrastructure, whether on-premises, hybrid, or public cloud, administrators can control who can reach what environments in a single place. Audit logs are collected by Cloudflare Access and standardized across any protected resources. These logs let administrators know who accessed what and when.