Downloading, Installing and Configuring the Attest Extension

Consult your Deque Engagement Manager or contact the Customer Success office for assistance if necessary! The WorldSpace Attest browser extension can be installed by following a simple browser extension installation process that is not unlike that which you would follow for any other browser extension. After being installed, it provides a few configuration setting options you can then change later as desired. The instructions on this page are provided to give you a general overview of the steps involved, but may slightly differ at your organization.

On this page:

Before you begin, be aware of the following important requirements:

  • You must have at least 4 MB free space to accomodate the Attest extension size (approx. 3.7 MB as of version 3.0.0).
  • You must agree to allow the Attest extension to have the ability to read and change all your data on the websites you visit.
  • You must agree to allow the Attest extension to manage your downloads.
  • You must configure the Chrome browser to allow popups.
  • You must not use Incognito browsing mode. The issues/scripts/scope definitions download/upload capabilities can become disabled when the browser is in "incognito" or private mode.

For the Chrome browser

The following instructions are only provided as an example to give you an idea of the installation process. Specific process steps may differ according to your unique security and browser type/version requirements. Depending on your organization, you may be required to load an unpacked extension with Developer mode enabled, which may be made available from the Deque Agora artifact repository, or a shared drive location within your network. Consult your management for specific installation instructions. A recommended best practice is always to contact us to do it for you!

To download, install and configure the Attest extension (Chrome Web Store example):

  1. In the Chrome browser, navigate to the Attest DevTools for Chrome extension installation file. Click on the link to initiate the installation procedure. Contact your Admin or contact Deque Tech Support to obtain the appropriate file location (URL) for your organization.
  2. The Extensions page of the Chrome Web Store opens and displays the WorldSpace Attest DevTools popup window with information about the extension and an ADD TO CHROME button.

  3. Click the ADD TO CHROME button.
  4. The ADD TO CHROME button label changes to CHECKING..., and the 'Add WorldSpace Attest DevTools?' dialog box pops up listing the extension permissions and prompting you to click an Add extension button.

  5. On the 'Add WorldSpace Attest DevTools?' dialog box, click the Add extension button.
  6. Clicking the Add extension button at the confirmation prompt dialog box

    The 'Add extension' dialog box closes, the CHECKING... button label changes to display the status of 'ADDED TO CHROME', and a new dialog box pops up at the top, right displaying the message, "WorldSpace Attest DevTools has been added to Chrome. Manage your extensions by clicking Extensions in the Tools menu."

    The Added to Chrome completion success dialog box with updated button status
  7. In the Chrome browser Address field, type chrome://extensions, then press the Enter key.
  8. WorldSpace Attest is now displayed in the list of extensions. By default, the Enabled checkbox is checked.

    Example of the Extensions page displaying the WorldSpace Attest Devtools extension
  9. Ensure the Allow access to file URLs option is checked to enable the full functionality Attest is capable of. Note: This box is initially selected by default.

Incognito Caution: Deselect the Allow in incognito checkbox option on the Extensions page if you do not want to use Attest when in that mode. Otherwise, be aware of the fact that Chrome is not able to prevent the extension from recording your browsing history.

Extensions Toolbar: Unless you decide to hide it from the Chrome menu, look for the Attest logo to appear in the chrome extensions toolbar to the right of the Address location field for quick access. This lets you know Attest is installed and ready to use at any time.

The Attest logo at top, right of browser menu

Default Packed Extension Location: After installation, should you want to know the location on your local machine, navigate to chrome://version in the omnibox (browser Address field) and note your computer's Profile Path because it will serve as the beginning of the path on your hard drive to the default folder for Chrome browser extensions. For example, if your Profile Path is C:\Users\\AppData\Local\Google\Chrome\User Data\Default(Windows) then the following would be where your extensions are stored (where ~ is that profile path): ~\Extensions, and for Mac it would be ~/Library/Application Support/Google/Chrome/Default/Extensions.

Allowing Popups

We recommend that you not block popups in the Chrome browser because such a setting can prevent the WorldSpace Attest browser extension from working properly.

To stop blocking popups:

  1. Navigate to the chrome://settings page in the Chrome browser.
  2. Scroll down to the Advanced section and click on it to expand the display of its contents below.
  3. In the 'Privacy and security' section, click on Content settings.
  4. accessing the Advanced portion of the Chrome settings page, then selecting the Content Settings item in the Privacy and security section
  5. In the 'Content settings' section, scroll down as necessary and then click on the Popups item.
  6. accessing the Popups item in the Content settings section menu
  7. In the Popups section, ensure the 'Allowed' slider control is moved to the right position and is blue to indicate it is on.
  8. the slider control to Allow popups in the Popups section of the Chrome browser settings slid to the right to indicate the 'Allow' setting is on

Related Topic: Additional configuration settings, including rule set options, are available on the Settings panel in the Attest extension. For more information, see Selecting a Rule Set.

For the Firefox browser

The Attest extension can be downloaded from the WorldSpace Attest Agora (Deque's Artifactory repository), or it can be installed on your behalf by a Deque representative (recommended). It can then be installed by following a simple browser extension installation process, although the steps differ by browser type. After being installed, it provides a few configuration option settings you can change as desired. Attest is a Cross-Platform Installer Module (XPI) ZIP file used to install packages or "bundles" that utilizes the XPInstall technology for installation of the browser extension. When launched, the file automatically interacts with the installation instructions contained in the XPI, and installs the contained software in the browser extension manager.

Note:

The Attest extension has been developed to be a verified Firefox add-on that is "signed" by Mozilla to signify it meets important security guidelines. For more information, see Add-on signing in Firefox. Version 57 and up are currently supported to take advantage of Mozilla's support for the WebExtensions API in that version and later. For users of the original FireEyes or FireEyes II tools, you must first manually remove them from the about:addons extension page in Firefox prior to installing Attest.

In this section:

The download location, as well as the installation process, is slightly different for WorldSpace Comply clients than it is for WorldSpace Attest clients. Therefore, it is important that you refer to the appropriate instruction set below accordingly.

For WorldSpace Comply Clients

To download, install and configure the Attest Firefox extension for Comply:

  1. Navigate to and click on the Download Attest Extension link (provided to you by your Deque Engagement Manager, Project Manager, or Customer Support Representative), or simply double-click the filename of the XPI file (for example, 'attest-firefox-1.3.0.xpi').
  2. Note: Depending on your browser version and settings, you may be prompted to first allow and then install the extension.

  3. If prompted to allow the Attest extension, click the Allow button.
  4. After clicking the Allow button, you may notice a message indicating the add-on is being downloaded and verified, after which an Install button appears.

  5. Click the Install button that appears in a popup window at the top, left of the browser. For screen reader users, tab to the Install button and activate it, or press Alt+I.
  6. A browser message appears to indicate the extension has been installed successfully.

  7. On the browser Extensions page, to the right of the Attest extension, click the Options button. Note: On a keyboard, press and hold the Ctrl+Shift+A keys to manage your add-ons, then select the Extensions tab, or simply type 'about:addons' in the Firefox address bar.
  8. In the Automatic Updates field, select the desired radio button option. The On radio button option setting is recommended. When the Off setting is selected, a Check for updates link appears to the right of the button, for those who prefer to update manually.
  9. In the Use SAML field, check the box if you want to use your active WorldSpace login information for downloading and uploading. Note: If your instance of WorldSpace Comply is not enabled to support SAML (when the WorldSpace Comply FireEyes_config.properties file has the useSAML flag set to true), this checkbox should not be checked. Consult your System Administrator for details.

Related Topic: Additional configuration settings, including ruleset standard options, are available on the Settings panel in the Attest extension. For more information, see Settings.

Next Subtopic:

Opening the Attest Extension

For WorldSpace Attest Clients

The Attest Firefox extension can also be downloaded from the Deque Agora artifact repository. Before you begin, you must have access to this centralized repository (including the company-id for your license of WorldSpace Attest and the Username and Password). Complete details are available in the Getting Started section of the WorldSpace Attest Quick Start Guide. For more information, see Prerequisites.

To download, install and configure the Attest extension for WorldSpace Attest clients:

  1. Navigate to https://agora.dequecloud.com in your browser.
  2. The page is redirected to the Artifactory login page.

  3. Enter your Username and Password in the text entry fields.
  4. Click the Log in button.
  5. The Deque Agora repository opens, displaying an Artifacts option in the left sidebar menu.

  6. In the left sidebar menu, click the Artifacts option.
  7. The Artifact Repository Browser displays a tree menu to the right of the left sidebar menu.

  8. In the Tree browser, click the down arrow to the left of the Attest Extension folder.
  9. The expanded folder contents below reveals the '@attest-firefox-1.3.0' file.

  10. Click on the @attest-firefox-1.3.0.xpi file name.
  11. The main content pane at right displays the general information about the file, along with a Download option.

  12. Click the Download link at the top, right of the main content pane.
  13. An Opening... dialog box appears prompting you to save or open the file.

  14. On the Opening...dialog box, select the Save Fileoption, then click the OK button.
  15. The dialog box closes and the XPI file is saved to your browser's default download location on your local computer hard drive.

  16. Navigate to the about:home page in Firefox.
  17. The Extensions page appears, listing any previously-installed extensions.

  18. Ensure the Extensions option is selected on the left sidebar menu, then click the Cog icon drop-down arrow at the top of the content pane.
  19. In the drop-down menu, select the Install Add-on From File... option.
  20. The Select add-on to install dialog box pops up in a new window.

  21. In the 'Select add-on to install' dialog box, locate and select the downloaded .xpi file from your computer and then click the Open button.
  22. The dialog box closes, and a caution message appears at the top, left of the browser.

    Note: If the .xpi file extension has not been associated with Firefox, you will be asked which program you want to use to open this type of file. Then you have to first select "other", and then locate the firefox.exe file on your file system, which is typically located in a Mozilla Firefox subfolder within the Program Files (X86) folder.

  23. When prompted to confirm installation, click the Install button on the Add-on Manager caution message popup window.
  24. An Add-on Manager success response message appears at the top, left of the browser.

    On the Add-ons Manager Firefox screen (which you can get to by typing 'about:addons' into the Address bar or by pressing Ctrl+Shift+A), you can verify the installation by locating a WorldSpace Attest entry in the alphabetical list of Extensions (two tab stops over). For screen reader users, if you hear the options "disable, remove" announced after Attest, you know it is installed and ready to use.

Subtopic:

Next Topic: