Getting Started With UbotLocker

Introduction:

Hello and thank you for purchasing UbotLocker. This document aims to guide you in setting up

UbotLocker to protect your bots, and integrating it with Paypal for payment processing. To use

Ubotlocker, you will need the following:

- A PHP/MySQL web server (you can get one cheap at hostgator.com. It is recommended that

the server has cPanel, so that you can follow this tutorial easily.)

- .NET Framework 4

- Ubot

- An FTP client (such as Filezilla).

We will begin by setting up the webserver.

Setting up the Web Server:

First, we must begin by creating a MySQL database that our licensing system will run on. Begin by

logging into cPanel. You should see a screen similar to this one:

Scroll down until you get to the options for Databases and click on “MySQL Databases”

Your will then see the following screen:

We will start off by creating a new MySQL database called “mcaklovi_ubotlocker”. You can call it

whatever you want. Click on the “Create Database” button when done:

You will be taken to the following screen. Just click “Go Back”:

Now we are back at the main MySQL screen. Scroll down until you see the options to Add New User.

We will use it to create a new MySQL user. I used “mcaklovi_ubotloc”, but you can use whatever you

want. Please also remember to write down the password! Click the “Create User” button when you are

done:

You will be taken to the following screen. Just click “Go Back”:

Once again you are back at the main MySQL screen. Scroll down until you get to Add User To

Database. Now add the MySQL user you just created to the database you just created. In my case, I am

adding user “mcaklovi_ubotloc” to the database “mcaklovi_ubotlocker”. Click the “Add” button when

done.

You will be taken to the following screen. Just click on ALL PRIVILIGES at the top, and then click the

Make Changes button.

You will be taken to the following screen. Just click Go Back.

At this point you are done setting up the MySQL database. Now it’s time to set up the actual licensing

website.

First, we need to do some very simple configuration. When you receive UbotLocker, you will receive a

zip file whose contents look like this:

Go to the Web folder and open config.php

The file will look like this:

You want to change the $mysql_user, $mysql_pass, and $mysql_host variables to reflect the information

for the new MySQL database you just connected. You want to change $siteUrl to the domain name of the

site you are hosting the licensing system on. For example, if your licensing system is getting set up on

http://yourdomain.com/UbotLocker/ then you want $siteUrl to be “yourdomain.com”.

Here is what my config file looks like

Save the changes, then fire up your favorite FTP client (I use Filezilla) and connect to your web server.

Upload all the contents of the Web folder to some location on your web server.

Now, in your favorite web browser, navigate to Install.php on your web server. So if you uploaded

everything to http://yourdomain.com/UbotLocker/, then you want to navigate to

http://yourdomain.com/UbotLocker/Install.php. You will see the following screen:

Now go back to your FTP client, and delete “Install.php” and “Update.php” from your webserver. This

is a very important step, so don’t skip it.

At this point you are done with setting up the web server. Now we will review how UbotLocker

works, and how to protect bots and issue licenses.

Setting Up The UbotLocker Project:

Begin by logging into your UbotLocker web interface. For example, if you uploaded the web interface to

http://yourdomain.com/UbotLocker, then you should navigate to http://yourdomain.com/UbotLocker in

your web browser. You will see the following login screen:

When you created the database, the login was set to

Username: admin

Password: ubotlockeradmin

This should be the first thing we change. So log in, and you will be at this screen. Click on “Change

Password” in the top menu.

You will be taken to this screen. Use it to change your password to something other than

“ubotlockeradmin”.

When you are done, click on “Welcome admin” in the top-left corner to go back to the home screen.

Now is the time to create your first UbotLocker project, and to begin distributing licenses. Before we

continue with this tutorial, I want to take a moment to explain how UbotLocker works.

The UbotLocker web interface has “Projects” and “Licenses”. Projects are individual bot projects that are

protected by UbotLocker. Licenses are handed out to users to let them use the Projects protected by

UbotLocker. Licenses can also be automatically issued with Paypal integration. Every time a bot is started

by the user, the License is checked on the UbotLocker server. If everything is ok, the user is allowed to

start the bot. You can also manually revoke a user’s license, or automatically revoke a license when a

user’s subscription expires (again with Paypal integration).

I will now show you how to create a Project, issue a License, and protect a bot with UbotLocker. After

that, I will show you how UbotLocker looks in a protected bot, and how to integrate UbotLocker with

paypal. Let’s begin.

Click on the “Manage Projects” button in the UbotLocker web interface. You will be taken to the

following screen:

Click on the blue button that says “Click Here To Add A New Project To The Ubotlocker System”. You

will be taken to the following screen:

Here you can enter the name of your bot project, and the number of computers each user can install the

bot on. For the purposes of this tutorial, I called the project “testproject” and I let each user install the bot

on 4 computers. The “Project Version” and “Project Update URL” fields are for advanced users who want

to use autoupdates. I will explain them later. Leave them blank for now.

Click the “Add Project” button when you are done. You will be taken to this screen:

Now is the time to protect our bot with UbotLocker. Remember the zip file UbotLocker came in?

Go to the “Desktop” folder and run “UbotLockerGUI.exe”.

You will be greeted with the following screen:

This is where you protect your compiled Ubot .exe file. Fill in the form with the details of your newly

created Project in the UbotLocker Web Interface, and select your compiled Ubot .exe file:

So, Project Name should be the same as the Project Name in the web interface (“testproject” in this

case).

URL To VerifyLicense.php should be the URL of VerifyLicense.php on your web server.

Project Secret Key you should copy/paste out of the UbotLocker web interface.

Input Compiled Bot should be the path to your compiled Ubot .exe. You can select it by clicking the

little […] button.

Project Version is optional and should be ignored for now. It’s useful only to advanced users who want

to update their bots. I will explain it later.

After you’ve filled everything in, click the “Generate” button. It will create 3 files in the same directory

as your compiled Ubot .exe file called “yourbot_locked.exe”, “UbotLocker.dll”, and “License.dll”. These

3 files are your protected bot! Distribute them to your customers when they buy your bots!

Now I will walk you through creating a UbotLocker license manually in the web interface. Navigate back

to the main UbotLocker interface in your browser:

Click on the “Manage Licenses” button. It will take you to the following screen:

Click on the Click Here To Issue A New License button. It will take you here:

Here you can type in the information for a new license. A license key is automatically generated as well.

Here is what I used:

Click the Add License button when done. It will take you back to this screen:

Now just give the “License Email” and “License Key” to your customer. This is all they need to activate

their bot.

How UbotLocker looks to the customer:

The first time a customer runs a protected bot, they will be greeted with the following screen:

Then they should just type in the “License Email” and “License Key” you give them, and the bot will run

normally.

After that, their license details will be saved to their computer, and they will no longer need to enter them

in when they run the bot. Thus, UbotLocker is invisible to the customer and shouldn’t cause any

problems.

Paypal Integration:

UbotLocker comes with support for automatically issuing licenses via Paypal and automatically emailing

the licenses to your users. I will now describe how to integrate UbotLocker with the Paypal IPN.

This tutorial assumes you have a Paypal Premier or Business account.

Begin by logging into your Paypal. Then go to Profile->My Selling Tools

You will be taken to the following screen. Click on the “Update” button next to “Manage my payment

buttons”.

You will be taken to the following screen. Click on the “Create New Button” button.

You will be taken to a screen to create a new Paypal button:

First change “Choose A Button Type” to “Buy Now”.

Next, enter under “Item name” the name of your bot project exactly as it appears in the UbotLocker web

interface. This is super important, so make sure you type it in correctly!!!!!

Finally, enter under Price the amount of money you want to charge for your product.

This is what my form looks like when I’m done filling it out:

Now, scroll down and click on Step 3: Customize Advanced Features.

You will see the following form:

Make sure “Add advanced variables” is checked, and then type into the textbot the URL to

PaymentNotify.php on your web server. This is how Paypal will communicate with the UbotLocker

licensing backend, so make sure you don’t mistype the URL, or forget to check Add advanced

variables!!!!

Here is what the form looks like for me when I’m done filling it out:

Now click Create Button and you will be taken to the following screen:

The textbox contains HTML code for a Paypal button that you can copy/paste into your website. When a

customer buys the bot via this button, a license will automatically be created for him, and sent to his

paypal email. The transaction will also be logged in the “Paypal Logs” portion of the UbotLocker Web

Interface.

As I mentioned before, an email is sent to the user’s Paypal email when they buy the bot, containing their

license information. You can customize this email to say whatever you want. To do so, click on the

Change Email Message button in the UbotLocker Web Interface.

Clickbank Integration

Begin by logging into Clickbank and clicking on “Account Settings” in the top right corner.

Now click on “My Site” in the top right corner:

Now scroll to the bottom. You will see a category called “Advanced Tools”. Click on the “Edit” button on

the top-right corner of the “Advanced Tools” groupbox.

You will be taken to the following page:

Under Secret Key enter some sort of secret password that you can remember. You may only use capital

letters, with no spaces. For the purposes of this tutorial, I used “DASKEY”.

Under Instant Notification URL you want to put in the link to ClickbankPaymentNotify.php on your

webserver.

Under Version you want to select 4.0

Now open a new tab in your browser, and go to the UbotLocker web interface. Once you have logged in,

click on the “Clickbank Info” button in the top right corner of the header menu.

You will be taken to the following screen. Fill in your Secret Key that you entered into the Clickbank

page, and then click “Save”.

Now go back to the Clickbank and click the (test) button.

The following dialog should pop up. If it doesn’t you did something wrong:

Now go back to the UbotLocker web interface, and click on “Paypal Logs” in the top menu header.

In your logs you should see the following transaction:

If it’s there, it means you have successfully set up Clickbank, and it is logging all purchases correctly.

Congratulations, you are now done. The only other thing to keep in mind is that when you are creating

your product, your product name MUST match your project name in UbotLocker.

Aside from that, your Clickbank will be integrated from UbotLocker from now on, and UbotLocker will

automatically send out license details to everyone who purchases your bots, just like with Paypal.

JVZoo Integration

Begin by logging into your JVZoo account. You will be at the below page. Click on “My Account”:

You will be taken here. Click on "Click here to edit JVZIPN Secret Key”

You will be taken to the following form. Enter a Secret Key into it and click “Save”

Now you’re done setting up your JVZoo account. It’s time to set up your product. When setting up your

product, there is just 2 things you need to do.

#1: Make sure your product name matches the project name in UbotLocker

#2: Under “External Program Integration” Enter the correct URL to JVZooPaymentNotify.php

After that, you’re done. Anytime anyone buys the product from JVZoo, UbotLocker will automatically

create a license and send it to them. It also handle subscriptions, chargebacks, and refunds.

Automatic Updates

Automatic updates are a slightly more complicated but powerful feature that can easily let you deliver

updates to your customers. Let’s begin with the testproject we created in the very first part of this tutorial.

If you don’t have a sample protected bot, you should create one to follow along with this tutorial.

Here are the project details of the sample project in the web interface:

Now let’s activate automatic updates in the bot by changing the project version to something other than 0.

Click on the edit button under Project Version. You will be taken to the following screen:

Enter 1.0 to indicate this is the first version of your bot with automatic updates. You must enter some sort

of number. Avoid entering spaces or letters. When done, click on “Submit New Version”.

Your project page should now look like this. Note that the Project Version is now 1.

Now we need to protect a bot with version set to 1.0. This will activate automatic update checking in your

bots. (If version of bot is set to 0, which it is by default, then automatic updates are deactivated for the

bot).

Distribute this bot to your customers. Every time it runs, it will check for an update.

Now let’s say some time has passed, and you want to push out a new update to your customers. Well first

of all, we need to protect the new version of the bot. So take your compiled bot, protect it, and during

protection set Project Version to something higher than the previous project version (1.0). The only thing

you need to keep in mind is that the .exe filename of the bot must be the same as in the previous version!!

Otherwise the bot will not be able to restart itself when it updates!!

Now take the protected bot files, and store them into a zip archive. This zip archive should contain all the

files of your update:

Now upload the zip file (in this case update.zip) to a web server. Save the URL somewhere. With that

being done, go to the UbotLocker web interface, and view your project details:

Now use the edit buttons to change the Project Version to 1.1 and Project Update URL to wherever

you uploaded the zip file containing the update. When typing in the URL, please double check that you

are typing in a valid url in the form of: http://somedomain.com/update.zip. !!!

And now you’re done! Whenever a user runs their bot from now on, if it is an old version (1.0) it will

detect an update is available (1.1). It will then proceed to download the update from your web server,

unzip it, and then restart itself to run the new version of the bot:

And that’s that! If you have any questions, don’t hesitate to PM me (meter) on the Ubot forums. You can

also email me at my personal email: mcaklovi *AT* gmail *DOT* com