Npapi Edge



downloadWhy can't I download this file?Enable Npapi Edge

I read that I could re-enable NPAPI in Chrome after Google decided to stop supporting these plugins (I suppose in order to force developers to embrace WebGL solutions) but the flag doesnt show up in the most recent version of Chrome (50.0.2661.94 m). Is it no longer possible enable NPAPI on Chrome? In the most of browsers, the support for NPAPI plugins was dropped. Only in some forks of Firefox like Waterfox or Pale Moon, NPAPI plugins are still supported. For this reason, the NPAPI plugin will be dropped in vlc version 4. Embed tag attributes. To embed the plugin into a webpage, use the following template.

Applicable Products

  • Citrix Workspace App
  • Receiver for Windows

Symptoms or Error

When launching an application or desktop via an Internet Browser (Google Chrome, Firefox, Internet Explorer, etc.) users are prompted to save or download the '.ica' file.

Solution

In recent releases of IE, Edge, Google Chrome, Firefox, and latest Citrix Workspace App clients many of the issues mentioned below have been resolved.
By default, the OS (Windows, Mac, Linux) should automatically set how to open '.ica' files when trying to launch any resource via Citrix Workspace or Citrix Storefront via the Web Store if the Citrix Workspace App is installed properly.
Confirm Citrix Workspace App is installed or use Citrix Workspace App for HTML5 ('Web Browser' option) instead.
If you continue to encounter this behavior please review the steps outlined below.

There can be a number of resolutions to the issue including but not limited to the following:

Install the Latest Version of Citrix Workspace App

Install the latest Citrix Workspace App version which can be downloaded here: Download Citrix Workspace App

Automatically Open ICA Files

When clicking on an application or desktop to launch via Citrix Workspace or Citrix Storefront on an Internet Browser (not within Citrix Workspace App) and an '.ica' file shows in the download bar on the bottom left please follow these steps to automatically open said file:
ICA file is downloaded during the process. After the ICA file is downloaded, enable the browser to open similar files automatically.
Note: Instructions below are similar for other OS's when using Google Chrome, Firefox, or Edge Browsers.

Internet Explorer:
  1. Navigate to the Citrix Workspace Store or Citrix Storefront Store
  2. Select the resource you are trying to access - Application or Desktop
  3. You will receive a notification on the bottom of the browser to 'Open, Save, Cancel'
  4. Select the Save.
  5. The download bar will now show to 'Open, Open Folder, View Downloads',
  6. Select the drop-down list next to 'Open' and select 'Open With'
  7. Find and select 'Connection Manager'
Google Chrome

Npapi Edge Enable

:
  1. Navigate to the Citrix Workspace Store or Citrix Storefront Store
  2. Select the resource you are trying to access - Application or Desktop
  3. Chrome will prompt a dialog box to save the '.ica' file
  4. Hit save to save it in the 'Downloads folder'
  5. On the bottom left you will see the file, click the '^' which is the drop-down list for the file in the download bar and select 'Always Open Files of This Type'
Firefox:
  1. Navigate to the Citrix Workspace Store or Citrix Storefront Store
  2. Select the resource you are trying to access - Application or Desktop
  3. Firefox will prompt you with a dialog box to save the '.ica' file
  4. Select 'Do this automatically for files like this from now on'
  5. Select 'Open With' and click 'Browse'
  6. Select 'Connection Manager'
Edge Browser:
  1. Navigate to the Citrix Workspace Store or Citrix Storefront Store
  2. Select the resource you are trying to access - Application or Desktop
  3. Edge automatically saves the file to the downloads folder by default
  4. On the bottom left you will see the file, click the '...' which is the drop-down list for the file in the download bar and select 'Always Open Files of This Type'

Associate .ica File Type With Citrix Connection Manager

  1. On Windows computers, go to Control Panel > Settings > Apps > Default apps > Choose default apps by file type

  2. Under Name, find .ica file type.

  3. Ensure that the current default is set to Citrix Connection Manager. If not, click Change program and choose Citrix Connection Manager.

Note: Connection Manager is the wfcrun32 file located as C:Program Files (x86)CitrixICA Clientwfcrun32.exe

Remove or Disable Third Party Browser Adware

Remove or disable any third party browser based Adware software that could be interfering with the successful launch of the ICA file. Restart the browser after removing these software and try again.

Clear the 'Do not save encrypted data to disk' Option

If you are using Internet Explorer, click Tools > Internet Options > Advanced tab and clear the option “Do not save encrypted data to disk.”. This option should be cleared because the dynamic files are stored in the Temporary Internet Files folder. When applications are clicked, a file is downloaded to the folder, then launched using MIME type. If access to the folder is disabled or not available, the process cannot occur successfully.

Below are for older Browser/Citrix Receiver Deployments:

No longer recommended to perform these steps in newer releases of Internet Browsers. Steps remain for any users not fully updated to the latest and greatest.

Add Website to Trusted Sites

Add the site to the Trusted sites list if using Internet Explorer browser using the following steps:

  1. Go to Tools > Internet Options > Security tab > Sites

  2. In the Add this website to the zone field, enter your organization's website and click Add.

  3. Repeat this for the .com, .net, .org, or .gov Web site addresses of your organization to allow the use of the ActiveX ICA client object for the launched connection to be automatically accepted.
    Note: It might be required to also add any additional subdomain.domain.com URLs to the Trusted sites list in the Security tab setting if still experiencing unwanted prompts.

Disable ActiveX Filtering (Enable ActiveX)

Caution! Refer to the Disclaimer at the end of this article before using Registry Editor.

Configure Internet Explorer as follows to allow successful application launching:

  1. Disable ActiveX filtering feature for the Web Interface site, either by:
  • Disabling ActiveX filtering globally:
    Click Gear icon, select Safety, de-select ActiveX Filtering. Alternatively, press Alt key and click Tools menu (ActiveX filtering is enabled if a “tick” appears next to it and is disabled if the “tick” disappears).

    Or

  • Disabling ActiveX filtering for an individual site when ActiveX filtering is enabled globally:
    1. Log on to the Web Interface site and attempt to launch an application. At the end of the address bar a blue warning sign appears, indicating filtered content.

    2. Click the blue warning sign and select Turn off ActiveX Filtering.

  1. Enable ICA launch using one of the following options:
Npapi
  • Add the site to the Trusted sites list: In the Security tab of Internet Options, add the Web Interface site to Trusted Sites list to allow the use of the ActiveX ICA client object for the launch.

    Or

  • Disable the MIME filter: Rename the following registry key: HKEY_CLASSES_ROOTPROTOCOLSFilterapplication/x-ica

  1. Log off and close window then restart the browser after making this change.

Enable Citrix ICA Client plugin

Configure Internet Explorer as follows to allow successful application launching:

  1. Enable Citrix ICA Client IE plugin by following the steps below:
    • Launch Internet Explorer
    • Go to Tools > Manage add-ons
    • Select Citrix ICA Client plugin and click Enable

Problem Cause

There can be a number of reasons for the issue including but not limited to:

  • The *.ica file on the client needs to be associated with Citrix Workspace App
  • Outdated Internet Browsers in use

Additional Resources

  • CTX139939 - Microsoft Internet Explorer 11 - Citrix Known Issues

  • CTX200889 - Receiver for Web Workaround with NPAPI Support Removal in Google Chrome

  • CTX126653 – Citrix Online Plug-in for Windows with Internet Explorer 9 Support

  • Citrix Discussions - IE 11 (Website cannot find required software)

Disclaimer

Caution! Using Registry Editor incorrectly can cause serious problems that might require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Be sure to back up the registry before you edit it.

Npapi Edge Plugin

-->

WebDriver allows developers to create automated tests that simulate user interaction. WebDriver tests and simulations differ from JavaScript unit tests in the following ways.

  • Accesses functionality and information not available to JavaScript running in browsers.
  • Simulates user events or OS-level events more accurately.
  • Manages multiple windows, tabs, and webpages in a single test session.
  • Runs multiple sessions of Microsoft Edge on a specific machine.

The following section describes how to get started with WebDriver for Microsoft Edge (Chromium).

Install Microsoft Edge (Chromium)

Ensure you install Microsoft Edge (Chromium). To confirm that you have Microsoft Edge (Chromium) installed, navigate to edge://settings/help, and verify the version number is version 75 or later.

Enable Npapi Edge

Download Microsoft Edge Driver

To begin automating tests, use the following steps to ensure that the WebDriver version you install matches your browser version.

  1. Find your version of Microsoft Edge.

    1. Navigate to edge://settings/help.

  2. Navigate to Microsoft Edge Driver.

  3. Navigate to Get the latest version.

  4. Choose the build of channel that matches your version number of Microsoft Edge.

    The Get the latest version section on the Microsoft Edge Driver webpage

Choose a WebDriver language binding

The last component you must download is a language-specific client driver to translate your code (Python, Java, C#, Ruby, JavaScript) into commands the Microsoft Edge Driver runs in Microsoft Edge (Chromium).

Download the WebDriver language binding of your choice. The Microsoft Edge team recommends Selenium 4.00-alpha07 or later, because it supports Microsoft Edge (Chromium). However, you may control Microsoft Edge (Chromium) in all older versions of Selenium, including the current stable Selenium 3 release.

Important

If you previously automated or tested Microsoft Edge (Chromium) using ChromeDriver and ChromeOptions classes, your WebDriver code does not run on Microsoft Edge Version 80 or later. To solve the problem, update your tests to use the EdgeOptions class and download Microsoft Edge Driver.

Use Selenium 3

If you already use Selenium 3, you may have existing browser tests and want to add coverage for Microsoft Edge (Chromium) without changing your version of Selenium. To use Selenium 3 to write automated tests for both Microsoft Edge (EdgeHTML) and Microsoft Edge (Chromium), install the Selenium Tools for Microsoft Edge package to use the updated driver. The EdgeDriver and EdgeDriverService classes included in the tools are fully compatible with the built-in equivalents in Selenium 4.

Use the following steps to add the Selenium Tools for Microsoft Edge and Selenium 3 to your project.

Add the Microsoft.Edge.SeleniumTools and Selenium.WebDriver packages to your .NET project using the NuGet CLI or Visual Studio.

Use pip to install the msedge-selenium-tools and selenium packages.

If your Java project uses Maven, copy and paste the following dependency to your pom.xml file to add msedge-selenium-tools-java.

The Java package is also available to download directly on the Selenium Tools for Microsoft Edge Releases page.

Use npm to install the edge-selenium-tools and selenium-webdriver packages.

Automate Microsoft Edge (Chromium) with WebDriver

To automate a browser using WebDriver, you must first start a WebDriver session using your preferred WebDriver language binding. A session is a single running instance of a browser controlled using WebDriver commands. Start a WebDriver session to launch a new browser instance. The launched browser instance remains open until you close the WebDriver session.

The following content walks you through using Selenium to start a WebDriver session with Microsoft Edge (Chromium). You may run the examples using either Selenium 3 or 4. To use with Selenium 3, the Selenium Tools for Microsoft Edge package must be installed.

Enable Npapi Edge Browser

Automate Microsoft Edge (Chromium)

Selenium uses the EdgeDriver class to manage a Microsoft Edge (Chromium) session. To start a session and automate Microsoft Edge (Chromium), create a new EdgeDriver object and pass it an EdgeOptions object with the UseChromium property set to true.

The EdgeDriver class only supports Microsoft Edge (Chromium), and doesn't support Microsoft Edge (EdgeHTML). For basic usage, you may create an EdgeDriver without providing EdgeOptions.

Note

If your IT admin has set the DeveloperToolsAvailability policy to 2, Microsoft Edge Driver is blocked from driving Microsoft Edge (Chromium), because the driver uses the Microsoft Edge DevTools. Ensure the DeveloperToolsAvailability policy is set to 0 or 1 to automate Microsoft Edge (Chromium).

Choose Specific Browser Binaries (Chromium-Only)

You may start a WebDriver session with specific Microsoft Edge (Chromium) binaries. For example, you may run tests using the Microsoft Edge preview channels such as Microsoft Edge Beta.

Customize the Microsoft Edge Driver Service

When you use the EdgeOptions class to create an EdgeDriver class instance, it creates and launches the appropriate EdgeDriverService class for either Microsoft Edge (EdgeHTML) or Microsoft Edge (Chromium).

If you want to create an EdgeDriverService, use the CreateChromiumService() method to create one configured for Microsoft Edge (Chromium). The CreateChromiumService() method is useful when you need to add customizations. For example, the following code starts verbose log output.

Note

You do not need to provide the EdgeOptions object when you pass EdgeDriverService to the EdgeDriver instance. The EdgeDriver class uses the default options for either Microsoft Edge (EdgeHTML) or Microsoft Edge (Chromium) based on the service you provide.
However, if you want to provide both EdgeDriverService and EdgeOptions classes, ensure that both are configured for the same version of Microsoft Edge. For example, you may use a default Microsoft Edge (EdgeHTML) EdgeDriverService class and Chromium properties in the EdgeOptions class. The EdgeDriver class throws an error to prevent using different versions.

When you use Python, the Edge object creates and manages the EdgeService. To configure the EdgeService, pass extra arguments to the Edge object as indicated in the following code.

Use the createDefaultService() method to create an EdgeDriverService configured for Microsoft Edge (Chromium). Use Java system properties to customize driver services in Java. For example, the following code uses the 'webdriver.edge.verboseLogging' property to turn on verbose log output.

When you use JavaScript, create and configure a Service with the ServiceBuilder class. Optionally, you may pass the Service object to the Driver object, which starts (and stops) the service for you.
To configure the Service, run another method in the ServiceBuilder class before you use the build() method. Then pass the service as a parameter in the Driver.createSession() method.

Use Chromium-Specific Options

If you set the UseChromium property to true, you may use the EdgeOptions class to access the same Chromium-specific properties and methods that are used when you automate other Chromium browsers.

Note

If the UseChromium property is set to true, you are not able to use properties and methods for Microsoft Edge (EdgeHTML).

Other WebDriver installation options

Chocolatey

If you use Chocolatey as your package manager, run the following command to install the Microsoft Edge Driver.

For more information, navigate to Selenium Chromium Edge Driver on Chocolatey.

Docker

If you use Docker, run the following command to download a pre-configured image with Microsoft Edge (Chromium) and Microsoft Edge Driver pre-installed.

Java Npapi Edge

For more information, navigate to the msedgedriver container on Docker Hub.

Next steps

For more information about WebDriver and how to write automated WebDriver tests using Selenium, navigate to the Selenium documentation.

Getting in touch with the Microsoft Edge DevTools team

The Microsoft Edge team is eager to hear your feedback about using WebDriver, Selenium, and Microsoft Edge. To send the team your questions and comments, choose the Send Feedback icon in the Microsoft Edge DevTools or send a tweet @EdgeDevTools.