eID plugin installation guide

User Documentation
Version 1.1.2
Table of Contents
1. Welcome on eID website . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
1.1. First time here . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
1.2. A new eID plugin is available . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  2
2. Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
2.1. Installing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
2.2. Uninstalling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  9
2.3. Updating . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  10
3. Mac OS X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
3.1. Installing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
3.2. Uninstalling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  15
3.3. Updating . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  17
4. Supported Card readers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  18
4.1. PC/SC compatible readers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  18
4.2. Pin Pad Readers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  18
4.3. Tested Readers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  19
 © UnifiedPost, 2017-06-27

1. Welcome on eID website

1.1. First time here
If you reach the eID website for the first time will be welcomed by our 3 steps intuitive wizard:

• Step 1 Download the eID reader plugin

• Step 2 Perform the actual plugin installation using the freshly downloaded installer

• Step 3 Activate the extension and enjoy our eID solution

User Documentation eID plugin installation guide v1.1.2 1/19

 © UnifiedPost, 2017-06-27

1.2. A new eID plugin is available

In case of a new eID plugin release you may or may not be obliged to update your local version.
We always encourage you to use our latest version but they are situation when you may postponed the
update.

The update wizard is almost identical to the one you could see when you install the eID plugin for the first
time:

• Step 1 Download the newest eID reader plugin

• Step 2 Perform the actual plugin installation using the freshly downloaded installer

• Step 3 Activate the extension and enjoy our eID solution

User Documentation eID plugin installation guide v1.1.2 2/19

 © UnifiedPost, 2017-06-27

2. Windows
2.1. Installing
Follow the below steps for installing the eID plugin:

1. Download the installer

When the site detects no plugin is present or it’s not the correct version it will indicate this and present a
link to your platform specific installer and this manual.
Use the link to download the installer.

2. Go to the folder where the installer was downloaded and run the application

3. Windows might display a Security Warning Message. Click ‘Run’ or ‘Yes’ to install the plugin.

• Windows 7

• Windows 8

• Windows 10

4. Wait for the install wizard to appear

User Documentation eID plugin installation guide v1.1.2 3/19

 © UnifiedPost, 2017-06-27

5. Select one of the available languages to continue the rest of the wizard in that language. This screen and
the previous are shown in the OS specified language (if supported). The installer currently supports the 3
official Belgian languages (Dutch, French and German) and English.

6. Follow the steps of the Setup Wizard. Click ‘Next’ to proceed to the next step.

7. Select a destination folder:

Click ‘Next’ to proceed to the next step

8. Select the desired setup:

User Documentation eID plugin installation guide v1.1.2 4/19

 © UnifiedPost, 2017-06-27

Click ‘Next’ to proceed to the next step.

9. If you have installed both Google Chrome and Firefox (minimum version 50) then you will also see the
screen below and you can choose to install eID plugin for both or only one of them:

10. Wait while the eID plugin is installed.

Click ‘Finish’ when the installation is completed.

11. If you are using Google Chrome:

a. Restart Google Chrome.

The easiest way to restart chrome is to type "chrome://restart" in address bar and press enter. This will
stop chrome and restart without losing any tab and urls.

User Documentation eID plugin installation guide v1.1.2 5/19

 © UnifiedPost, 2017-06-27

b. After restarting Chrome, you will be asked if you want the new extension to be enabled

In case the ‘Enable extension’ message doesn’t appear, check the ‘Customize and Control Google
Chrome’ menu

c. After installation the eID plugin can always be enabled/disabled via the chrome extension menu

User Documentation eID plugin installation guide v1.1.2 6/19

 © UnifiedPost, 2017-06-27

12. If you are using Firefox:

a. Restart Firefox.
The easiest way to restart Firefox is to press Shift+F2 and then type "restart" in the Developer Toolbar.
This will stop Firefox and restart without losing any tab and urls.

b. After restarting Firefox, you will be asked if you want to install the new extension.

i. For Firefox >= 53.

A little warning icon on the menu button indicates that extension is added and you need to enable
it

User Documentation eID plugin installation guide v1.1.2 7/19

 © UnifiedPost, 2017-06-27

ii. For Firefox < 53.

A page is shown after restart. It is important that you check the "Allow this installation" check box
before Continue.

c. After installation the eID plugin can always be enabled/disabled via the Firefox Add-ons Manager

User Documentation eID plugin installation guide v1.1.2 8/19

 © UnifiedPost, 2017-06-27

2.2. Uninstalling
In order to uninstall the plugin, it’s best to quit chrome so plugin is not in use. Go to the installation dir,
default path is C:\Program Files (x86)\eid-reader (or C:\Program Files\eid-reader for 32-bit versions of
Windows) and double-click "uninstall.exe" to start the uninstall wizard.

Click on "Next" button and wait for uninstaller to finish.

Click the "Finish" button to close the uninstaller. The uninstaller should have removed all references and
remove the installation directory. If the installation directory is still present most likely the plugin was still in
use when you ran the uninstall wizard. You can just delete the directory afterwards in that case.

What if you uninstall the extension manually through the Chrome UI?
If you uninstall the extension through the Chrome UI, it will no longer be installed or updated on each startup.
In other words, the external extension is blacklisted (ref).
This uninstall looks like :

User Documentation eID plugin installation guide v1.1.2 9/19

 © UnifiedPost, 2017-06-27

or
In this situation running the installer will successfully complete the installation but the extension will not be
added by Chrome to chrome://extensions. Without the extension the eID plugin will not work. To get the
plugin and extension working again you need to get the extension off the blacklist first.

How do I get the extension off the blacklist?

If you accidentally uninstalled the extension through the Chrome UI, you can remove the blacklist tag by
installing the extension normally through the Chrome Web Store, and then uninstalling it with the uninstall
wizard.
To go directly to the extension on Chrome Web Store click here.

2.3. Updating
In case you run the installer a second time or try to install a new version of the installer without uninstalling
first, the installer will show a different screen after the language selection.

You can just click "Next" to update the eID plugin.

User Documentation eID plugin installation guide v1.1.2 10/19

 © UnifiedPost, 2017-06-27

3. Mac OS X
3.1. Installing
Follow the below steps for installing the eID plugin:

1. Download the installer

When the site detects no plugin is present or it’s not the correct version it will indicate this and present a
link to your platform specific installer and this manual.
Use the link to download the installer.

2. Go to the folder where the installer was downloaded and run the application

3. Click the dmg file to get it mounted as eid-reader

4. Double click on the "Eid Reader plugin installer.app" and click Open to start installer

Depending on your settings, you might get a "Unidentified Developer" message and
only an 'Ok" button to cancel the installer. In that case you should right click on the
app and select "Open" from the menu to get the version with an "Open" button.

5. Wait for the install wizard to appear

6. Select one of the available languages to continue the rest of the wizard in that language. This screen and

User Documentation eID plugin installation guide v1.1.2 11/19

 © UnifiedPost, 2017-06-27

the previous are shown in the OS specified language (if supported). The installer currently supports the 3
official Belgian languages (Dutch, French and German) and English.

7. Follow the steps of the Setup Wizard. Click ‘Next’ to proceed to the next step.

8. Select a destination folder:

Click ‘Next’ to proceed to the next step

9. If you have installed both Google Chrome and Firefox (minimum version 50) then you will also see the
screen below and you can choose to install eID plugin for both or only one of them:

10. Wait while the eID plugin is installed.

User Documentation eID plugin installation guide v1.1.2 12/19

 © UnifiedPost, 2017-06-27

Click ‘Finish’ when the installation is completed.

11. You can now eject the eid-reader mount and remove the dmg as it is no longer needed.

12. If you are using Google Chrome:

a. Restart Google Chrome.

The easiest way to restart chrome is to type "chrome://restart" in address bar and press enter. This will
stop chrome and restart without losing any tab and urls.

b. After restart, The extension icon will be visible and you can click on it to get a menu

And the extension will be listed in the "chrome://extensions" page

User Documentation eID plugin installation guide v1.1.2 13/19

 © UnifiedPost, 2017-06-27

13. If you are using Firefox:

a. Restart Firefox.
The easiest way to restart Firefox is to press Shift+F2 and then type "restart" in the Developer Toolbar.
This will stop Firefox and restart without losing any tab and urls.

b. After restarting Firefox, you will be asked if you want to install the new extension.

i. For Firefox >= 53.

A little warning icon on the menu button indicates that extension is added and you need to enable
it

ii. For Firefox < 53.

A page is shown after restart. It is important that you check the "Allow this installation" check box

User Documentation eID plugin installation guide v1.1.2 14/19

 © UnifiedPost, 2017-06-27

before Continue.

c. After installation the eID plugin can always be enabled/disabled via the Firefox Add-ons Manager

3.2. Uninstalling
In order to uninstall the plugin, its best to close chrome so plugin is not in use. Go to the installation dir,
default path is /Applications/eid-reader and click "Eid Reader plugin Uninstaller.app" to start the uninstall
wizard.

User Documentation eID plugin installation guide v1.1.2 15/19

 © UnifiedPost, 2017-06-27

Click on "Next" button and wait for uninstaller to finish.

Click the "Finish" button to close the uninstaller. The uninstaller should have removed all references and
remove the installation directory. If the installation directory is still present most likely the plugin was still in
use when you ran the uninstall wizard. You can just delete the directory afterwards in that case.

What if you uninstall the extension manually through the Chrome UI?
If you uninstall the extension through the Chrome UI, it will no longer be installed or updated on each startup.
In other words, the external extension is blacklisted (ref).
This uninstall looks like :

or
In this situation running the installer will successfully complete the installation but the extension will not be
added by Chrome to chrome://extensions. Without the extension the eID plugin will not work. To get the
plugin and extension working again you need to get the extension off the blacklist first.

How do I get the extension off the blacklist?

If you accidentally uninstalled the extension through the Chrome UI, you can remove the blacklist tag by
installing the extension normally through the Chrome Web Store, and then uninstalling it with the uninstall
wizard.
To go directly to the extension on Chrome Web Store click here.

User Documentation eID plugin installation guide v1.1.2 16/19

 © UnifiedPost, 2017-06-27

3.3. Updating
In case you run the installer a second time or try to install a new version of the installer without uninstalling
first, the installer will show a different screen after the language selection.

You can just click "Next" to update the eid plugin.

User Documentation eID plugin installation guide v1.1.2 17/19

 © UnifiedPost, 2017-06-27

4. Supported Card readers

4.1. PC/SC compatible readers
We support any PC/SC ("Personal Computer/Smart Card") compatible readers.
Most OS’s support PC/SC out of the box and in most cases, for None Pin Pad Readers, there will be no need for
installing additional drivers.
For more details about PC/SC protocol you please access PC/SC Workgroup.

4.2. Pin Pad Readers

For Pin Pad Readers we rely on the part of PC/SC standard dealing with secure pin entry capabilities, which
assume some CCID protocol features.

Depending on your operating system and system type you may or you may not need to install extra CCID
PC/SC driver for your Pin Pad reader.
There is a need for install extra CCID PC/SC drivers on some Windows operating systems and on Mac OS older
then Mac OS X Yosemite 10.10.
You may need to check and download the reader’s drivers from the manufacturer website and install it before
you can properly use the reader.
If you don’t have enough system rights to install new software on your system you may need to ask your
system administrator for support.

You must be aware that if it is for the first time you plugin the Pin Pad reader in your computer it may take a
while until the operator system will install the corresponding driver or a generic driver for your reader.
So please check that your device is ready to use.

User Documentation eID plugin installation guide v1.1.2 18/19

 © UnifiedPost, 2017-06-27

4.3. Tested Readers

The software was tested on a number of different types of readers and on different OS’s.
The following table gives an overview of these with links to manuafactures or drivers if they needed to be
installed. (Links may be subject to change.)

Pin
Manufactor Reader Name Tested OS’s Drivers
pad

Windows 7, 8, 10 No additional driver needed

VASCO DIGIPASS 905 N
Mac OS Yosemite (10.10), Sierra
No additional driver needed
(10.12)

Windows 7, 8, 10 Vasco drivers

Vasco VASCO DIGIPASS 870 Y
Mac OS Yosemite (10.10), Sierra
No additional driver needed
(10.12)

Windows 7, 8, 10 Vasco drivers

VASCO DIGIPASS 920 Y
Mac OS Yosemite (10.10), Sierra
No additional driver needed
(10.12)

Windows 7, 8 , 10 Gemalto drivers

ING branded Gemalto EZIO
Gemalto Y
Shield Pro Mac OS Yosemite (10.10), Sierra
No additional driver needed
(10.12)

Dell Latitude laptop build in

Dell N Windows 7 No additional driver needed
Smart Card Reader

User Documentation eID plugin installation guide v1.1.2 19/19