Skip to main content

Preview stream

What is the Preview stream?โ€‹

ReversingLabs publishes different versions of the rl-secure CLI tool and makes them available in separate release streams. Two different streams can be used by rl-secure - Production and Preview.

The Production stream is the default stream for working with rl-secure. It requires no special license, so any user with a valid license automatically has access to it.

Users that are a part of the ReversingLabs Partner program can configure rl-secure to run the Preview stream instead by using either the rl-secure config command or the --stream parameter in the rl-scanner Docker image.

The Preview stream is also known as the early access stream limited to users with a special OEM partner license. It contains the upcoming version of rl-secure, so users can test out new features a few days before their official release. This stream is also useful for confirming the compatibility of user integrations with the latest CLI changes.

Prerequisitesโ€‹

Accessing the Preview stream is possible under the following conditions:

  • You have either a locally installed version of rl-secure or the rl-scanner Docker image.
  • You have a valid rl-secure license. For the rl-scanner Docker image you also need the site key.
  • Your company is a part of the ReversingLabs Partner program.
  • You have a suitable OEM license provided by ReversingLabs.

Configure the Preview streamโ€‹

You can configure the Preview stream in:

CLIโ€‹

To switch to the Preview stream in rl-secure, specify the configuration key name (updates) followed by the value you want to set (preview).

You can omit the --key and --value options from the command as long as the key and its new value are provided exactly in that order, one after the other (as illustrated in the Simplified input example).

rl-secure config updates.stream preview

The config command exits without any output when the configuration change is successful.

To confirm your changes have been saved, open the config.info file in the directory that contains your rl-secure executable. The file should include the following:

updates {
stream preview
}

You can also edit the config.info file manually, but it's recommended to use the config command.

rl-scanner Docker imageโ€‹

When scanning your files with the rl-scanner Docker image, the default stream is used implicitly; without any special configuration. If necessary, you can specify which release stream to use.

To do this, use the --stream command-line parameter.

The following command will scan a file using the preview stream.

Docker command with specified stream
docker run --rm \
-u $(id -u):$(id -g) \
-v "$(pwd)/packages:/packages:ro" \
-v "$(pwd)/report:/report" \
-e RLSECURE_ENCODED_LICENSE=<base64 encoded license file> \
-e RLSECURE_SITE_KEY=<site key> \
reversinglabs/rl-scanner \
rl-scan \
--stream=preview
--package-path=/packages/deployment_pkg.tgz \
--report-path=/report \
--report-format=rl-html

Revert to the default stream in the CLIโ€‹

To go back to using the default (Production) stream in rl-secure, you can do so by either:

  • changing the updates key value:

    rl-secure config updates.stream production
  • or deleting the updates key:

    rl-secure config --delete-key updates