Generator - Provider Guide

 

The purpose of this guide is to walk you through some of the setup required on your end with your Amazon Web Services (AWS) account, your Google Cloud Platform (GCP) account, your Microsoft Azure Account, your Digital Ocean account, your Linode account or your Upcloud Account as well as some information on how to use Generator. This should be the first thing you read before using the application as there is some setup required on your part to get things started. Below I will get into a bit of the prep and explain what is required in order to ensure each account is set up and ready to go. 

 AWS | GCP | Azure | Digital Ocean | Linode | Upcloud

Amazon Web Services (AWS)

If you do not already have an account with AWS you are going to need to create one. AWS is great because they give you 750hrs per month of free t2 micro server usage. After signing up for an account and following the steps to authenticate your account you will need to sign in. Once you are signed in you will be greeted with their main console screen. Before we can go into the Generator there are a couple of things that we need. First, we need to visit here then head over to the Security Credentials section which is found under your AWS Profile name

mceclip0.png

Once you get into your Security Credentials screen you will then have to head on down and click on the Access Keys (access key ID and secret access key) tab which will open up to the screen pictured below. Once you have this tab open you will need to press the Create New Access Key


mceclip1.png

Once you have pressed create new access key a prompt will be created where you will be able to see your secret key, access key ID and download a copy of it all. Ensure you keep the downloaded file in a safe place because if it is lost you will not be able to retrieve your secret access key again.

mceclip2.png

Once you have them created you will be able to go over to Generator and under the Credentials view you will click on Create, from the dialog select AWS. This will create a prompt where you will be able to set a nickname for these credentials, you will then be asked to input your Access Key and Secret Access Key and then you can press save.

2020-12-12_22_15_22-Generator_x_Crewie_v2.0.0_EAP_Build_14.png

With all that information saved you will then be able to start using Generator to create servers and proxies for you. 

Google Cloud Platform (GCP)

Google Cloud Platform tends to be a little easier to deal with when it comes to setting up the application. First off you will need to head over to Google Clouds Console once you have created your account or simply signed in please take the time to ensure you have the correct project selected. If you do not have a project please create one now.

Creating a Service Account | Creating a Private Key

Creating a Service Account

If this is a completely new GCP account, you will need to perform some additional steps. You will first need to head over to the side menu on the left-hand side. After opening the side menu, you will need to go down to Compute Engine and then click on VM instances. After clicking on that you will need to select your project from the drop-down menu and then you will need to create and attach a billing profile in order to enable it. After you have done that you will be ready to complete the next steps.

mceclip5.png

 

With the correct project selected you can click this link to head over to the page required to Create a Service Account mceclip4.png

When you get to this screen, you will need to create a Service Account.  If you do not already have one, you will need to input the Service Account name, description and give the account 'Owner' permissions. 

Create_Service_account.png

Once you have inputted the Service account name and description click Create.
Create_Service_account_2.png

You will then need to select a role, click Basic and then select Owner.
Create_Service_account_3.png

Click Continue after giving the Service account the role. 

Create_Service_account_4.png

Click Done to create the service account.

Create_Service_account_5.png

Creating a Private Key

Once you have set up a service account you can now create the private key. In the Service accounts section click the respective email of the service account.

Create_Service_account_6.png

Within the service account section click the header KEYS, and in the Key section, click ADD KEY. 

Create_Service_account_7.png

In the dialog ensure the file type is JSON and then click CREATE in the bottom right. As soon as you click CREATE the .json file will download. Store it in a secure place as it will need to be on the same machine as Generator.

Create_Service_account_8.png

With this file downloaded you can head over to Generator where you will need to go to the Credentials view, click Create, then from the dialog select GCP, and click Next. After pressing next a prompt will appear asking you to set an account name and the file path to the JSON file that Google had you download when you pressed Create. After that press save.
Google_GCP.png

With the credentials saved you will be now able to create servers and proxies using GCP and the provided service account. 

 

Azure

Microsoft Azure, makes use of Microsoft Accounts in order to use their service. If you do not already have a Microsoft Account you will need to create one. Additionally, If you have not already set up a Microsoft Azure account once you sign in you will have to create your Azure Account. Azure heavily limits Trial Accounts, so to generate larger amounts of servers you will have to use a Pay As You Go account.

CreateAccountAzure.png

Once you create your account and verify it using your Phone Number and Credit Card your account will be set up and you can access the Portal Home. Once you have reached the Portal Home you can use the Search Bar at the top to search for App registrations.

AppRegSearch.png

Once in App registrations click on New Registration near the top.

NewRegistrationButton.png

After clicking on that, you will reach the Register an Application screen where you will need to pick a name that is easy for you to identify. This can be anything and can always be changed later. In addition under Supported Account Types make sure you select the third option Accounts in any organizational directory (Any Azure AD directory - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox) and then click on Register at the bottom.

RegistrationDetails.png

After you click on register it will take you to your Registered App. Right away under essentials, you will find your Application (Client) ID, and your Directory (tenant) ID. You can copy these into Generator under Credentials now. You will need to set a Name that is easy to Identify inside of Generator and then copy and Paste your Application ID and Directory ID into the specified places in Generator

AppAndDirectoryID.png

GeneratorAppAndDirID.png

Lastly, in order to create Azure Proxies, you need to create a Client Secret to do that, from the same screen click on Certificates and Secrets on the left-hand side.

CertAndSecrets.png

From there click on New Client Secret, and in the dialog that appears switch the expiry to never and leave the description empty, and click on Add.

AddClientKey.png

After you have created your Secret Key, copy the value field and add it to Generator. It is important to do this now as once you leave this page you will no longer be able to copy this key again and you will have to create a new one.

CopyValueToClipboard.png

SaveClientSecretKey.png

Now before you can generate proxies you need to give yourself permissions to do so. In order to do that Click on Home in the top left and then Subscriptions. 

HomeSubScriptions.png

From here Click on your subscription name.

ClickSubscriptionName.png

Then click on Access Control (IAM) > Add > and then under Add Role Assignment fill out the following information: Role -> Owner, Assign Access to -> User, Group, or Service Principal and lastly under select, type the name of the App you registered in the beginning and select it from the list and press Save.

AddRoleAssignment.png

After you have that setup you can begin to generate proxies using Microsoft Azure!

Digital Ocean

Digital Ocean is great and easy to set up as well. First off if you don’t already have an account you’ll need to head over to Digital Oceans Website and create one. If you already have one simply login and use this link to go to the API section or navigate to it using the menu on the left.

mceclip8.png

Once here, press on the button Generate Token.

 mceclip9.png

 

Here you will simply need to enter a name for your token, ensure that you have checked off the Write permission once you have entered a name press Generate Token.

DO1.png
Within the Generator navigate to the Credentials view, click Create, then from the dialog select Digital Ocean, and click Next. After pressing next a prompt will appear asking you to input the credential's name and your personal access token. After that press save.

DO2.png

Once you have clicked save you will be able to use Digital Ocean to create proxies. 

 

Linode

Linode can be a bit trickier to find where to create your API token for. First off, as always if you do not already have an account you’ll need to head over to Linodes website and create one. You’ll need to verify the email on the account as well as link a billing right away before you can use the account. If you already have an account you’ll need to go ahead and login. Once logged in you can either Click Here to take you to the API Token section under my profile or navigate their manually by clicking on your profile name 

mceclip11.png

Once in My Profile click on API tokens, then click on Add a Personal Access Token and you then you will be able to create a token.

mceclip12.png

Here you will need to create your token name, and select the Select All under read/write access. After that click submit and you will be met with a screen showing you your Personal Access Token.
mceclip13.png

mceclip14.png

You’ll need to save this token so that you can add it to Generator. Ensure you copy and paste it either to a file, or directly into Generator. Within the Generator navigate to the Credentials view, click Create, then from the dialog select Linode, and click Next. After pressing next a prompt will appear asking you to set the credential's name and your personal access token. After that press save.

Linode.png

UpCloud

UpCloud is very easy and simple to setup. Please note, in order to use Upcloud in the Generator, Upcloud requires you to deposit at least $10 into your account. 

First, create an account on UpCloud. The credentials you used to create an account will be used in the credentials section in Generator. Once you have created your account and deposited $10 navigate to your account overview. Under the Permissions tile on your account allow API Key connections from All addresses and then click Save.
2020-12-12_21_55_06-UpCloud___Account.png

 

After that, open Generator. Navigate to the Credentials view, click Create, then from the dialog select UpCloud, and click Next. After pressing next a prompt will appear asking you to input the credential's name, the account username, and the account password. After that press save.
UP.png

Once you have added the credentials you will be able to create proxies using UpCloud! 

 

 

Was this article helpful?
32 out of 40 found this helpful

Comments

0 comments

Please sign in to leave a comment.