Activation use cases¶
We highly recommend using the manual activation for your first device to understand the process. You can activate the device several times to make yourself familiar with the process. Activating the same device several times won’t change your balance.
You have access to the device¶
- The steps for manual activation when you have access to the device are:
Generate a Runtime Key as explained in the previous sections.
Login to the web application.
Press “Send” to activate.
A new box with the token will appear at the bottom if the operation succeed. Later, you can retrieve the token using the web application (Runtimes page) without repeating the activation process.
Copy the token and put it on a file on the target device.
When you initialize the engine use JSON entry
license_token_fileto set the token. The first option accepts a base64 string while the second requires a path to a file.
This method is time consuming but could be useful when the target device doesn’t have access to internet.
You don’t have access to the device¶
- When you don’t have access to the device their are 2 solutions:
- Solution A:
- Solution B:
Copy the Slave Key.
When the end user runs the application for the first time, redirect him to https://www.doubango.org/LicenseManager/activation.html?slaveKey=Base64Encoded&runtimeKey=Base64Encoded.
The end user will have to follow steps [5, 6 and 7] described in the previous section.
The manual activation is time consuming with poor user experience. You can use the manual activation if your company is the end user with low number of Runtime Keys to activate. If you’re sub-licensing the product to your customers or have a large number of licenses to activate then, it’s definitely not for you.
The automatic activation uses the REST API defined in the previous sections which means the end user must have internet connection. This is only required at the activation time, the first time the application is opened.
The activation server is hosted on Doubango cloud but sometimes you need the end user to connect to your own servers instead of ours. What we recommend in such cases is to host a node.js proxy-like REST API server and let the end user connect to the proxy instead of our cloud.
- Here are the steps for automatic activation:
Copy every Slave Key (Base64) to a file and package it with the application binaries to be sent to the end user. For example, on Android, put the file in “assets” folder.
When the end user opens the application for the first time then, use the REST API to activate the Runtime Key. The Runtime Key is generated on the device using API function
requestRuntimeLicenseKey()as explained in the previous sections. The activation requires a Slave Key and the Runtime Key.