Rollout.io Support Site

Welcome to the Rollout.io Support. You'll find comprehensive guides and documentation to help you start working with Rollout.io as quickly as possible, as well as support if you get stuck. Let's jump right in!

Support    

On-Premise Support

Rollout’s On-Premise Solution

Rollout’s provides an on-premise solution for enterprise companies that want additional security and need full control over the patch deployment process. It provides two important on-premise features:

  • Customer approval before releasing a patch to production devices
  • Signing of patches using a company’s own private key

General Security Background

To ensure patches are not tampered with, Rollout uses a private key / public key security mechanism. When a patch is created it’s signed using a private key. The SDK contains the corresponding public key which is used to authenticate the patch before it’s applied. Additional security information can be found on our security page

Patch deployment process

Initial One-time Setup

  1. Developer downloads the Rollout SDK installer to their local machine.
  2. Developer updates the Rollout SDK with the client’s own certificate (which includes the public key).
  3. Client installs the Rollout on-premise service on their own server.

Creating and Deploying a Patch

  1. Developer logs in to Rollout.io.
  2. Developer creates a patch and tests it using the simulator or test devices.
  3. When the developer moves that hot patch status to production, Rollout's back-end update the Hot patch's status to Pending Production and sends an approval request to the client’s on-premise approval service.
  4. When the client is ready to approve the request, the client’s signs the patch with their own private key.
  5. The client send the patch back to Rollout to a pre-determined endpoint (more details available on the reference implementation's README.md).
  6. Rollout back-end validate the integrity of the patch, change the hot patch's status from pending to production and deploy the patch to the cloud (CDN).

Device Update

  1. When the client’s app is launched on a production device, the device makes a call to Rollout’s CDN and the device downloads the patch.
  2. Rollout’s SDK checks the patch signature using the client’s own public key (which included in the certificate provided by the client).
  3. If the patch is authenticated, it is applied to the app.

On-Premise Support