This is a staging forum for AgileBits, not an official support forum. Visit http://discussions.agilebits.com instead.

How To: Configure your proxy server or Internet security software for 1Password

dteare
dteare Agile Founder
edited February 2013 in Knowledge Base & FAQs

Background

1Password manages the data exchange between itself and the browser extensions through WebSocket. This allows the 1Password background process to communicate with the browser extensions while still respecting the sandboxing rules enforced by modern web browsers. Although these appear as network connections, they are limited to your local machine. These connections are encrypted and authenticated, so they cannot be used to deliver information to any other processes beyond the extensions and the main 1Password application.

If the connections are blocked for any reason, the extension will not be able to connect to 1Password, and no data transfer can occur. The most common symptom of this problem is an Helper Not Connected error in the browser extension. The simplest solution is to ensure that local connections are not blocked on 127.0.0.1 by a proxy server or software firewall.

Many anti-malware, antivirus, and Internet security solutions also include a firewall, so that would also be something to check especially if you are using Windows where such programs are more prevalent.

The specific ports that 1Password uses through its WebSocket connections are 6258, 10191, 14821, 24861, 25007, 38151, 46360, 49801, 55730, 59483, but it is much simpler to just allow all connections to 127.0.0.1 (localhost).

Please follow the steps below to resolve the problem with standard OS X and Windows configurations. For all other proxy servers, you may need to contact the developer of your particular solution.

Note: If you are not the one who has set up your proxy settings, please contact your network administrator for assistance.

Configuring the OS X Proxy Settings

  1. Open System Preferences ( > System Preferences).
  2. Select the "Network" preference pane.
  3. Your primary network interface should already be highlighted on the left. Typically this will be Wi-Fi for wireless connections, but it could be Ethernet if you have a wired connection.
  4. Click the "Advanced" button in the lower right.
  5. Select the "Proxies" tab.
  6. Select "Web Proxy (HTTP)" from the list on the left.
  7. Add 127.0.0.1 to the "Bypass proxy settings for these Hosts & Domains" box for the "Web Proxy (HTTP)" protocol.
  8. If "Secure Web Proxy (HTTPS)" is also checked, add 127.0.0.1 to the "Bypass proxy settings..." box for the "Secure Web Proxy (HTTP)" protocol as well.

Bypass proxy settings for 127.0.0.1

Entries in the "Bypass proxy settings for these Hosts & Domains" box are separated by commas, so you will likely need to insert one between the last entry and your own addition of "127.0.0.1" as shown in the screenshot.

Configuring the Windows Proxy Settings

Please see the tips in the Troubleshooting the new browser extensions article in the FAQ section of the 1Password for Windows user's guide.

Step 3 deals with proxy settings, but we recommend trying all the tips in the order shown.

Flag