Skip to main content

Use S3 behind an HTTPS endpoint with a self-signed certificate in Ververica Platform

Jun Qin
  • Updated

Question

I have an S3 compatible blob storage system (e.g., Minio, Scality) which sits behind an HTTPS endpoint with a self-signed certificate. How can I use it as a Universal Blob Storage in Ververica Platform?  

Answer

Note: This article applies to Ververica Platform 2.0-2.8.

You can use Amazon S3 or other S3 compatible blob storage systems with Ververica Platform. If your S3 has an HTTP endpoint or an HTTPS endpoint with a public CA-signed certificate, it will just work with a simple configuration like the one below:

vvp:
  blobStorage:
    baseUri: s3://my-bucket/vvp
  s3:
    endpoint: "http:// or https:// with public CA signed certificate", or
    region: ...

Warning: when configuring `endpoint` or `region`, you must configure only one of them, not both.

If your certificate is a self-signed one, then follow the steps below for applying the additional required configuration.

1. Get your truststore ready

First, make sure your S3 self-signed certificates are valid for the S3 endpoint you want to configure in Ververica Platform.  For example, if your S3 endpoint is `https://minio.minio.svc:9000`, then your self-signed certificates must be valid for the FQDN `minio.minio.svc`

The next step is to get the complete truststore into a file, let's say, vvp.truststore. This could mean

  • (Recommended) add your S3 self-signed certificate and all other self-signed certificates needed by your jobs into the existing `cacerts` bundled with the JVM, e.g., /usr/local/openjdk-11/lib/security/cacerts, or
  • Create a truststore that contains only your self-signed certificates if you are sure that covers all HTTPS endpoints your Flink job will access. 

Warning: as you will see in the later steps, we are going to use the environment variable `JAVA_TOOL_OPTIONS` to set the JVM system property `javax.net.ssl.trustStore`. This means that not including the JVM bundled `cacerts` will prevent your jobs from accessing other HTTPS endpoints with the public CA-signed certificates. Unless you are sure this is the desired outcome, we recommend the first approach above.

For your reference, here are the commands to add your S3 self-signed certificate (`cert.pem`) into the JVM bundled `cacerts`. Skip these commands if you already have your truststore ready.

# retrieve the JVM bundled cacerts from the Ververica Platform's docker image into a local file
docker run registry.ververica.com/v2.10/vvp-appmanager:2.10.0 tar -C /opt/java/openjdk/lib/security/ -cf - cacerts | tar xf -

# add your S3 self-signed certificate 'cert.pem' into the cacerts with an alias 's3cert'
keytool -import -alias s3cert -file cert.pem -storetype JKS -keystore cacerts -storepass changeit -noprompt

# rename as we use 'vvp.truststore' in the rest of this article
mv cacerts vvp.truststore

NOTE: For older releases (e.g. 2.5), the java path in the Ververica platform image may differ. You can try using the following path substitution: /usr/local/openjdk-11/lib/security, if you receive a "No such file or directory" error when executing docker run.

2. Store the truststore in a Kubernetes Secret

You need to store the vvp.truststore into a K8s secret in the same Kubernetes namespace where Ververica Platform is running and also in each namespace where your Flink jobs will run.

# run this for each namespace
kubectl --namespace=<namespace> \
    create secret generic vvp-truststore --from-file=vvp.truststore

3. Configure Ververica Platform

Install/upgrade your Ververica Platform with the following Helm Values file:

env:
  - name: JAVA_TOOL_OPTIONS
    value: "-Djavax.net.ssl.trustStore=/vvp-truststore/vvp.truststore"

volumeMounts:
  - name: vvp-truststore
    mountPath: /vvp-truststore
    readOnly: true
volumes:
  - name: vvp-truststore
    secret:
      secretName: vvp-truststore

For example:

helm install vvp ververica/ververica-platform --version ... \
    --values ... \
    --values <the above values file>​

Once Ververica Platform is (re-)started, go to 'Deployments | Artifacts', you should be able to list/upload artifacts. If you see errors popping up on the UI, check the Ververica Platform logs. The error "unable to find valid certification path to requested target" means your truststore is still not configured correctly. Double-check the above steps, make sure you followed them correctly. You can also use a `keytool` CLI command to list the certificates contained in the truststore: 

keytool -list -v -keystore vvp.truststore -alias s3cert

4. Configure Ververica Platform Deployment

Once the truststore is configured correctly in Ververica Platform, you can now configure your deployment similarly. Each Flink job pod uses an init container called `artifact-fetcher`. It downloads artifacts from the configured universal blob storage before the Flink JobManager/TaskManager container starts and therefore also needs to be configured to use the correct truststore. You can configure the artifact-fetcher by adding the following into your deployment spec:

spec:
  template:
    spec:
      kubernetes:
        jobManagerPodTemplate:
          spec:
            initContainers:
              - env:
                  - name: JAVA_TOOL_OPTIONS
                    value: '-Djavax.net.ssl.trustStore=/vvp-truststore/vvp.truststore'
                name: artifact-fetcher
                volumeMounts:
                  - mountPath: /vvp-truststore
                    name: vvp-truststore
            volumes:
              - name: vvp-truststore
                secret:
                  secretName: vvp-truststore
        taskManagerPodTemplate:
          spec:
            initContainers:
              - env:
                  - name: JAVA_TOOL_OPTIONS
                    value: '-Djavax.net.ssl.trustStore=/vvp-truststore/vvp.truststore'
                name: artifact-fetcher
                volumeMounts:
                  - mountPath: /vvp-truststore
                    name: vvp-truststore
            volumes:
              - name: vvp-truststore
                secret:
                  secretName: vvp-truststore

5. (Optional) Configure Checkpointing&Savepointing to S3 Storage

If your deployment is configured to write checkpoints (or savepoints) to S3 storage which sits behind an HTTPS endpoint with a self-signed certificate, apart from the S3 access credentials, you will also need to add the truststore file to both 'flink-jobmanager' and 'flink-taskmanager' containers in the Flink JM & TM pods. Here's an example (based on Step-4):

spec:
  template:
    spec:
      kubernetes:
        jobManagerPodTemplate:
          spec:
            initContainers:
              - env:
                  - name: JAVA_TOOL_OPTIONS
                    value: '-Djavax.net.ssl.trustStore=/vvp-truststore/vvp.truststore'
                name: artifact-fetcher
                volumeMounts:
                  - mountPath: /vvp-truststore
                    name: vvp-truststore
            containers:
              - name: flink-jobmanager
                env:
                  - name: JAVA_TOOL_OPTIONS
                    value: '-Djavax.net.ssl.trustStore=/vvp-truststore/vvp.truststore'
                volumeMounts:
                  - mountPath: /vvp-truststore
                    name: vvp-truststore
            volumes:
              - name: vvp-truststore
                secret:
                  secretName: vvp-truststore
        taskManagerPodTemplate:
          spec:
            initContainers:
              - env:
                  - name: JAVA_TOOL_OPTIONS
                    value: '-Djavax.net.ssl.trustStore=/vvp-truststore/vvp.truststore'
                name: artifact-fetcher
                volumeMounts:
                  - mountPath: /vvp-truststore
                    name: vvp-truststore
            containers:
              - name: flink-taskmanager
                env:
                  - name: JAVA_TOOL_OPTIONS
                    value: '-Djavax.net.ssl.trustStore=/vvp-truststore/vvp.truststore'
                volumeMounts:
                  - mountPath: /vvp-truststore
                    name: vvp-truststore
            volumes:
              - name: vvp-truststore
                secret:
                  secretName: vvp-truststore

 

Note: Do not confuse the described approach with this documentation section of Ververica Platform which is applicable when your job jar is located directly behind an HTTPS endpoint with a self-signed certificate, not behind an S3 endpoint. In other words, use the Ververica Platform documentation if your `jarUri` is `https://... ` and follow the steps in this Knowledge Base article if your `jarUri` is`s3://...`.

6. Troubleshooting common errors

Unable to execute HTTP request: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target].

This error can sometimes be found in Ververica Platform's gateway logs, artifact-fetcher logs, and even within the UI when attempting to execute a job that requires accessing an artifact stored in an S3-compatible storage endpoint.

To address this issue, please review the previous steps above to ensure you've properly set the configuration parameters for volumes, secrets, and mount paths as well as the validity of the certificate that was imported into the vvp.truststore as part of step #1.

You can use a simple java test locally to verify that the truststore created in step #1 will work against your s3 endpoint.

import javax.net.ssl.SSLParameters;
import javax.net.ssl.SSLSocket;
import javax.net.ssl.SSLSocketFactory;
import java.io.*;

public class CertTest {
    final static String host = "<your-s3-endpoint>";
    final static String port = "<endpoint-secure-port>"; // e.g. 9000
    final static String truststore = "<your-local-truststore-path>";

    public static void main(String[] args) {
      System.setProperty("javax.net.ssl.trustStore", truststore);
      System.setProperty("javax.net.debug", "all");

      try {
        SSLSocketFactory sslsocketfactory = (SSLSocketFactory) SSLSocketFactory.getDefault();

        SSLSocket sslsocket = (SSLSocket) sslsocketfactory.createSocket(host, Integer.parseInt(port));
        sslsocket.startHandshake();

        InputStream in = sslsocket.getInputStream();
        OutputStream out = sslsocket.getOutputStream();
        out.write(1);

        while (in.available() > 0) {
          System.out.print(in.read());
        }
        System.out.println("Successfully connected");
        sslsocket.close();

      } catch (Exception exception) {
        exception.printStackTrace();
      }
    }
}

 

Setting `javax.net.debug=all` option in your configuration can also provide hints as to why the truststore and HTTPS may not be working for your S3 endpoint.

env:
  - name: JAVA_TOOL_OPTIONS
    value: "-Djavax.net.debug=all -Djavax.net.ssl.trustStore=/vvp-truststore/vvp.truststore"

Related Information

Universal Blob Storage in Ververica Platform 

Configure artifact-fetcher to fetch from an HTTPS location with a self-signed certificate 

Related articles