To streamline license deposits for your customers who prefer iLok licenses, you may use the native iLok integration found in Moonbase. It allows your customers to link their iLok account, at which point the integration will:

• Deposit any pending licenses into their account

• Any future purchases will immediately deposit a license into their account

• Existing licenses they may have are imported into Moonbase

In this article, you can learn how to configure this integration, including caveats that you should be aware of. Using this integration will incur no additional fees on your Moonbase account, but may require paid features from PACE like API access and OAuth setup.

Getting started

Since Moonbase will both interact with the iLok APIs to manage licenses, but also authenticate iLok accounts in order to link them to their Moonbase customer account, you need two things:

1. API key

2. OAuth configuration

You can create an API key yourself by opening PACE Central, and heading to Developer > License Servers & Access Keys. Start by creating a new server, then add a key to this server. Be sure to copy the API key when possible, to add to your Moonbase configuration.

Next, you need to register a OAuth client, in order for your customers to be able to link their account. To do this, you need to reach out to PACE Support directly, asking for a OAuth client with the redirect URI specified in the iLok configuration part of the Moonbase app:

You should receive a OAuth client ID and secret, which can be added to your iLok configuration in Moonbase, after which you can enable the integration.

Configuring products

Once you have a configured iLok integration set up, you will find a new license generator to use for your products, in the “Fulfillment” section:

This is also where you must map your Moonbase product to the iLok counterpart. Any licenses fulfilled through Moonbase will be deposited for this iLok product by default, unless you override it on a price variation.

Configuring pricing variations

To make sure the different variations of your Moonbase product deposit the correct licenses, you can configure that on the pricing variation by creating or editing a variation:

The iLok tab will then allow you to set a SKU or specify the terms to be used when depositing licenses:

It’s important to pick the right SKU or term to ensure that the iLok license server will accept license deposits for all your customer purchases.

Customer journey

Having a smooth user experience towards purchase, installation and activation is an important feature of Moonbase, and we’ve made sure the iLok integration is no different. No matter how customers receive new licenses, be that purchases they make, vouchers they redeem or licenses provisioned through our APIs or by hand, all licenses that need an iLok license will start out in a “Pending” state. Then, as soon as your customer completes their account, they will be asked to connect their iLok account:

This example is from our Embedded Storefront, meaning customers start this authentication flow directly from your website. When they approve the connection on the iLok website, they will be redirected back to your website, where they will be informed about any licenses being deposited.

Automatic imports

Whenever a customer connects their iLok account to your Moonbase account, we will automatically import all their existing licenses from their iLok account, if you have configured your Moonbase products with a matching iLok product. This means you will get the benefits of Moonbase like customer segmentation, exclusive discounts, partial bundle purchases and much more out of the box with no manual migration necessary. It also means that customers will be able to see all their owned products on your website, being able to download them directly as long as they own at least one license for that product.

Trials

Your iLok-integrated products likely already support on-demand trial deposits from your customers, and with the Moonbase integration active, these will be synced to your Moonbase account when customers connect their account. If you choose to expire or extend trials in the Moonbase app, and that trial is connected to an iLok trial license, we will either revoke that iLok license, or deposit a new trial license to the customers iLok account. This also applies when extending all trials for a product.

Caveats

Since Moonbase and iLok are two very different systems, with different business models, some Moonbase features may be incompatible with your iLok account terms. This is particularly true for licenses deposited due to either a voucher redemption, automatic provisioning using our APIs, or a manually created license in the Moonbase app. None of these are attached to a financial transaction, and thus will have an accounting value of zero. If your iLok account is not set up to allow for free licenses, then this may fail the deposit, and disrupt the customer journey.

Frequently Asked Questions