# Virbox Protector License (CLI)

## 1. Introduction

For Developer use Virbox Protector CLI tool to protect their software project in project build in process, they can use cloud license (Trial period), soft license or use Hardware dongle (Virbox Elite 5) to be the license container, to login license, bind the license or license key or unbind the license or license key before they use Virbox Protector to protect the software project. In this section, we introduce how to login license, bind license and log out, unbind license when developer use Virbox Protector CLI tools.

## ​2. Virbox Command line tools (CLI tool)

When you install Virbox Protector in your machine, You can find Virbox Protector CLI tool : `virboxprotector_con.exe` in below folder/path (on default directory)

```
Windows:
Commercial release：
C:\Program Files\senseshield\Virbox Protector 3\bin\virboxprotector_con.exe
Trial release：
C:\Program Files\senseshield\Virbox Protector 3 Trial\bin\virboxprotector_con.exe

Linux:
Commercial release：
/usr/share/virboxprotector/bin/virboxprotector_con
Trial release：
/usr/share/virboxprotector-trial/bin/virboxprotector_con

macOS:
Commercial release：
/Applications/Virbox Protector 3.app/Contents/MacOS/bin/virboxprotector_con
Trial release：
/Applications/Virbox Protector 3 trial.app/Contents/MacOS/bin/virboxprotector_con
```

Note：

1）Add the path of`virboxprotector_con` into the system environment variable，you can use the Virbox Protector CLI in the command console directly；

2）If Virbox Protector not add in to the environment variable, you need to specify the absolute path of Virbox Protector CLI tool `virboxprotector_con`, or entry the folder which Virbox Protector `virboxprotector_con` located to execute and protect the project.

## 3. Soft license

Virbox Protector supports 2 kinds of soft license to developer to login/bind with machine:

* Account based soft license
* License key

### 3.1 Use the account based soft license to bind with windows machine

1. Use following command to view help information:

```
virboxprotector_con.exe --help
```

<figure><img src="/files/ihiqKBbvVbTLSp0l862F" alt=""><figcaption><p>Use CLI to view Help info</p></figcaption></figure>

2. Execute following Command to select the type of license：

```
virboxprotector_con.exe -bind
```

1）`Bind with account`

`2) Bind with license key`

When you use the soft license (email account based license), select 1) to bind the soft license with your machine;

When you received a series digital code to activate the Virbox Protector, select 2) to bind the license key with your machine

Here, we select 1)

`Note:`

`Virbox Protector support 2 kinds of Soft license to bind with your machine: Account based soft license and license key, Both soft license and license key supports to use in Online environment and use the license key to bind the machine in offline environment.`

<figure><img src="/files/DMq5hH6gXYQr3fEDCYET" alt=""><figcaption></figcaption></figure>

3. Input your email account and relevant password

<figure><img src="/files/r80xrUYhPi1Z9nlTRlMe" alt=""><figcaption></figcaption></figure>

4. Input email account and password, then it will show and list all of soft license in your account, select and input the number to bind with correspondence soft license, as shown in the sample below (in the sample, we select `7` to bind with correspondence .Net License with machine )

<figure><img src="/files/qiHR5GVK2N5EjwWpzQQw" alt=""><figcaption></figcaption></figure>

5. When bind the license with your machine successfully, then you can use the license at present machine, till the license expired or you want to unbind the license. otherwise, it is not necessary to bind license again.

### 3.2 Use License key to bind license with windows machine

1. Use following command to bind the license with machine

```
virboxprotector_con.exe -bind
```

and select:

`2) Bind with license key`

<figure><img src="/files/x2UFJrYWekxpyLqZ1Jt2" alt=""><figcaption></figcaption></figure>

2. Input the license key to bind the license with your machine

<figure><img src="/files/gNXRRh9iOqT0nEjw1erR" alt=""><figcaption></figcaption></figure>

### 3.3 Bind license key in Linux environment

#### Online Environment

**Activate the license key in online environment**

1. Open terminal windows in Linux system, use following command:

```
ssclt --online_bind_license_key --license_key 26W7-4ZTP-38YP-JRX1
```

The script `26W7-4ZTP-38YP-JRX1` in above is the license key in sample, pls replace with your own license key respectively

2. use command to view if the license has been bind and activate:

   ```
    ssclt --slock 
   ```

   Offline Environment

> When you bind the license key in offline machine, another **online** machine required. this online machine will be used to exchange the d2c file in Virbox User center. The online machine with windows system will be fine. (linux machine also will be fine;)

**Pre requisition**

in your offline machine, pls install Virbox User license tools first.&#x20;

1. Open terminal windows to generate the file contained the offline machine hardware fingerprinting information (c2d file):

   ```
    ssclt --offline_bind_c2d --c2d ./
   ```

   then a file with c2d suffix will be generated under present folder accordingly.

   For example:

   `ZHOUZH-EPC_192.168.0.54_bind_20210428.c2d`
2. Copy this c2d file to another machine in online environment which access internet;
3. in this online machine, visit and access following url to exchange d2c file and input the license key

   <https://user.lm.virbox.com/sn/login.html>

   input the license key you received;

{% hint style="info" %}
For detail process to exchange c2d file in Virbox user center, you may refer process:&#x20;

#### [Virbox Protector License: Offline Environment](/download/virbox-license/virbox-protector-license-gui/virbox-protector-license-offline-environment.md)

Step 2:

Exchange and get d2c file from Virbox User license center
{% endhint %}

1. Use the c2d file generated to exchange d2c file (click input box then you can select the c2d file which saved in your online machine)

   note: d2c file is the file which used to activate Virbox Protector in offline machine.
2. click "exchange d2c file" to download the d2c file to your online machine;

   sample d2c file name is: `ZHOUZH-EPC_192.168.0.54_bind_20210428.D2C`
3. Copy the d2c file and save this file to your offline machine; and execute the command:

   to activate the Virbox Protector license in your offline machine

   View and check the license bind with your offline machine. use the command:

   For more CLI command in Linux system, you can view CLI user manual.

### 3.4 Unbound Soft license

1. Use following command to get and view help information:

```
virboxprotector_con.exe --help
```

<figure><img src="/files/zQRIWGTmarF1Q1W1MtNs" alt=""><figcaption></figcaption></figure>

2. Use following command to view all of soft license bound with your machine, input the correspondence Number to unbind correspondence soft license, input `0` to unbound all of soft license bind with your machine.

   in the sample below, we input `9` to unbind Virbox Protector Java BCE license from the machine

```
virboxprotector_con.exe -unbind
```

<figure><img src="/files/dh8TB7lBZQh9XGLNyuX8" alt=""><figcaption></figcaption></figure>

## 4. Cloud License

1. Use following command to view the help information

```
virboxprotector_con.exe --help=global
```

<figure><img src="/files/QaDeq9bNBMTIYIUrRY9W" alt=""><figcaption></figcaption></figure>

2. Execute following command to login the cloud license:

```
virboxprotector_con.exe -global --username=<> --password=<>
```

<figure><img src="/files/nv3itcjvbxBLl9kguvYP" alt=""><figcaption></figcaption></figure>

3. When you login account successful, then you can use Virbox Protector command line interface tool to protect your project

> Note:
>
> 1. it is mandatory to execute the login license and protect the project in 2 sperate steps. you can not to combine 2 command in one steps;
> 2. When you login the license, and the soft license contained in your account can be bound with local machine.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.virbox.com/download/virbox-license/virbox-protector-license-cli.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.