SWIFT Certificate Centre

Personal Token Software Installation Guide

This document explains how to install and how to remove token software, which is used to support the connection
between tokens and applications.

23 April 2021

Link to this document: https://www2.swift.com/go/book/book123493

SWIFT Certificate Centre Table of Contents
Personal Token Software Installation Guide

Table of Contents

Preface............................................................................................................................................................... 3

1 Token Software Installation Prerequisites............................................................................................ 4

2 Configure Browser Settings................................................................................................................... 5

3 Obtain the Token Installation Software................................................................................................. 6

3.1 Download the installation software.......................................................................................................... 6
3.2 Extract and run the software installation file............................................................................................ 6

4 Install the Token Software...................................................................................................................... 7

4.1 Install the Token Software in Interactive Mode........................................................................................ 7
4.2 Install the Token Software in Silent Mode..............................................................................................13

5 Update the Token Software...................................................................................................................15

6 Remove the Token Software.................................................................................................................16

6.1 Remove the Token Software in Interactive Mode.................................................................................. 16
6.2 Remove the Token Software in Silent Mode..........................................................................................16

7 Getting Support..................................................................................................................................... 17

How-to Videos................................................................................................................................................. 18

Legal Notices................................................................................................................................................... 19

23 April 2021 2
SWIFT Certificate Centre Preface
Personal Token Software Installation Guide

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.

Enhancement and features of the personal token software

At the time this guide's publication, the latest version of the Personal Token Software is version 4.1
from 18 October 2019. SWIFT recommends that you install the latest version that includes all
changes from the previous versions. For a description of the changes in the personal token
software, refer to the release letter accompanying the software. The release letters for supported
versions are also available under the SWIFT Certificate Centre product section of the Knowledge
Centre.

Significant changes
The following table lists the main changes since the previous publication of this document, but does
not include general edits and minor updates.

New information Location

A new topic "Enhancement and features of the Preface on page 3

personal token software" reflects the version of the
software supported at the time of publication and
directs to release letters for the list of changes

Information specific to Java applets was removed Section removed

Internet Explorer settings section was replaced with Configure Browser Settings
browser settings section

Prerequisites, download, installation, and removal Token Software Installation Prerequisites

instructions were enhanced
Obtain the Token Installation Software
Install the Token Software
Remove the Token Software

Instructions to update the token software were added Update the Token Software

23 April 2021 3
SWIFT Certificate Centre Token Software Installation Prerequisites
Personal Token Software Installation Guide

1 Token Software Installation Prerequisites

Before you can activate and use your personal token on SWIFT portals you must install the
personal token software and SConnect on each computer on which you intend to use the token.
Minimum configuration requirements

Type Description

Browser Internet Explorer 11 (minimum version 11.0.9600.18617)

Firefox (minimum recommended version 67.0.1)
See Operating systems and browser support in the SConnect
Installation Guide for more information.

Operating System For personal computer operating systems, SWIFT recommends a

Windows 8.1 or Windows 10 PC or newer (32-bit or 64-bit).
For server operating systems, SWIFT recommends Windows
Server 2012 or newer (32-bit or 64-bit).

Important • To install token software, you must have administrator rights.

Refer to the SConnect Installation Guide for instructions to install SConnect and detailed
information about configuring your browser.
The personal token software and SConnect can be obtained from the SWIFT Download Centre.
SConnect can also be installed from the SWIFT Certificate Centre website or by logging in to the
SWIFT Certificate Centre portal.
When the token software is installed, the PC is ready for the personal token.
The SWIFTNet security officer must define a new SWIFTNet user for each personal token user.

Verify system configuration

You can verify your system configuration by running the SelfTest in the Start menu > All Programs
> Swift Token Client. The results will appear after a few seconds. Running the SelfTest requires
administrative rights.

Note The SelfTest is only available after the token software is installed.

Related information
SConnect Installation Guide
Getting Started with your Personal Token

23 April 2021 4
SWIFT Certificate Centre Configure Browser Settings
Personal Token Software Installation Guide

2 Configure Browser Settings

Refer to the documentation specific to your service for information about browsers and required
settings.
SWIFT Services using personal tokens generally require SConnect. You can refer to the SConnect
Installation Guide for information about configuring Internet Explorer and Firefox.
Refer to the Knowledge Base article Internet Explorer settings to be configured for additional
recommendations.

23 April 2021 5
SWIFT Certificate Centre Obtain the Token Installation Software
Personal Token Software Installation Guide

3 Obtain the Token Installation Software

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

3.1 Download the installation software

Procedure
1. Navigate to the Personal Token Software page in the SWIFT Download Centre. To reach the
SWIFT Download Centre you can also navigate to the SWIFT Certificate Centre and click the
link "Get the Personal Token Software".
2. Select the latest version of the Personal Token Software, agree to the terms and conditions,
and click Download .
3. Save the software installation file on your PC. The file name is Personal_token_install.zip.

3.2 Extract and run the software installation file

Procedure
1. Navigate to the folder in which you saved the installation software zip file.
Either extract 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.
Note If your account does not have local administrator rights, or if you encounter an
issue during installation, then SWIFT recommends that you copy the
Personal_token_install.exe file to your desktop, right-click it and select
Run as administrator .

What to do next
Install the Token Software in Interactive Mode on page 7

23 April 2021 6
SWIFT Certificate Centre Install the Token Software
Personal Token Software Installation Guide

4 Install the Token Software

You must have administrator rights on each PC on which you want to install the token software.
End-users or system administrators who install on a single computer can refer to the section Install
the Token Software in Interactive Mode.
System administrators who deploy for multiple users can refer to the section Install the Token
Software in Silent Mode.

4.1 Install the Token Software in Interactive Mode

Before you begin
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. Remove all USB tokens.

23 April 2021 7
SWIFT Certificate Centre Install the Token Software
Personal Token Software Installation Guide

2. 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.

3. 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 check box if you want to install the SafeNet software separately 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 certificates - if you select this box, then the installer automatically
imports the SWIFT CA certificates on to your PC.
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.)

23 April 2021 8
SWIFT Certificate Centre Install the Token Software
Personal Token Software Installation Guide

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 Knowledge Centre for the SWIFT CA certificate
import procedure.
• Configure Browser Settings - if you select this box, then the installer enables TLS version
1.2 on your internet browser. TLS 1.0, TLS 1.1, SSL 2.0 and SSL 3.0 will be disabled as
these are considered not secure.
When you have selected your installation options, click Next .
4. 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 .

23 April 2021 9
SWIFT Certificate Centre Install the Token Software
Personal Token Software Installation Guide

5. 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).
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, the
installation cannot continue.
Click Next .

23 April 2021 10
SWIFT Certificate Centre Install the Token Software
Personal Token Software Installation Guide

6. The SWIFT Token Client Installer confirmation window opens.

It confirms the actions that are performed during installation.

Click Install to proceed with the installation.
The installation can take a couple of minutes. Do not interrupt the installation procedure during
this time.

23 April 2021 11
SWIFT Certificate Centre Install the Token Software
Personal Token Software Installation Guide

7. The results of the installation appear.

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

Click Next .

23 April 2021 12
SWIFT Certificate Centre Install the Token Software
Personal Token Software Installation Guide

8. The Installation Complete window opens.

Click Finish .
9. The Reboot notice window opens.

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

4.2 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.
Before you begin
To install or remove the token software on PCs in silent mode, you must have administrator rights
for the PC involved.
Note SWIFT recommends that you close all other applications running on the PC before
installing the token software.

23 April 2021 13
SWIFT Certificate Centre Install the Token Software
Personal Token Software Installation Guide

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 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.

23 April 2021 14
SWIFT Certificate Centre Update the Token Software
Personal Token Software Installation Guide

5 Update the Token Software

To update the token software you must uninstall the old version, restart the computer, and install
the new version.
Procedure
1. Uninstall the old version.
Refer to the section Remove the Token Software in Interactive Mode.
Depending on the currently installed version of the token software, uninstall the following
elements:
• SWIFT Token Client 4.0.28
• SWIFT Token Client 4.0.26
• SWIFT Token Client 4.0.25
• SWIFT Token Client 4.0.24
• eToken PKI Client 5.1 SP1
2. Restart your computer.
When updating from an older version of the token software, it is necessary to restart the
computer between uninstalling the older version and installing the newer version.
3. Install the newer version.
Refer to the section Install the Token Software.

23 April 2021 15
SWIFT Certificate Centre Remove the Token Software
Personal Token Software Installation Guide

6 Remove the Token Software

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

6.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 .

6.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 the PC involved.
Note When the uninstall command is invoked from a shell, the installation folder containing
uninstall.exe must not be opened, and the silent-uninstall.properties file
must be invoked from a different location than the installation folder. Otherwise, the
uninstaller will not be able to remove some installation files.

A sample silent-uninstall.properties response file is available in the installation sources.

Assuming the sources have been extracted in the user's Downloads folder, the uninstall command
can be invoked as follows:
C:\Program Files (x86)\SWIFT\SWIFT Token Client\_uninst\uninstall.exe -silent
C:\Users\Username\Downloads\Personal_token_software\silent\silent-
uninstall.properties

23 April 2021 16
SWIFT Certificate Centre Getting Support
Personal Token Software Installation Guide

7 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, refer to the
Troubleshooting Guide and Knowledge Centre publications and articles. You can also contact
Support through the usual channels.

23 April 2021 17
SWIFT Certificate Centre How-to Videos
Personal Token Software Installation Guide

How-to Videos
SWIFT has created videos that show how to perform specific tasks. You can access these videos
through the Knowledge Centre on www.swift.com. A swift.com user name (e-mail) and password
are required. SWIFT adds new videos on a regular basis.

Installation and activation

Personal tokens require activation and the installation of personal token software and SConnect.
• How to install the personal token software
• How to install the SConnect browser extension for Internet Explorer
• How to install the SConnect browser extension in Firefox
• How to activate your personal token

Video series for SWIFT Certificate Centre

SWIFT Certificate Centre is a portal that enables personal token owners to manage their PKI
credentials that are stored on the token. Users require a token to access the SWIFT Certificate
Centre. The portal enables a user who has token activation secrets to activate a token and set its
password.
A user may activate a token, change the token password, reset, or renew the token on the SWIFT
Certificate Centre portal.
• How to change your personal token password in the SWIFT Certificate Centre
• How to check your personal certificate information and renew your token before it expires
• How to reset a personal token in SWIFT Certificate Centre

Video series for personal token certificates

Personal tokens require a series of administrative tasks to create a valid certificate to store on a
personal token. The token end-user, or operator, then activates the token.
1. A security officer must log in to the SWIFTNet Online Operations Manager to create a valid
certificate to store on a personal token.
2. If the institution uses the 4-eyes principle, then a second security officer must use the
authentication token to authorise and obtain the activation secrets.
3. With the activation secrets, the operator can activate a new or re-initialised token with SWIFT
Certificate Centre.
4. The activated token is ready for use to authenticate the operator with an application.
• How to access SWIFTNet Online Operations Manager from Alliance Web Platform
• How to create a personal token certificate in SWIFTNet Online Operations Manager
• How to approve a personal token certificate in SWIFTNet Online Operations Manager, as a
security officer, and obtain its activation secrets

Additional helpful videos

• How to recover a personal token certificate in SWIFTNet Online Operations Manager
• How to set up Certificates Report in Online Operations Manager (O2M)
• How to recover and activate Personal Token certificates using Secure Channel
• How to remove Orphan Objects from a Personal Token

23 April 2021 18
SWIFT Certificate Centre Legal Notices
Personal Token Software Installation Guide

Legal Notices
Copyright
SWIFT © 2021. All rights reserved.

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. SC. The following are registered trademarks of SWIFT:
3SKey, Innotribe, MyStandards, Sibos, SWIFT, SWIFTNet, SWIFT Institute, the Standards Forum
logo, the SWIFT logo, SWIFT gpi with logo, the SWIFT gpi logo, and UETR. Other product, service,
or company names in this publication are trade names, trademarks, or registered trademarks of
their respective owners.

23 April 2021 19