Skip to main content
Table of contents

This is for internal use by the PaaS team. Public-facing documentation is located at

ADR041: BOSH access with mTLS


In ADR040 BOSH access without SOCKS we removed the requirement for using a SOCKS5 proxy or SSH tunnel to access UAA.

We are moving towards a zero trust network model and as part of this are removing the IP allow lists that have been in place.

Discussion has taken place with both IA and with Cyber on the proposed methods after reviewing the RFC created as part of #169915408


We will remove the reliance on IP allow lists for all services on the BOSH Instance.

The IP allow lists will be replaced with Mutual TLS.

This method is one that is prefered by Cyber, as it give a much stronger authentication to the platform. This is due to authenticating both the individual and the machine that are accessing critical services.


Mutual TLS will be implemented on the BOSH Director in order to gain access to the APIs contained. This will be achieved by using a mTLS proxy such as ghostunnel, mTLS-server or HAProxy

The following components will be accessible via provided that there is a valid TLS certificate presented by the client.

  • UAA
  • BOSH
  • Credhub


By passing all the inbound connections through an mTLS proxy we are able to keep multiple authentication factors in play and in the event of a DDoS attack on the proxy it does not place additional load directly on the BOSH Director.




We will no longer rely on IP allow lists when accessing the components on the BOSH Director.

Full alerting can be undertaken by Cyber for this component.

We will not be using SSH access to the BOSH Director when carrying out daily operator tasks which should reduce false alerting within Cyber.