Personal Token Software Installation Guide

(1)

SWIFT Certificate Centre

Personal Token Software Installation Guide

This document explains how to install and how to remove the token software for your personal token.

(2)

Preface

Purpose of the document

This document explains how to install and how to remove the token software for your personal token.

Audience

This document is for personal token users.

Significant changes

The following table lists significant changes since the August 2013 release. This does not include various edits that have been made.

New information Location

The configuration of Java settings has been updated.

Configure Java Settings on page 7

The token software installation procedure has been simplified.

Obtain the Token Installation Software on page 8

Updated screenshots have been added to illustrate the installation procedure in interactive mode

Installation Procedure on page 9

Updated screenshots have been added to the installation procedure for silent mode due to the renaming of the properties file.

Install the Token Software in Silent Mode on page 14

Updated screenshots have been added to illustrate the removal procedures.

Remove the Token Software on page 15

(4)

1 Token Software Installation Prerequisites

General prerequisites

• Administrator rights are required to install the necessary drivers and software. • Your PC must be running one of the following operating systems:

- Windows Vista (32-bit) with Service Pack 1 or higher - Windows 7 (32-bit or 64-bit), optionally with a Service Pack - Windows 8 (32-bit or 64-bit)

- Windows 8.1 (32-bit or 64-bit) - Windows 10 (32-bit or 64- bit)

- Windows Server 2008 R2 (32-bit or 64-bit) - Windows Server 2012 (64-bit)

• To access the SWIFT Certificate Centre, you must use one of the following versions of Internet Explorer:

- Internet Explorer 8.0 (32-bit) - Internet Explorer 9.0 (32-bit) - Internet Explorer 10.0 (32-bit) - Internet Explorer 11.0 (32-bit)

For Windows 8 and above: make sure that you have switched to desktop mode before

launching internet explorer.

• Your PC must have free space of at least 500 MB.

• To check this, open Windows Explorer, right-click the C: drive and select Properties. A

System (C:) Properties window opens:

Personal Token Software Installation Guide Token Software Installation Prerequisites

(5)

• To access the SWIFT Certificate Centre, your system requires a 32-bit version of the Java Runtime Environment (JRE). The minimum supported versions are 1.6.0_32 for Java 6, 1.7.0_7 for Java 7, or Java 8. You must download and install the latest version of Java from the Java website.

• The Windows Script Host (WSH) must be enabled for the .vbs scripts used by the installer to execute properly. This setting is enabled by default.

• The Windows Smart Card Service must be started for the proper detection of the certificate by the SafeNet authentication client. This service is started by default.

You can install the token software on a PC that is running either the 32-bit version or the 64-bit version of Windows. However, you must use the 32-bit versions of Internet Explorer and the Java Runtime Environment to access the SWIFT Certificate Centre and configure your tokens. The installation procedure checks that the required versions are installed on your system. For more information, see Installation Procedure on page 9.

(6)

2 Configure Internet Explorer Settings

The required Internet Explorer settings are normally part of its default settings. If the default settings of Internet Explorer have been modified, then make sure that the correct settings are selected or enabled. You can access the settings by going to Internet Explorer > Tools >

Internet Options > Advanced.

SWIFT recommends correctly configuring the Internet Explorer Settings to improve PC

performance and to avoid pop-up warning messages. See the Knowledge Base tip 5019758 for the latest settings.

Personal Token Software Installation Guide Configure Internet Explorer Settings

(7)

3 Configure Java Settings

The required settings of the Java plug-in are normally part of its default settings. If the default settings of the Java plug-in have been modified, then make sure that the correct settings are configured. You can access the settings by going to the Java Control Panel > Advanced. SWIFT recommends correctly configuring the Java settings to improve PC performance and to avoid pop-up warning messages. See the Knowledge Base tip 5019757 for the latest settings. Depending on the version of Java that you are using, some of the settings may not be

applicable. If a setting does not exist for your version, then please ignore it. SWIFT Certificate Centre

(8)

4 Obtain the Token Installation Software

Before you can use your token, you must obtain and download the token installation software.

4.1 Download the installation software

Procedure

1. For Windows 8 and above: From the Start window, click the Desktop tile to enter desktop mode.

2. Navigate to the SWIFT Certificate Centre.

3. On the Getting started page, there is a link that enables you to download the token installation software.

Click the link.

4. Save the software installation file on your PC. The file name is

Personal_token_install.zip.

4.2 Unzip and run the software installation file

Procedure

1. Navigate to the folder in which you saved the installation software zip file. Either unzip the archive and navigate to the extracted folder OR

Double-click the zip file. In either case, the following window appears.

2. Double-click the software installation file contained within the zip file.

The Welcome to the SWIFT Token Client Installer window opens and you are ready to start the installation in Interactive Mode. Refer to Install the software on page 9.

Personal Token Software Installation Guide Obtain the Token Installation Software

(9)

5 Installation Procedure

Install the software

Prerequisites

To install or remove the token software on a PC in interactive mode, you must have administrator rights for that PC.

Note SWIFT recommends that you close all other applications running on the PC before installing the token software.

Procedure

1. After you double-click the software installation file, the Welcome to the SWIFT Token

Client Installer window opens. This window informs you of the actions that are performed

during installation.

Click Next.

The SWIFT Token Client Location window opens.

Important Although it is possible to customise the options, SWIFT recommends that you accept the proposed installation options.

2. If you want to customise the installation, then you can do so by selecting or clearing the following options:

• Install SafeNet Authentication Client - the installer checks whether there is already an

appropriate version of the SafeNet Authentication Client installed on the PC and installs it if needed. The SafeNet software contains the drivers needed for the token to be

recognised.

You can clear this box if you want to install the SafeNet software after the token software is installed.

• Install SWIFT Token Client - this configures the SWIFT environment on the PC and,

therefore, you cannot modify this setting.

• Import SWIFT CA certificate - if you select this box, the installer automatically imports

the SWIFT CA certificate on to your PC. SWIFT Certificate Centre

(10)

Clear this box if your company policy does not allow you to import certificates. (In this case, each time that you access the portal you get a warning pop-up message that says you are using an untrusted certificate. Click OK on the warning, the pop-up closes, and you can access the portal.)

Note If you clear this option and you want to import the SWIFT CA certificate after the token software is installed, then refer to the SWIFT Certificate Centre Troubleshooting Guide on the User Handbook Online for the SWIFT CA certificate import procedure.

• Configure Browser settings - if you select this box, then the installer enables TLS

version 1.0, TLS 1.1 and TLS 1.2 on your internet browser and disables SSL 2.0 and SSL 3.0 as these options are considered not secure.

Please check the recommended TLS and SSL settings in the section Configure Internet Explorer Settings on page 6 and the section Configure Java Settings on page 7.

When you have selected your installation options, click Next. 3. The SWIFT Token Client Location window opens.

It shows the proposed folder location for the software installation files. If you want to change the default location, then click Browse... and navigate to the required folder for installation. However, the SafeNet authentication software is stored in a default folder that cannot be changed. The location of this software is shown in the field SafeNet Authentication Client

Folder Name.

Click Next.

4. The installer then runs a test to verify that the PC can support the token software installation. This can take a few moments to complete.

If one or more of the configuration tests fail, then the System Configuration Test Results window opens.

If all of the configuration tests are successful, then the SWIFT Token Client Installer confirmation window opens (see the next step).

Personal Token Software Installation Guide Installation Procedure

(11)

The tests compare the Recommended conditions for installation to the Actual conditions of the user's PC.

The Result in each case appears as OK, as a Warning or an ERROR.

If there is a Warning/ERROR, then an explanation appears in the lower half of the screen. In the case of a Warning, the installation can continue. In the case of an ERROR, it cannot. In the example above, the PC does not have a recommended version of Java installed on it. It is only a Warning because the installation can complete with a lower version of Java, but there can be problems when accessing the SWIFT portal.

In this case, there is also a link directly to the Java web site from where you can download the latest version of Java software.

Click Next.

5. The SWIFT Token Client Installer confirmation window opens.

It confirms the actions that are performed during installation. SWIFT Certificate Centre

(12)

Click Install to proceed with the installation.

The installation can take a couple of minutes. Do not interrupt the installation procedure during this time.

6. The results of the installation appear.

If there is a Warning, then an explanation appears at the bottom of the window. Click Next.

7. The Installation Complete window opens. SWIFT Certificate Centre

Personal Token Software Installation Guide Installation Procedure

(13)

Click Finish.

8. The Reboot notice window opens.

Restart your computer to complete the installation. Click Restart now or Restart later. SWIFT Certificate Centre

(14)

6 Install the Token Software in Silent Mode

In silent mode, you can remotely install the token software without interactive user input. The installation procedure takes the input from a response file instead.

You must extract the installer files to one location, and use a script to install the token software in silent mode.

Prerequisites

To install or remove the token software on PCs in silent mode, you must have administrator rights for all of the PCs involved.

Note SWIFT recommends that you close all other applications running on the PC before installing the token software.

Procedure

1. Extract the contents of the zip file Personal_token_install.zip, including the Silent subfolder to a folder of your choice.

2. Start a DOS command window and navigate to that folder. Execute the following command to start the silent installation: Personal_token_install.exe -silent silent\silent-install.properties

If you want to customise the installation, then you can do so by setting the options in the file

silent-install.properties. This file provides the explanation of each option available. SWIFT Certificate Centre

Personal Token Software Installation Guide Install the Token Software in Silent Mode

(15)

7 Remove the Token Software

You must have administrator rights on each PC from which you want to remove the token software.

7.1 Remove the Token Software in Interactive Mode

Procedure

1. From the Control Panel menu, ensure that you have the View by: Category option active. Click the link Uninstall a program.

The Uninstall or change a program window opens.

2. Select the appropriate SWIFT Token Client program from the list and click Uninstall. The Welcome to the SWIFT Token Client Uninstaller window opens.

3. Click Next.

Click Yes to confirm the uninstallation. The Uninstallation Complete window opens. Click Finish.

The Reboot notice window opens.

The token software is removed, but you must restart your computer for the uninstallation to take effect. You can choose to Restart now or Restart later.

7.2 Remove the Token Software in Silent Mode

In silent mode, you can remotely uninstall the token software without interactive user input. To install or remove the token software on PCs in silent mode, you must have administrator rights for all of the PCs involved.

Note The directory in which the uninstall command is executed is important.

The command must not be under the installation directory otherwise the uninstaller will not be able to remove some installation files.

(16)

Execute the uninstaller as shown in the above example.

The uninstall.exe-silent command line requires a response file as argument. A sample response file is present in the installation folder at %PDI_HOME%\..\config\silent-uninstall.properties.

Personal Token Software Installation Guide Remove the Token Software

(17)

8 Getting Support

SWIFT is the single point of contact to report all problems and queries that relate to SWIFT services and products.

If you require help for the SWIFT Certificate Centre or your personal token, then please refer to

http://www.swift.com/certificates. SWIFT Certificate Centre

(18)

Legal Notices

Copyright

Restricted Distribution

Do not distribute this publication outside your organisation unless your subscription or order expressly grants you that right, in which case ensure you comply with any other applicable conditions.

Disclaimer

The information in this publication may change from time to time. You must always refer to the latest available version.

Translations

The English version of SWIFT documentation is the only official and binding version.

Trademarks

SWIFT is the trade name of S.W.I.F.T. SCRL. The following are registered trademarks of SWIFT: the SWIFT logo, SWIFT, SWIFTNet, Accord, Sibos, 3SKey, Innotribe, the Standards Forum logo, MyStandards, and SWIFT Institute. Other product, service, or company names in this

publication are trade names, trademarks, or registered trademarks of their respective owners. SWIFT Certificate Centre

Personal Token Software Installation Guide Legal Notices

Personal Token Software Installation Guide

SWIFT Certificate Centre