Table of Contents

INSTALL CHARLES .................................................................................................................................... 3 Before you begin ................................................................................................................................. 3 Are you running 32 bit or 64 bit? .................................................................................................... 3 Install Java Runtime Environment .................................................................................................. 5 Download and Install Charles ............................................................................................................. 7 Mozilla Firefox Proxy Configuration.................................................................................................. 11 Automatic...................................................................................................................................... 11 Manual .......................................................................................................................................... 12 INSTALL NEW SECURE BOT OR APPLY THE PATCH................................................................................ 13 Replace your bot with the new version ............................................................................................ 13 SET UP CHARLES FOR SECURE BROWSING ........................................................................................... 14 Install Charles CA SSL Certificate (Export ) ........................................................................................ 14 SET UP CHARLES FOR BOTS ................................................................................................................... 15 Map Remote Settings........................................................................................................................ 15 Proxy SSL Settings ............................................................................................................................. 20 Install Charles Certificate in Internet Explorer under Trusted Root Certificates .............................. 22 HOW TO USE CHARLES WITH BOTS WITH SECURE BROWSING............................................................ 27 Bots ................................................................................................................................................... 27 SETTINGS FOR USING CHARLES FOR REQUESTS ................................................................................... 28 Import Charles SL Certificate into Waterfox/Firefox ........................................................................ 28 Import Certificate into Chrome......................................................................................................... 31 Add SSL Proxy to FB-FB-0.castle.zynga.com ..................................................................................... 32 Change Rewrite Settings ................................................................................................................... 34 Charles Settings................................................................................................................................. 36 HOW TO USE REWRITE TO REQUEST ITEMS ......................................................................................... 37 Before You Begin............................................................................................................................... 37 How to find your UID .................................................................................................................... 37 How to use Rewrite........................................................................................................................... 37 Rules Settings ................................................................................................................................. 40 ITEM COUNT ................................................................................................................................. 40 | Imperial Manual for Secure Browsing 1

Send FROM (acct you are in)......................................................................................................... 41 Send TO (acct you are sending to) ................................................................................................ 42 ITEM CODE .................................................................................................................................... 43 Additional rules ................................................................................................................................. 43 Send the request ............................................................................................................................... 44 Breakpoint On ............................................................................................................................... 44 Send the request ........................................................................................................................... 44 Breakpoint Off ............................................................................................................................... 45 TROUBLESHOOTING .............................................................................................................................. 47 Bot wont start .............................................................................................................................. 47 Certificate Errors ............................................................................................................................... 47 Internet Explorer ........................................................................................................................... 47 Waterfox/Firefox........................................................................................................................... 48 Rewrite Troubleshooting Checklist Common Problems ................................................................ 49 Unlock your Castleville Inbox Solution ............................................................................................. 49

| Imperial Manual for Secure Browsing

INSTALL CHARLES
These instructions will guide you through installing a 30-day trial version of Charles Web Debugging Proxy.

Before you begin

1. You must know if you are running Windows 32 bit or Windows 64 bit. 2. You must have either Firefox browser (for 32 bit) or Waterfox browser (for 64 bit) installed. 3. You must have Java Runtime Environment installed.

Are you running 32 bit or 64 bit? To find out whether you are running 32 bit or 64 bit: Click the START button at the bottom left of your screen Right-click Computer and select Properties Check the System Type in the System window.

| Imperial Manual for Secure Browsing

| Imperial Manual for Secure Browsing

Install Java Runtime Environment To download and install Java Runtime Environment: Go to www.java.com/en/download Click Free Java Download

Click Agree and Start Free Download button. Double-click the downloaded file and the installation will open.

| Imperial Manual for Secure Browsing

Click Install button on the Welcome to Java window.

After the installation, you will be asked if you wish to install the free browser add-on from Ask. Clear the checkbox for Install the Ask Toolbar and make Ask my default search provider Click Next button

After the installation, the following window is displayed. Click Close

| Imperial Manual for Secure Browsing

Download and Install Charles

To download Charles: Navigate to the following website from your browser: http://www.charlesproxy.com/ Click on the link to Download a free trial

| Imperial Manual for Secure Browsing

Click the link to download the version that is correct for your Windows system either 32 bit or 64 bit.

After the file is downloaded: Double-click on the downloaded file to begin the installation. Click the Run button.

Click Next button at the Welcome window.

| Imperial Manual for Secure Browsing

Check the box for I accept the terms in the License Agreement and click Next botton

Click the Next button on the Destination Folder window. Do NOT change the default folder location unless you are an experienced computer user and have a reason for doing so.

| Imperial Manual for Secure Browsing

Click Install button.

Wait while the program installs. Click Finish button when installation is finished.

| Imperial Manual for Secure Browsing

10

Mozilla Firefox Proxy Configuration

Note: Depending on the version of Charles, the following steps might happen automatically or you might need to run them manually. Automatic After installation, Charles should open automatically. Open Firefox or Waterfox browser. Click Install at the Mozilla Firefox Proxy Configuration window.

Click OK to restart Firefox.

| Imperial Manual for Secure Browsing

11

Manual If you are not prompted for the Firefox addin: Navigate to www.charlesproxy.com and click the link download and install the add-on manually.

A 30-day trial version of Charles Web Debugging Proxy is now installed on your computer.

| Imperial Manual for Secure Browsing

12

INSTALL NEW SECURE BOT OR APPLY THE PATCH

You can either replace your bots with the latest version that has the relevant patch applied, or you can apply the patch yourself.

Replace your bot with the new version

Download the full Secure Castleville Bot from your group Navigate to the location where your bot is currently installed Replace your old bot with the new one (either delete and copy or overwrite existing files)

Apply the patch Download the patch from your group Navigate to the location where your bot is currently installed o Copy the options.txt file into the main bot location o Replace the codebase-php folder with the new one, which contains the new files

Note: After you apply the patch, change the Settings to your OWN timezone and make sure the Use proxy box is ticked.

| Imperial Manual for Secure Browsing

13

SET UP CHARLES FOR SECURE BROWSING

Install Charles CA SSL Certificate (Export )
Open Charles Click Help | Install Charles CA SSL Certificate

Click Install Certificate

| Imperial Manual for Secure Browsing

14

Click Next, Next, Finish. When the Import Was Successful popup is displayed, click OK.

SET UP CHARLES FOR BOTS

Map Remote Settings
This section explains how to map remote settings for the following locations: fb-client-0.castle.zynga.com zynga?-a.akamaihd.net fb-fb-0.castle.zynga.com To map the remote settings in Charles: Select Tools | Map Remote

| Imperial Manual for Secure Browsing

15

Click to Enable Map Remote Click Add.

The Edit Mapping box is displayed.

| Imperial Manual for Secure Browsing

16

In this box you will add the map https to http for fb-client-0.castle.zynga.com Enter the details EXACTLY as shown in the next screenshot and click OK.

| Imperial Manual for Secure Browsing

17

Your remote settings should now look like this:

Add the mappings for the following zynga?-a.akamaihd.net fb-fb-0.castle.zynga.com

| Imperial Manual for Secure Browsing

18

You will now have the three enabled maps as shown in the next screenshot.

| Imperial Manual for Secure Browsing

19

Click OK.

Proxy SSL Settings

This section explains how to add the following proxy SSL locations: fb-fb-0.castle.zynga.com:443 fb-client-0.castle.zynga.com:443 *.castle.zgncdn.com:443 zynga?-a.akamaihd.net:443 To add the proxy SSLs: Click Proxy | Proxy Settings

| Imperial Manual for Secure Browsing

20

Click SSL tab and then click Add. Enter each location and port and click OK.

| Imperial Manual for Secure Browsing

21

After all four are added, your proxy settings will look like this:

Click OK.

Install Charles Certificate in Internet Explorer under Trusted Root Certificates

To install the Charles SSL certificate in Internet Explorer: Open Internet Explorer Click on Tools | Internet Options | Content Click Certificates Click on Trusted Root Certification Authorities tab.

| Imperial Manual for Secure Browsing

22

Click Import

| Imperial Manual for Secure Browsing

23

Click Next

Navigate to the Doc folder below the Charles folder, then select the file Charles-proxy-sslproxying-certificate.crt and click Open.

The file is now displayed in the following windows. | Imperial Manual for Secure Browsing 24

Click Next

Accept the default to place all certificates in the Trusted Root Certificate store and click Next.

| Imperial Manual for Secure Browsing

25

Click Finish

Click Yes to accept the security warning

| Imperial Manual for Secure Browsing

26

Click OK and close the Certificates window.

HOW TO USE CHARLES WITH BOTS WITH SECURE BROWSING

Now that everything is set up, you can go ahead and use the bots.

Bots
NOTE: The big difference is that you must run Charles while you are running your bots. To run BOTS: 1. Run Charles 2. Enable Remote mapping select Tools, Map Remote, Enable Map Remote 3. Disable Rewrite select Tools, Rewrite, remove checkbox from Enable Rewrite 4. Optional Disable Recording and Breakpoints (your bots should run faster this way) 5. Open your bot and run links or neighbour visits

| Imperial Manual for Secure Browsing

27

SETTINGS FOR USING CHARLES FOR REQUESTS

Note: If you only run bots, there is no need to go any further.

Import Charles SL Certificate into Waterfox/Firefox

Open Waterfox Click Tools, Options.

Click the Advanced icon, click the Encryption tab and View Certificates button.

| Imperial Manual for Secure Browsing

28

Click Import to import the SL Certificate you just exported.

| Imperial Manual for Secure Browsing

29

Browse to C:\Program Files\Charles\Docs, highlight the file and click Open to import the Certificate from Charles

Click OK to close the Certificate Manager window and close the Options window

| Imperial Manual for Secure Browsing

30

Import Certificate into Chrome

Open Google Chrome Go to Options

Scroll Down and click Advanced Settings

| Imperial Manual for Secure Browsing

31

Click on Manage Certificates, Import, Next, and browse to C:\Program Files\Charles\Doc

Click Open, Next and Finish. The import was success popup is displayed. Close the import windows.

Add SSL Proxy to FB-FB-0.castle.zynga.com

Add: fb-fb-0.castle.zynga.com:443 under Proxy, Proxy Settings, SSL and Breakpoints.

Note: The easiest way to do this is to start Charles, log in your AKA, start Castleville, send any request and when you see that address on left side, right-click and select SSL and Breakpoints. Next time you start Charles, they will be under appropriate listings.

| Imperial Manual for Secure Browsing

32

When done, check your Breakpoint Settings by going to Proxy, Breakpoints. It should look like this:

| Imperial Manual for Secure Browsing

33

Check your SSL settings: Click the gear icon (far right of Charles menu), Proxy Settings, SSL tab.

Change Rewrite Settings

Change your Rewrite settings to secure mode.
Click Tools, Rewrite. Select each rule, double-click the Locations in the top box and change the settings to Protocol https and port 443.

| Imperial Manual for Secure Browsing

34

You must do this for every Rewrite Rule you want to use from now on.

| Imperial Manual for Secure Browsing

35

If everything is right, you will see this when using Breakpoint before a request. Its a good idea to do this to verify everything is working correctly.

Charles Settings
To run Charles REQUESTS: 1. Run Charles 2. Disable Remote mapping select Tools, Map Remote, remove the checkbox from Enable Map Remote 3. Enable Rewrite select Tools, Rewrite, click checkbox to Enable Rewrite

| Imperial Manual for Secure Browsing

36

HOW TO USE REWRITE TO REQUEST ITEMS

Before You Begin

Before you can use Rewrite, you must prepare. 1. INSTALL CORRECT BROWSER - Waterfox or Mozilla browser is installed
2.

DOWNLOAD XML FILE This will really help you because it contains a basic set of rules you can use. Download the Imperial Rules.xml file to your desktop and have it ready to import (available from group) Note: Other XML files are available and after you understand the settings described in this document you may wish to use another.

3. ITEM CODES are available here http://www.castlevillepolska.pl/page.php?al=itemsall. 4. HAVE YOUR UID number and your aka's UID number handy. (see How to Find Your UID)

How to find your UID

How to use Rewrite

1. 2. 3. 4. Start Charles Web Proxy. Start Facebook. Start Castleville (use the Facebook application, not Zynga) In Charles: Make sure the Recording button is switched on and Breakpoint is off.

| Imperial Manual for Secure Browsing

37

Click on Tools in the menu bar and then click Rewrite. The Rewrite Settings box is displayed. Click Enable Rewrite (if not already enabled) Click the Import button and navigate to where you downloaded the Imperial.xml file. If you did not already download this file, it is available here: https://www.dropbox.com/s/ao9lk0g08lo4pyb/Imperial.xml Note: You only need to import the Imperial.xml file the first time you use Rewrite.

| Imperial Manual for Secure Browsing

38

| Imperial Manual for Secure Browsing

39

Rules Settings
ITEM COUNT 1. In Charles: Click ITEM COUNT to select the settings. Double-click on the rule to open the Rule. Place a tick in the one you want to use. The top rule requests one item and the bottom rule requests 25. Note: Only one rule can be ticked at a time. Click OK.

| Imperial Manual for Secure Browsing

40

Send FROM (acct you are in) This is the UID of the account you are sending from and you are IN. 2. In Charles: Click Send FROM to select the settings. Double-click on the rule to open the Rule. Edit the value to replace %22uid-goes-here%22 with %22(your dummy Zynga Userid)%22 Click OK. Note: Every request you send from will be from this Zynga Userid until changed.

| Imperial Manual for Secure Browsing

41

Send TO (acct you are sending to) This is the UID of the account person/account you are sending TO. 1. In Charles: Click Send TO Double-click the rule Edit the value to replace %22uid-goes-here%22 with %22(your/neighbor Zynga Userid)%22 Click OK. Note: Every request you send will be to this Zynga Userid until changed.

| Imperial Manual for Secure Browsing

42

ITEM CODE This section contains the settings for the item you will match and replace. For example, if you click on the Valentine Shop in your game and request pink lace and you really want celestial blessings, you will match PinkLaceMaterial_01 and replace it with CelestialBlessingCraftable_01. 1. In Charles: Click ITEM CODE Double-click the rule In the Match section, edit the value with the item being replaced. This example uses PinkLaceMaterial_01. In the Replace section, edit the value with the item being replaced. This example uses BrassNuggetMaterial_01 Click OK. Note: You can request any item here provided you have the code.

Additional rules
You can add additional rules (settings) for different items or different UIDs. The following shows how to add a new Item Code rule. 1. In Charles: Click Tools and Rewrite from the menu bar. Click Item Code to select it. Click the Add button to add a new rule. A blank rule screen is displayed. Use the drop-down to select Type = Body Make sure both checkboxes in the Where section are ticked Enter the code for the item you will replace in the Match value field Enter the code for item you want in the Replace value field Click OK.

| Imperial Manual for Secure Browsing

43

You will now see the second rule is added.

Send the request

Breakpoint On This is optional but if you are having any problems, you might want to use the breakpoint on/off to check whether Charles is working. Click to switch on both the Recording and Breakpoints buttons. You will see in the bottom right corner whether they are on or off.

Send the request 1. In Castleville: Click on the Valentine Shop (or building you set up for) and send your request.

| Imperial Manual for Secure Browsing

44

Breakpoint Off If breakpoint is on, Charles will pop up and show you the breakpoint. This shows that the request has been sent and Charles is ready to intercept. Click Breakpoint button to turn it off and click the Execute button Optionally, you can check that the snapi_proxy.php in the Structure box has a blue ball next to it.

| Imperial Manual for Secure Browsing

45

1. In Castleville: Wait a few moments and click your Inbox to receive your items. Click to receive the item and it will send it along.

| Imperial Manual for Secure Browsing

46

TROUBLESHOOTING
Bot wont start If everything is set up correctly but your bot wont start, the problem might be because youre the Use Proxy setting is not ticked. Open your bot Click on the Settings tab Make sure Use proxy is ticked and make sure your OWN timezone is selected Click Save Settings and Refresh

Certificate Errors
Certificates must be installed in Internet Explorer and the browser you use whether Waterfox/Firefox and/or Chrome. Internet Explorer To check the certificate in Internet Explorer. Open IE Navigate to Tools, Internet Options, Content (tab), Certificates (button), Trusted Root Certification Authorities (tab) Check that the certificate is installed.

| Imperial Manual for Secure Browsing

47

If it isnt, Import the certificate, navigate to \Program Files\Charles\Doc and import the certificate.

Waterfox/Firefox Check the Certificate in Waterfox/Firefox: To edit the certificate in Waterfox: Click Tools, Options, Advanced (gear), Encryption (tab) Click View Certificates and click on the Authorities tab. Scroll down to XK72 Ltd and highlight Charles Proxy SSL Proxying Click Edit Trust and make the top and bottom options are checked

| Imperial Manual for Secure Browsing

48

If you are still having problems, you can try deleting and reinstalling the certificate. To delete the certificate in Waterfox: Click Tools, Options, Advanced (gear), Encryption (tab) Click View Certificates and click on the Authorities tab. Scroll down to XK72 Ltd and highlight Charles Proxy SSL Proxying Click Delete or Distrust and OK Follow the prompts to delete.

To reinstall the certificate: Click Import Navigate to \Program Files\Charles\Doc Highlight the certificate, click OK Click to accept prompts and windows.

Rewrite Troubleshooting Checklist Common Problems

Having trouble with Rewrite in Charles? Check the following things and theres a very good chance youll find the problem: 1. Check your UIDs are correct, they should always be BETWEEN two sets of %22 and have no spaces. 2. Make sure you have no clashing rules. 3. Check that the problem isnt within Castleville. Are your gift requests being sent?

Unlock your Castleville Inbox Solution

Has your Castle Mailbox locked up? Is it due to sending bad code in Charles or some other reason? Here is SIMPLE FIX - Fancy Gaming Simplifier Extension for Chrome or Firefox. Follow the directions in the web site.
http://fgfz.weebly.com/fgs.html

| Imperial Manual for Secure Browsing

49

Once installed: Click on the FGS up at the top of your browser and hit open gift list. Enable Castleville, then Click on Gifts Select Clear Everything or Select and Clear the ones you think may be causing your issue. Typically it will be some special item you either tried to send to yourself or someone else did. Go back to your game. Note - you do not have to have Castle running, just be in FB on account you are trying to unlock.

| Imperial Manual for Secure Browsing

50