http://www.xk72.com/charles/wiki/ 2008-04-09T22:52:41+01:00 http://www.xk72.com/charles/wiki/ http://www.xk72.com/charles/wiki/lib/images/favicon.ico text/html 2006-04-23T18:38:46+01:00 http://www.xk72.com/charles/wiki/access_control_settings?rev=1145774326 The access control list determines who can use this Charles instance. Normally you run Charles on your own machine and you only intend for yourself to use it, so localhost is always included in the ACL. However you may want to allow other hosts on y... text/html 2006-10-04T08:52:34+01:00 http://www.xk72.com/charles/wiki/adobe_flash_isn_t_using_charles_on_mac_os_x?rev=1159905154 Unfortunately there is a problem with Flash on Mac OS X. It does not use the OS proxy settings and does not appear to offer any proxy settings of its own. Therefore when you run Flash movies in the authoring environment or stand-alone they do not us... text/html 2006-01-17T22:00:34+01:00 http://www.xk72.com/charles/wiki/ajax_debugging?rev=1137488434 Charles is invaluable for XML development in web browsers, such as AJAX (Asynchronous Javascript and XML) and XMLHttpRequest, as it enables you to see the actual XML that is flowing between the client and the server. Charles is an HTTP Monitor impl... text/html 2006-04-24T10:53:08+01:00 http://www.xk72.com/charles/wiki/amf_3?rev=1145832788 AMF 3 is the new version of AMF used in the next generation Flash Remoting and in Flex. AMF 3 support was implemented in Charles in version 2.4. ... text/html 2007-09-17T23:14:36+01:00 http://www.xk72.com/charles/wiki/application_proxy_settings?rev=1190027676 You can also configure other applications to use Charles as their HTTP or SOCKS proxy. This enables you to debug their activity through Charles as well. You may find that a lot of applications respect your system proxy settings, which are autoconfi... text/html 2006-04-24T22:48:08+01:00 http://www.xk72.com/charles/wiki/automatic_update_checking?rev=1145875688 Charles checks for updates everytime you start Charles. You will be alerted if there is a new version available. You can also manually check for updates in the Help menu. Automatic Update Checking can be turned off in the Preferences. You can also ... text/html 2006-04-24T10:39:43+01:00 http://www.xk72.com/charles/wiki/bandwidth_throttle?rev=1145831983 Charles can be used to adjust the bandwidth and latency of your Internet connection. This enables you to simulate modem conditions using your high-speed connection. The bandwidth may be throttled to any arbitrary bytes per second. This enables any ... text/html 2006-01-17T21:36:00+01:00 http://www.xk72.com/charles/wiki/blacklist?rev=1137486960 The Blacklist tool enables you to enter domain names which should be blocked. When your web browser tries to request any page from a blacklisted domain name it is blocked. You can also enter wildcards to block subdomains. Blacklisting is useful whe... text/html 2007-08-19T11:05:41+01:00 http://www.xk72.com/charles/wiki/browser_proxy_settings?rev=1187478341 In order for any browser (or any application) to use Charles it must be configured to use Charles as its proxy server. Most browsers will have a way to configure this manually, but configuring manually is annoying because you have to configure and r... text/html 2006-04-23T21:19:38+01:00 http://www.xk72.com/charles/wiki/can_no_longer_browse_without_charles_running?rev=1145783978 It is likely that your browser’s proxy settings have been changed to use Charles and then, for some reason, not changed back. First try starting and quiting Charles normally to see if that corrects the problem. Because if Charles is stopped a... text/html 2007-05-14T10:39:49+01:00 http://www.xk72.com/charles/wiki/charles_crashes?rev=1179095989 Well that’s no good! But it should be quite unusual. There are a few things that might be causing it, or will help me diagnose and hopefully fix the problem... Known Problems Below is a list of problems that I know about with Charles that y... text/html 2006-04-23T18:38:59+01:00 http://www.xk72.com/charles/wiki/configuration?rev=1145774339 Charles has several different configuration dialogs to control various aspects of the program. Furthermore, each tool also has its own configuration which is documented separately for each tool. Preferences Recording Settings Proxy Settings Acc... text/html 2006-04-23T18:54:49+01:00 http://www.xk72.com/charles/wiki/error_log?rev=1145775289 The Error Log displays debugging messages. You shouldn’t need to use it in the usual course of operation. If you encounter a bug in Charles you may find useful information in the Error Log. Especially if you’re reporting a bug, emailing... text/html 2006-04-24T23:15:33+01:00 http://www.xk72.com/charles/wiki/event_viewer?rev=1145877333 The Event Viewer is the most important part of Charles; it is where you can view the details of any recorded event. When you click on an event in either the structure view or sequence view, the information for that event is loaded in the Event View... text/html 2007-05-17T09:01:27+01:00 http://www.xk72.com/charles/wiki/external_proxy_settings?rev=1179349287 You may have a proxy server on your network that you have to use in order to access the Internet. In that case you need to configure Charles to use your existing proxy when it attempts to access the Internet. You can configure separate proxy addres... text/html 2006-04-25T20:14:21+01:00 http://www.xk72.com/charles/wiki/features?rev=1145952861 Charles helps to debug a wide range of web problems. Below is a list of Charles’ features: Cookies are shown in the HTTP headers, so you can see exactly what cookies you are sending and receiving. Every request and response is recorded in Ch... text/html 2007-08-19T11:04:31+01:00 http://www.xk72.com/charles/wiki/firefox_extension?rev=1187478271 Mozilla Firefox proxy settings are configured automatically using the Charles Autoconfiguration Add-on. The add-on is available for download from the Charles Download page. The Charles Autoconfiguration Add-on adds a Charles option in the Tools men... text/html 2006-04-24T10:44:09+01:00 http://www.xk72.com/charles/wiki/flash?rev=1145832249 When developing Flash application that make use of the network capabilities of Flash it is difficult to debug as you cannot see the requests and responses. Charles negates this difficulty by making every HTTP request and response easily visible. D... text/html 2006-04-24T10:51:50+01:00 http://www.xk72.com/charles/wiki/flash_remoting?rev=1145832710 Charles parses the binary AMF format so you can easily inspect the Flash Remoting requests and responses. The messages are displayed in a tree format representing the structure of the message. As of version 2.4 Charles supports AMF 3 as well as AMF... text/html 2007-08-19T10:42:06+01:00 http://www.xk72.com/charles/wiki/getting_started?rev=1187476926 The best way to learn how to use Charles and to learn how it can help you is just to install it and see how it works. If you haven’t already please read the installation guide. Start Using Charles Start Charles by running the application f... text/html 2006-01-17T21:51:24+01:00 http://www.xk72.com/charles/wiki/http_1.1?rev=1137487884 HTTP 1.1 is an upgrade to the original HTTP 1.0. There are lots of differences between the two specifications. The primary difference between HTTP 1.1 and 1.0 is that 1.1 formalised the keep-alive behaviour of HTTP. That is rather than opening a se... text/html 2006-04-24T10:42:44+01:00 http://www.xk72.com/charles/wiki/http_monitor?rev=1145832164 An HTTP Monitor is an application that enables the developer to view all of the HTTP traffic between your computer and the Internet. This includes the request data (such as HTTP headers and form GET and POST data) and the response data (including th... text/html 2006-04-24T10:42:25+01:00 http://www.xk72.com/charles/wiki/http_proxy?rev=1145832145 An HTTP Proxy is a server that receives requests from your web browser and then makes the request to the Internet on your behalf. It then returns the results to your browser. Charles is a simple HTTP proxy, which enables it to document each request... text/html 2007-08-19T12:25:54+01:00 http://www.xk72.com/charles/wiki/http_vs_socks_proxy?rev=1187483154 Charles has traditionally (pre version 3.1) primarily acted as an HTTP proxy, with SOCKS proxy functionality available as well. However there are some performance issues that occur when using an HTTP proxy that result in the browser’s behaviou... text/html 2007-08-19T10:53:51+01:00 http://www.xk72.com/charles/wiki/installation?rev=1187477631 The first thing to do is to download Charles. If you use Firefox, download and install the Firefox Extension from the same download page above. Installation is easy. On Windows, run the setup application to install Charles in your Programs menu; ... text/html 2007-08-19T10:32:17+01:00 http://www.xk72.com/charles/wiki/introduction?rev=1187476337 Charles is a web proxy (HTTP Proxy / HTTP Monitor) that runs on your own computer. Your web browser (or any other Internet application) is then configured to access the Internet through Charles rather than via its normal route. Charles is then able ... text/html 2006-04-23T09:21:36+01:00 http://www.xk72.com/charles/wiki/list_of_hostnames?rev=1145740896 At several places in Charles you can enter a list of hostnames. For example: most tools have a list of host names to filter which hosts they effect. There is a list of host names to ignore in the recording settings. The list of host names lets you ... text/html 2007-04-19T07:49:15+01:00 http://www.xk72.com/charles/wiki/localhost_traffic_doesn_t_appear_in_charles?rev=1176925755 Some systems are hard coded to not use proxies for localhost traffic. Specifically IE 7 and .Net applications have this feature. The workaround is to connect to http://localhost./test/ instead (note the . after localhost). This should work identica... text/html 2007-08-19T10:59:16+01:00 http://www.xk72.com/charles/wiki/mac_os_x_proxy_settings?rev=1187477956 Charles can automatically configure the Mac OS X system proxy settings so that Safari and other Mac OS X applications automatically start using Charles. When you first install Charles you will be prompted to grant permissions to Charles to autoconf... text/html 2006-04-24T22:47:04+01:00 http://www.xk72.com/charles/wiki/menus?rev=1145875624 Documentation on the function of each menu and menu item. File Menu New Session - Start a new Session Open Session - Open a saved Session Clear Session - Clear all of the recorded information from the current session Close Session - Close the ... text/html 2006-04-23T20:40:35+01:00 http://www.xk72.com/charles/wiki/next_steps?rev=1145781635 Now that you’ve started using Charles you’re ready to explore what else Charles can do for you. ... text/html 2006-01-17T21:41:38+01:00 http://www.xk72.com/charles/wiki/ntlm_authentication?rev=1137487298 Charles supports NTLM authenticating websites. You can access NTLM authenticating websites through Charles without any problems. NTLM authentication is also known as “Windows NT Challenge Response” and “Integrated Windows Authenti... text/html 2006-01-17T21:57:40+01:00 http://www.xk72.com/charles/wiki/port_forwarding?rev=1137488260 Any TCP/IP or UDP port can be configure to be forwarded from Charles to a remote host using the Port Forwarding tool. This enables debugging of any protocol in Charles. This is especially useful when debugging XMLSocket connections in Macromedia Fl... text/html 2006-04-24T22:45:48+01:00 http://www.xk72.com/charles/wiki/preferences?rev=1145875548 Activated from the Edit menu (or Charles menu on Mac OS X). The Preferences dialog lets you set the start up configuration and user interface configuration Start Up Configures the behaviour of Charles when it is started. Create New Session - Wh... text/html 2006-04-23T18:38:21+01:00 http://www.xk72.com/charles/wiki/proxy_settings?rev=1145774301 Controls the operation of the proxy server that is the core of Charles. Ports The proxy server operates on two ports, one for the HTTP proxy and on for the SOCKS proxy. The defaults for these are usually fine. You may need to change them if you h... text/html 2007-08-19T11:23:32+01:00 http://www.xk72.com/charles/wiki/recording?rev=1187479412 Recording is the primary function of Charles. Requests and responses are recorded to the current Session for you to later inspect and analyse. The requests recorded depend upon the configuration of Charles. Usually this would include all HTTP and H... text/html 2006-04-23T18:38:09+01:00 http://www.xk72.com/charles/wiki/recording_settings?rev=1145774289 Configures the recording behaviour of Charles. Recording Size Limits When Charles records, all of the request and response headers and bodies are stored in memory. This can result in quickly running out of memory if you download large files. Ther... text/html 2007-08-13T09:53:28+01:00 http://www.xk72.com/charles/wiki/release_notes_3_1?rev=1186955608 13 August 2007 Charles 3.1 includes some changes that may affect existing users of Charles. The actions required are, however, very simple and the benefits will outweigh the effort! SSL Charles has a new root SSL certificate. If you have install... text/html 2007-08-19T11:26:27+01:00 http://www.xk72.com/charles/wiki/request_response?rev=1187479587 A request and its response is the basic element recorded in Charles. HTTP/HTTPS consists of request-response pairs: the request from your computer to the server and the response from the server. For generic sockets the request-response consists of... text/html 2007-08-19T11:24:55+01:00 http://www.xk72.com/charles/wiki/request_response_viewer?rev=1187479495 The Request / Response Viewer is the most important part of Charles; it is where you can view the details of any recorded request or response. When you click on a request/response in either the structure view or sequence view, the information for i... text/html 2007-08-19T11:27:18+01:00 http://www.xk72.com/charles/wiki/request_viewer?rev=1187479638 The Request Viewer is where you can view the details of any recorded request or response. When you click on a request in either the structure view or sequence view, the information for it is loaded in the viewer. The viewer is divided into several... text/html 2007-10-08T08:54:33+01:00 http://www.xk72.com/charles/wiki/reverse_proxy?rev=1191786873 A reverse proxy is like a virtual HTTP server that forwards all requests to a given web server. The reverse proxy feature of Charles is useful if you have an application that cannot be easily configured to use a proxy server, and you want to view i... text/html 2007-08-19T11:19:52+01:00 http://www.xk72.com/charles/wiki/session?rev=1187479192 Your Session contains all of your recorded information. It is represented by the Session window; by default a new session is automatically created when you start Charles (Untitled Session 1). You will possibly only ever need a single session when y... text/html 2006-01-17T21:56:17+01:00 http://www.xk72.com/charles/wiki/socket_forwarding?rev=1137488177 Any TCP/IP or UDP port can be configure to be forwarded from Charles to a remote host using the Socket Forwarding tool. This enables debugging of any protocol in Charles. This is especially useful when debugging XMLSocket connections in Macromedia ... text/html 2007-08-19T12:13:25+01:00 http://www.xk72.com/charles/wiki/socks_proxy?rev=1187482405 A SOCKS proxy is an alternative to an HTTP proxy. SOCKS is multi-protocol in that it can support proxying any TCP/IP traffic, not just HTTP. Some organisations will use SOCKS proxies to enable non-HTTP applications to bypass a firewall; often an HTT... text/html 2007-08-19T12:24:21+01:00 http://www.xk72.com/charles/wiki/socks_transparent_proxying?rev=1187483061 SOCKS transparent proxying was introduced in Charles 3.1. Read more about the reasons for using SOCKS transparent proxying in HTTP vs SOCKS proxy. Configuration Open the Proxy Settings in the Proxy menu. The easiest way to enable the SOCKS config... text/html 2006-04-24T10:47:55+01:00 http://www.xk72.com/charles/wiki/spoof_dns?rev=1145832475 Sometimes you want to test a domain name as if it pointed to a different IP address. For example, if you have set up a virtual host but the IP address change hasn’t propagated through DNS yet, you can spoof it and test your virtual hosting imm... text/html 2008-04-09T17:34:41+01:00 http://www.xk72.com/charles/wiki/ssl_certificates?rev=1207719281 Charles generates its own certificates for sites, which it signs using the Charles CA Certificate. You will see a warning in your browser, or other application, when it receives that certificate because the Charles CA Certificate is not in your list... text/html 2007-04-03T10:08:38+01:00 http://www.xk72.com/charles/wiki/ssl_debugging?rev=1175551718 Charles can be used as a man-in-the-middle HTTPS proxy, enabling you to view in plain text the communication between web browser and SSL web server. Charles does this by becoming a man-in-the-middle. Instead of your browser seeing the server’... text/html 2007-08-19T10:56:15+01:00 http://www.xk72.com/charles/wiki/start?rev=1187477775 Charles is an HTTP proxy / HTTP monitor / Reverse Proxy that enables a developer to view all of the HTTP traffic between their machine and the Internet. This includes requests, responses and headers. This documentation will introduce you to Charles... text/html 2006-11-30T07:33:49+01:00 http://www.xk72.com/charles/wiki/third_party_libraries?rev=1164825229 Charles contains code from some 3rd party libraries. Details of this code and the respective licenses are reproduced below: The Legion of the Bouncy Castle Portions of the Bouncy Castle libraries are used for the generation of secure certificates... text/html 2006-04-24T10:40:48+01:00 http://www.xk72.com/charles/wiki/tools?rev=1145832048 Tools are extensions to the basic functionality of Charles. They provide enhancements or new functions. All of the tools are listed in the Tools menu. Throttling No Caching Block Cookies Referer Enhancement Black List DNS Spoofing Rewrite M... text/html 2007-03-25T09:58:55+01:00 http://www.xk72.com/charles/wiki/troubleshooting?rev=1174773535 Sometimes you may encounter problems using Charles. Below is a list of situations with links to solutions or recommendations. Can no longer browse without Charles running Charles crashes Can't authenticate through NTLM / Windows Integerated Auth... text/html 2006-01-17T21:58:29+01:00 http://www.xk72.com/charles/wiki/unicode_support?rev=1137488309 Charles decodes various character sets in response bodies - as long as the charset is identified either by a Content-type HTTP header or by an http-equiv META tag setting the Content-type. Charles will then use a unicode font to display the appropr... text/html 2007-08-19T12:06:20+01:00 http://www.xk72.com/charles/wiki/using_charles?rev=1187481980 Charles is intended to be a dive-in piece of software. Start it up, it will attempt to automatically configure your browser so you’re up and running immediately. Start browsing the web and watch the results appear in Charles; click on them and... text/html 2006-04-24T10:47:43+01:00 http://www.xk72.com/charles/wiki/virtual_hosting?rev=1145832463 Virtual Hosting is where you have multiple sites on a single IP address, and the web server determines which site you’re requesting based on the name that you’ve typed into your browser. More precisely it looks at the Host header sent in... text/html 2007-08-19T10:59:32+01:00 http://www.xk72.com/charles/wiki/windows_proxy_settings?rev=1187477972 Charles can automatically configure the Windows proxy settings so that Internet Explorer and other Windows applications automatically start using Charles. By default Charles will configure and then reconfigure the Windows proxy settings whenever Cha... text/html 2007-03-25T10:00:49+01:00 http://www.xk72.com/charles/wiki/windows_vista?rev=1174773649 This page includes information about using Charles on Windows Vista. Resource temporarily unavailable If you see the following error message when you’re trying to use Charles: Resource temporarily unavailable: recv failed Try turning off ...