Cloudflare Docs
Cloudflare Zero Trust
Cloudflare Docs
Cloudflare Zero Trust
GitHub icon
Visit Cloudflare Zero Trust on GitHub
Set theme to dark (⇧+D)
  1. Products
  2. Cloudflare Zero Trust
  3. ...
  4. ...
  5. ...
  6. Configure WARP
  7. Managed networks

Add a managed network

Cloudflare WARP allows you to selectively apply WARP client settings if the device is connected to a secure network location such as an office.

​​ 1. Choose a TLS endpoint

A TLS endpoint is a host on your network that serves a TLS certificate. The TLS endpoint acts like a network location beacon — when a device connects to a network, WARP detects the TLS endpoint and validates its certificate against an uploaded SHA-256 fingerprint.

The TLS certificate can be hosted by any device on your network. However, the endpoint must be inaccessible to users outside of the network location. Therefore, do not choose a private network IP that is exposed to users over Cloudflare Tunnel. One option is to choose a host that is physically in the office which remote users do not need to access, such as a printer.

​​ Create a new TLS endpoint

If you do not already have a TLS endpoint on your network, you can set one up as follows:

  1. Generate a TLS certificate:

$ openssl req -x509 -newkey rsa:4096 -sha256 -days 3650 -nodes -keyout example.key -out example.pem -subj "/CN=example.com" -addext "subjectAltName=DNS:example.com"

The command will output a certificate in PEM format and its private key. Store these files in a secure place.

  1. Next, configure an HTTPS server on your network to use this certificate and key. The examples below demonstrate how to run a barebones HTTPS server that responds to requests with a 200 status code:
Python

To serve the TLS certificate using Python:

  1. Create a Python 3 script called myserver.py:

    myserver.py
    import ssl, http.server
    

    class BasicHandler(http.server.BaseHTTPRequestHandler):
          def do_GET(self):
             self.send_response(200)
             self.send_header('Content-type', 'text/html')
             self.end_headers()
             self.wfile.write(b'OK')
             return
    

    server = http.server.HTTPServer(('0.0.0.0', 3333), BasicHandler)
    sslcontext = ssl.create_default_context(ssl.Purpose.CLIENT_AUTH)
    sslcontext.load_cert_chain(certfile='./example.pem', keyfile='./example.key')
    server.socket = sslcontext.wrap_socket(server.socket, server_side=True)
    server.serve_forever()

  2. Run the script:


    $ python3 myserver.py
nginx in Docker

To serve the TLS certificate from an nginx container in Docker:

  1. Create an nginx configuration file called nginx.conf:

    nginx.conf
    events {
    worker_connections  1024;
    }
    

    http {
       server {
          listen              443 ssl;
          ssl_certificate     /certs/example.pem;
          ssl_certificate_key /certs/example.key;
          location / {
                return 200;
          }
       }
    }

If needed, replace /certs/example.pem and /certs/example.key with the locations of your certificate and key.

  1. Add the nginx image to your Docker compose file:

    docker-compose.yml
    version: '3.3'

    services:

    nginx:
       image: nginx:latest
       ports:
          - 3333:443
       volumes:
          - ./nginx.conf:/etc/nginx/nginx.conf:ro
          - ./certs:/certs:ro

    If needed, replace ./nginx.conf and ./certs with the locations of your nginx configuration file and certificate.

  2. Start the server:


    $ docker-compose up -d
  1. To test that the server is working, run a curl command from the end user’s device:

$ curl -v --insecure https://<private-server-IP>:3333/

You need to pass the insecure option because we are using a self-signed certificate. If the device is connected to the network, the request should return a 200 status code.

​​ 2. Extract the SHA-256 fingerprint

To obtain the SHA-256 fingerprint of a certificate:


$ openssl x509 -noout -fingerprint -sha256 -inform pem -in example.pem | tr -d :

The output will look something like:


SHA256 Fingerprint=DD4F4806C57A5BBAF1AA5B080F0541DA75DB468D0A1FE731310149500CCD8662

​​ 3. Add managed network to Zero Trust

  1. In Zero Trust, go to Settings > WARP Client.
  2. Scroll down to Network locations and select Add new.
  3. Name your network location.
  4. In Host and Port, enter the private IP address and port number of your TLS endpoint (for example, 192.168.185.198:3333).
  5. In TLS Cert SHA-256, enter the SHA-256 fingerprint of the TLS certificate.

WARP will automatically exclude the IP address of the TLS endpoint from all Split Tunnel configurations. This prevents remote users from accessing the endpoint through the WARP tunnel on any port.

​​ 4. Configure device profile

  1. In Zero Trust, go to Settings > WARP Client.
  2. Under Profile settings, create a new settings profile or edit an existing profile.
  3. To apply this profile whenever a device connects to your network, add the following rule:
    Selector Operator Value
    Managed network is <NETWORK-NAME>
  4. Save the profile.

Managed networks are now enabled. Every time a device in your organization connects to a network (for example, when waking up the device or changing Wi-Fi networks), the WARP client will determine its network location and apply the corresponding settings profile.

​​ 5. Verify managed network

To check if the WARP client detects the network location:

  1. Turn on WARP.
  2. Disconnect and reconnect to the network.
  3. Open a terminal and run warp-cli get-alternate-network.