Support for on-premises deployments, including those using Containers, ended on December 31, 2023.

For more information, please see our OneSpan Product Life Cycle page, and consult the OneSpan End of Life policy.

For any additional questions contact your Customer Service Representative.

_____________________________________________________________________________________

The following sections describe the steps required to retrieve, re-tag and push OneSpan Sign's container images to a private registry:

1. Contact our Support Team

2. Add the OneSpan Sign Repository to Helm

3. Retrieve, Re-tag and Push Images

4. Customize the Values File

 

• Private registry setups differ somewhat, so this topic's instructions are for informational purposes only. They do not constitute a best practice or a fitness for any purpose.

• Some words In this topic are enclosed in square brackets `[ ]`. The resultant expressions are placeholders, which should be replaced by appropriate content.

Contact our Support Team

You must contact our Support Team to obtain:

• The credentials required to access our jfrog instance

• A list of the images to be pulled

Add the OneSpan Sign Repository to Helm

After you have received the required credentials from our Support Team, add the OneSpan Sign repositories to Helm by running both of the following commands:

helm repo add oss-onprem-helm-local https://onespan.jfrog.io/artifactory/oss-onprem-helm-local/ --username [USERNAME]

helm repo add sign-dev-helm-local https://onespan.jfrog.io/artifactory/sign-dev-helm-local/ --username [USERNAME]

You will be prompted to enter the password that our Support Team gave you.

The umbrella Helm Chart is your explicit configuration contract with OneSpan Sign.

To find the umbrella Helm Chart for OneSpan Sign, use a Helm repo search, as shown here:

helm repo update
helm search repo oss

Update the Helm dependency by running the following command:

helm dependency update oss

The umbrella Helm Chart is located under oss-onprem-helm-local/oss.

Common charts are located at sign-dev-helm-local.

Customizing sub-charts is not supported by OneSpan Sign.

Retrieve, Re-tag and Push Images

After you have added the OneSpan Sign repository to Helm, you can retrieve the images for your OneSpan Sign configuration.

As described above, our Support Team will already have provided you with a list of those images.

To retrieve the images for your OneSpan Sign configuration:

1. Log into the Docker Registry, using the following command:

docker login onespan.jfrog.io

2. Pull each image, using the following command:

docker pull [image]

After you have pulled all the images, you can re-tag and push them to your local registry.

Customize the Values File

To use your locally provisioned images, you must override the following parameters in the values file:

• appMarketingVersion: This parameter should match the version that was provided, or an internal version that you have specified.

• containerRegistry: This parameter should match your local registry.

• repository: This parameter should match the path to the image, and should be specified for any image you use. For example:

  global:
    publicUrl: "my.external.dns.for.oss"
    appMarketingVersion: 22.0.2.0
    containerRegistry: my.jfrog.io/oss/
  
  envoy-load-balancer:
    repository: oss-gateway