Setup Zero-Trust

Follow along with this guide to configure SPIRE in Grey Matter.

This guide will help you set up a secure, zero-trust environment in Grey Matter to achieve the following:

  • Establish trust in user identities

  • Enforce adaptive and risk-based policies

  • Enable secure access to all apps

  • Enforce transaction and data security

Grey Matter uses SPIRE to enable zero-trust security. For more information about how Grey Matter uses SPIRE, see the security documentation.

Learn more about Grey Matter's approach to zero-trust security here.


  • Unix shell and Decipher account

  • helm and kubectl installed

  • A Kubernetes or OpenShift deployment of Grey Matter with SPIRE enabled

    • To do this, install using the Grey Matter Helm Charts with global.spire.enabled true

Learn more about the SPIRE configuration on the SPIRE Server and SPIRE Agent documentation.

Step 1: Install

To install Grey Matter using SPIRE, verify that global.spire.enabled is true (the default) for your helm charts setup and install Grey Matter.

Step 2: Deploy a new service

For a full walkthrough of an example service deployment in a SPIRE enabled environment, see the service deployment guide.

To adapt an existing service deployment to enable SPIRE, add this environment variable to the sidecar container:

- name: SPIRE_PATH
value: "/run/spire/socket/agent.sock"

Then add the following to the deployment volumes:

- name: spire-socket
path: /run/spire/socket
type: DirectoryOrCreate

and mount it into the sidecar container as:

- name: spire-socket
mountPath: /run/spire/socket
readOnly: false

This creates the Unix socket over which the sidecar will communicate with the SPIRE agent.

Step 3: Mesh configurations

There are several updates to make to the mesh configurations for a new service to enable SPIRE. The following describe updates necessary to configure ingress to the service using SPIRE, if your service also has egress actions, check out the Deploy Service for Ingress/Egress Actions Guide.


If you have existing mesh configurations for this service in a non-SPIRE installation, remove any ssl_config from the ingress domain object, but keep force_https to true. The domain should look like the example domain here.


The secret of the listener object is used to configure ingress mTLS using SPIRE.

If you installed Grey Matter using the helm charts, each deployment should have a label with key and value the name of the service (see cluster label). This value will be used to indicate the SPIFFE ID for a sidecar.

Let {service-name} be the value of the label in your service deployment. Add the following secret to your listener object:

"secret": {
"secret_key": "{service-name}-secret",
"secret_name": "spiffe://{service-name}",
"secret_validation_name": "spiffe://",
"subject_names": [
"ecdh_curves": [

Once this is configured, the sidecar will use its SPIFFE certificate for ingress traffic on this listener.

Edge to new service routing

The cluster created for edge to connect to the service will need a similar update for egress traffic to the new service. Remove any ssl_config on the edge-to-{service-name}-cluster and set the secret instead:

"secret": {
"secret_key": "secret-edge-secret",
"secret_name": "spiffe://",
"secret_validation_name": "spiffe://",
"subject_names": [
"ecdh_curves": [

Shared rules and routes should be configured as usual.

Step 4: Test

When you setup services to participate in the mesh, SPIFFE identities are setup for them. This means that the service will get a certificate that is made for that service. As an example of probing into data, you can use openssl to verify that it is setup to use SPIFFE.

In a kubernetes setup, you can find the ip of your deployment with kubectl describe pod {pod-id} | grep IP. Copy this ip and use openssl to check the certificate. You can use openssl from within the data container -

kubectl exec -it data-internal-0 -c data-internal -- /bin/sh

and then to check your service:

openssl s_client --connect {IP}:10808


openssl s_client --connect {IP}:10808 | openssl x509 -text --noout

You should see from the info that the certificate chain and SAN that the certificate your service is presenting is from SPIRE.

You can also verify that SDS is working for your service by execing into its sidecar pod kubectl exec -it {pod-id} -c sidecar -- /bin/sh and running curl localhost:8001/certs. If the sidecar is configured properly, it's SPIFFE certificate will be listed there.


Need help setting up zero-trust security?

Create an account at Decipher Support to reach our team.