Securing your Vespa installation

It is critical that you understand the security requirements and limitations of any networked system. Vespa is no exception. This document gives the most important information related to security at the network and physical host levels.

To keep your Vespa installation safe, follow the guidelines outlined below:

  1. Isolate the Vespa hosts
  2. Secure the application container with access control filters and TLS
  3. Lockdown directory permissions

Isolating the Vespa hosts

Hosts running Vespa MUST NOT be directly exposed to the public internet or to untrusted networks. Failure to ensure this may lead to data exfiltration/infiltration or host compromise.

Why these stringent requirements?

Vespa’s internal protocols are not authenticated and are therefore not safe in the face of untrusted network actors. When running Vespa in your own organization, or on the public cloud in particular, this is something you must take into account.

Connections to any hosts running Vespa services should only be allowed from a controlled set of trusted hosts. All Vespa hosts must be able to connect to, and receive connections from, all other Vespa hosts that are part of the same installation. For added security, consider limiting Vespa hosts to only be able to talk to other Vespa hosts. If you are contacting external services as part of federation in the application container, your container hosts must be able to connect to these services.

This may be implemented by e.g. iptables, AWS Security Groups or similar technologies.

The entry point into your Vespa installation is port 8080 on hosts running the application container. This port is used for feed, document retrieval and search queries. It should only be exposed to an untrusted network if you have properly secured your application container. It should never be exposed directly to external traffic. All traffic to the containers should be sent by your frontends or backends.

Inter-node communication inside a Vespa installation is not encrypted.

Securing the application container

By default, the container allows unauthenticated writes to, and reads from, the Vespa installation. For a production deployment, this must be locked down.

Connections to the HTTP containers may be protected with TLS. Client certificate authentication is not currently supported.

Access to the container API endpoints can be controlled using request filters. These filters can implement the required authentication and authorization logic for your specific use case.

If you do not set up TLS with restrictive filter logic, you should restrict the container port in the same way as you would the rest of the Vespa hosts.

Locking down directory permissions

All Vespa processes run under the Linux user given by $VESPA_USER and store their data under $VESPA_HOME. You should ensure the files and directories under $VESPA_HOME are not accessible by other users if you store sensitive data in your application.

Vespa does not have support for encryption of on-disk document stores or indexes.