Google Chrome
1. Overview
All recent versions of Chrome are generally compatible with Moonshot.
On Windows, Chrome is integrated with the Windows Security Support Provider Interface (SSPI) and requires the Moonshot SSP.
macOS support is currently in development, you must currently use the .gss_eap_id
file in your home directory. See the macOS Compatibility List for more details.
2. Compatibility
2.1. Key
In the tables below, the following icons have the following meanings:
- - This version of the software has been tested and verified as supporting Moonshot.
- - This version of the software has been tested and verified as not supporting Moonshot.
- - This version of the software has not yet been tested thoroughly and its status is not known. Let us know if you have tried it and whether it worked or not!
2.2. Compatibility List
Note that accessing supported versions of this software requires a Moonshot compatible client - see the next section for details on which clients are supported.
Any versions not listed below have not yet been tested. If you do so, please let us know!
Version | Compatible? | Notes |
---|---|---|
Chrome v22 and later | When running on Windows, Linux, or macOS |
3. Installation Instructions
This software does not require any special installation instructions - install it as you normally would.
4. Configuration Instructions
For security reasons, Google Chrome disables the Negotiate protocol, which it refers to as Integrated Authentication, for sites outside a specific whitelist of sites. For more information on how Chrome manages HTTP Authentication, see https://www.chromium.org/developers/design-documents/http-authentication.
4.1. Windows
On Windows, Google Chrome uses Internet Explorer's Local Intranet zone as its whitelist for sites. To use Integrated Authentication, add your site to the Local Intranet zone.
For more information on the Local Intranet zone and how to add and remove sites from this zone, visit Microsoft's Change Internet Explorer Security settings.
The Windows version of Google Chrome does support a per-user exception list.
4.2. Linux
On Linux, Google Chrome uses a JSON file to define the whitelist of sites. This file is stored in /etc/opt/chrome/policies/managed
or /etc/opt/chrome/policies/recommended
and may be any file with a .json
extension. The format of the file is:
{ "AuthServerWhitelist": "*.example.org, *.example2.com", "AuthNegotiateDelegateWhitelist": "*.example.org, *.example3.net" }
The Linux versions of Google Chrome and Chromium do not support a per-user exception list.
These parameters can be set on the command line as --auth-server-whitelist and --auth-negotiate-delegate-whitelist
4.3. macOS
On macOS, Google Chrome uses the macOS property list (.plist
) file define the whitelist of sites. This file is stored in ~/Library/Preferences/com.google.Chrome.plist
. As with Linux, the two settings that control the Negotiate protocol are:
{ "AuthServerWhitelist": "*.example.org, *.example2.com", "AuthNegotiateDelegateWhitelist": "*.example.org, *.example3.net" }
To set the values, use the following command:
macOS-Host:~ localuser$ defaults write com.google.Chrome AuthServerWhitelist -string "*.example.org, *.example2.com" macOS-Host:~ localuser$ defaults write com.google.Chrome AuthNegotiateDelegateWhitelist -string "*.example.org, *.example3.net"
To display currently set values of the AuthServerWhitelist
and AuthNegotiateDelegateWhitelist
settings, use the following command:
macOS-Host:~ localuser$ defaults read com.google.Chrome AuthNegotiateDelegateWhitelist *.example.org, *.example3.net macOS-Host:~ localuser$
macOS version compatibility
It appears that versions other than El Capitan will not load the Moonshot mechanism in Chrome (due to Apple's sandboxing). We're trying to investigate this issue.
5. Credential Storage
Credential Storage
You can also store the credentials in Chrome's own website password list, but this is not recommended as it is less secure.
For more information on how to manage your credentials in Google Chrome, visit Google's Manage your website passwords page.
5.1. Windows
On Windows, you may store the website credentials in the Windows Credential Manager before you try to connect to the website. For more information on storing credentials in the Credential Manager, see Section 2.2 of the Windows Credential Manager page.
5.2. Linux
On Linux you should use the Moonshot Identity Selector.
5.3. macOS
macOS support is currently in development, you must currently use the .gss_eap_id
file in your home directory. See the macOS Compatibility List for more details.
6. Server Compatibility
The following servers are known to work with this server software using Moonshot authentication (click on the link to see further information about enabling Moonshot in that server):