Skip to content

Quick start

Currently, Soveren gateway supports deployment with Kubernetes and Docker Compose. If you're eager to test the gateway using a different technology or having any problems, contact us at support@soveren.io.

  1. Add the Soveren token to your Kubernetes cluster.

    Create a gateway, copy the Soveren token displayed next to it, and run: 

    kubectl create secret generic soveren-proxy-token --from-literal=token=<soveren-token-for-the-gateway>

  2. Apply the Soveren gateway manifest and configmap: 

    kubectl apply -f https://raw.githubusercontent.com/soverenio/deployment/master/gateway/kubernetes/install.yaml -f https://raw.githubusercontent.com/soverenio/deployment/master/gateway/kubernetes/replicator-configmap.yaml

  3. Сonfigure Soveren gateway to proxy the traffic for your services.

    Edit the replicator configmap and set the url parameter in the section services to point to your service:

    kubectl edit cm replicator

    replicator configmap example:

       # Add the service
   services:
     upstream:
       loadBalancer:
         servers:
           - url: http://address-of-your-service:port/

    Soveren gateway is based on Traefik. Refer to the Traefik docs if you need more routing options.

  4. Configure your services to route traffic to Soveren gateway.

    Soveren gateway only analyzes traffic with the application/json content type. All other content types just pass through the gateway without any personal data detection.

  5. That's it! Go to the dashboards and start getting insights.

    Also, check the description of available dashboards.

Requirements

Soveren gateway supports Docker Compose v1.27.0 or higher.

  1. Clone the repo containing the configuration files: 

    git clone https://github.com/soverenio/deployment

  2. Add the Soveren token to Docker Compose.

    Create a gateway, copy the Soveren token displayed next to it, and run: 

    export token=‘<soveren-token-from-your-account-on-soveren.io>’

  3. Сonfigure Soveren gateway to proxy the traffic for your services.

    Edit the configs/traefik_configs/conf.d/20-replicator.yaml config and set the url parameter in the section services to point to your service:

    20-replicator config example:

     # Add the service
 http:
   services:
     upstream:
       loadBalancer:
         servers:
           - url: http://address-of-your-service:port/

    Soveren gateway is based on Traefik. Refer to the Traefik docs if you need more routing options.

  4. Apply the Soveren gateway manifest running the command below in the compose repo folder:

    docker-compose up -d

  5. Configure your services to route traffic to Soveren gateway.

    Soveren gateway only analyzes traffic with the application/json content type. All other content types just pass through the gateway without any personal data detection.

  6. That's it! Go to the dashboards and start getting insights.

    Also, check the description of available dashboards.

Back to top