-
-
-
Installing the Firefox Browser Extension
-
-
-
This content has been machine translated dynamically.
Dieser Inhalt ist eine maschinelle Übersetzung, die dynamisch erstellt wurde. (Haftungsausschluss)
Cet article a été traduit automatiquement de manière dynamique. (Clause de non responsabilité)
Este artículo lo ha traducido una máquina de forma dinámica. (Aviso legal)
此内容已经过机器动态翻译。 放弃
このコンテンツは動的に機械翻訳されています。免責事項
이 콘텐츠는 동적으로 기계 번역되었습니다. 책임 부인
Este texto foi traduzido automaticamente. (Aviso legal)
Questo contenuto è stato tradotto dinamicamente con traduzione automatica.(Esclusione di responsabilità))
This article has been machine translated.
Dieser Artikel wurde maschinell übersetzt. (Haftungsausschluss)
Ce article a été traduit automatiquement. (Clause de non responsabilité)
Este artículo ha sido traducido automáticamente. (Aviso legal)
この記事は機械翻訳されています.免責事項
이 기사는 기계 번역되었습니다.책임 부인
Este artigo foi traduzido automaticamente.(Aviso legal)
这篇文章已经过机器翻译.放弃
Questo articolo è stato tradotto automaticamente.(Esclusione di responsabilità))
Translation failed!
Installing the Firefox Browser Extension
uberAgent’s browser web app performance functionality requires a browser extension to be installed. This article lists the necessary steps for the Firefox extension. The requirements can be found here.
Enabling the Agent Metric
To enable data collection from Firefox make sure uberAgent’s BrowserPerformanceFirefox
metric is enabled in the configuration. In the default configuration, BrowserPerformanceFirefox
is enabled.
Installing the Firefox Extension
The extension is available from two different channels: release and beta. The release channel gets only fully-tested versions of the extension, while the beta channel additionally gets beta-quality versions.
Important: As of uberAgent 7.2, the version 4.0.1 of the Firefox browser add-on is required. This version is based on a V3 manifest file.
Manual Installation
For tests and PoCs, it may be easiest to install uberAgent’s Firefox extension manually.
Release Channel
Install the extension from release channel on the Firefox Web Store.
Beta Channel
To install the beta version of the extension:
- In Firefox, click here and agree to the terms and conditions
- When Firefox asks
Allow uberagent.com to install an add-on?
selectContinue to Installation
- When Firefox asks
Add uberAgent - beta?
selectAdd
- Firefox shows a message indicating that the installation was successful
We recommend putting the majority of users on the release channel and a small minority on the beta channel.
Note: due to a change by Mozilla, beta versions prior to 2.6 cannot upgrade to 2.6+ automatically. Please uninstall older versions of the extension, and then install version 2.6+. This only applies to the beta channel.
User Consent
The extension version 2.6 or newer initially does not collect any data. To enable data collection click the uberAgent icon in the upper right corner.
Automated Installation
Add-on Deployment
Deployment of uberAgent’s Firefox extension is easily possible with Group Policy (Firefox 60+ required). Please follow the steps in Mozilla’s documentation.
Below is an example JSON code to block the user from installing any extension but force the uberAgent extension installation through Group Policy. Put it in Policies - Administrative Templates - Mozilla - Firefox - Extensions - Extension Management
.
{
"*": {
"blocked_install_message": "If you need this browser extension, please contact the helpdesk.",
"installation_mode": "blocked"
},
"{2e53b2d2-1bdf-446a-8f9d-9be4173886fe}": {
"installation_mode": "force_installed",
"install_url": "https://addons.mozilla.org/firefox/downloads/latest/uberagent/latest.xpi"
}
}
<!--NeedCopy-->
User Consent
As of 2019-12-02, Mozilla enforces showing a consent dialog to users if an add-on collects information about visited URLs, even if the add-on was deployed through Group Policy.
This change forces us to publish a new version of the add-on that initially does not collect any data. To automatically enable data collection set the new managed storage setting EnableBrowserDataCollection
to true
. This can be achieved in one of two ways.
Automatically declare consent and enable data collection by running a script to set EnableBrowserDataCollection
to true
:
- Make sure that cookies are enabled and Firefox’s setting
dom.storage.enabled
is set totrue
- Download and unzip this script
-
Run the script with elevated permissions on every endpoint:
powershell.exe -executionpolicy bypass -file Set-uberAgentFFEnableBrowserDataCollection.ps1
- Only upgrade to or install version 2.6+ of uberAgent’s Firefox add-on once the script has been run on all endpoints
If you prefer to change things manually instead of using our script we have you covered, too:
-
Create the file
uAFirefoxSettings.json
in uberAgent’s installation directory with the following content:{"name": "{2e53b2d2-1bdf-446a-8f9d-9be4173886fe}", "description": "ignored", "type": "storage", "data": {"EnableBrowserDataCollection": true}}
- Create the registry key
HKEY_LOCAL_MACHINE\SOFTWARE\Mozilla\ManagedStorage\{2e53b2d2-1bdf-446a-8f9d-9be4173886fe}
- Set the key’s default value to the full path of the JSON file from step one, e.g.
C:\ProgramFiles\vast limits\uberAgent\uAFirefoxSettings.json
If you do not set EnableBrowserDataCollection
to true
before upgrading to or installing version 2.6+ of uberAgent’s Firefox extension users have to opt-in at first run. If they do not opt-in, uberAgent cannot collect any website metrics.
Future versions of uberAgent (> 5.3) will set EnableBrowserDataCollection
to true
automatically unless this is specifically disabled in uberAgent’s configuration.
Note that setting ShowConsentDialog
to false
has the same effect as setting EnableBrowserDataCollection
to true
.
Share
Share
In this article
This Preview product documentation is Citrix Confidential.
You agree to hold this documentation confidential pursuant to the terms of your Citrix Beta/Tech Preview Agreement.
The development, release and timing of any features or functionality described in the Preview documentation remains at our sole discretion and are subject to change without notice or consultation.
The documentation is for informational purposes only and is not a commitment, promise or legal obligation to deliver any material, code or functionality and should not be relied upon in making Citrix product purchase decisions.
If you do not agree, select I DO NOT AGREE to exit.