Difference between revisions of "BwUniCluster 2.0 User Access/2FA Tokens"

From bwHPC Wiki
Jump to: navigation, search
Line 21: Line 21:
 
* Authy for [https://authy.com/download/ Mac]
 
* Authy for [https://authy.com/download/ Mac]
   
  +
These are only suggestions. You can use any application compatible with the [https://tools.ietf.org/html/rfc6238 TOTP] standard.
[[File:Freeotp-example.png|center|An example of the FreeOTP app on Android, displaying generated One-Time Passwords for various services]]
 
  +
<br/>
  +
<br/>
   
  +
[[File:Freeotp-example.png|center|An example of the FreeOTP app on Android, displaying generated One-Time Passwords for various services|]]
These are only suggestions, you can use any application compatible with the [https://tools.ietf.org/html/rfc6238 TOTP] standard.
 
   
 
= Token Management =
 
= Token Management =
   
bwUniCluster 2.0 Tokens are be managed via the '''My Tokens''' menu entry on the central [https://bwidm.scc.kit.edu/ bwIDM] system.
+
bwUniCluster 2.0 Tokens are be managed via the '''My Tokens''' menu entry on the central [https://bwidm.scc.kit.edu/ bwIDM] system. Here you can register, activate, deactivate and delete tokens.
  +
  +
== Registering a new token ==
  +
  +
1. Registering a new Token starts with a click on '''New smartphone token'''. If you happen to own a USB hardware token device made by '''Yubikey''', you can click on '''New Yubikey token''' instead.
  +
  +
[[File:BwUniCluster 2.0 2fa register new empty.png|center|]]
  +
  +
2. A new windows opens. Click on '''Start''' to generate a new QR code. This may take a while. '''NOTE: The QR code contains a key which has to remain secret. Only use the QR code to link your software token app with bwIDM in the next step. Do not save the QR code, print it out or share it with someone else. You can always generate more codes later.'''
  +
  +
[[File:BwUniCluster 2.0 2fa register new qr.png|center|]]

Revision as of 17:20, 4 August 2020

Since August 13, 2020 a 2-factor authentication mechanism (2FA) is being enforced for logins to bwUniCluster 2.0 to improve security. In addition to the service password a second value, the second factor, has to be entered on every login.

1 How 2FA works

For bwUniCluster we use six-digit, auto-generated, time-dependent One-Time Passwords (TOTP). These passwords are generated by a piece of software which is part of a special hardware device (a Hardware Token) or of a normal application running on a common device (a Software Token).

The token has to be synchronized with a central server before it can be used for authentication and then generates an endless stream of six-digit values which can only be used once and are only valid during a very short interval of time. This makes it much harder for potential attackers to access the HPC system, even if they know the regular service password.

It is very important that the device which generates the One-Time Passwords and the device which is used to log into bwUniCluster 2.0 are not the same. Otherwise an attacker who gains access to your system can steal both the service password and the secret key of the software token application, which allows them to generate One-Time Passwords and log into the HPC system without your knowledge.

The most common solution is to use a mobile device (e.g. your smartphone or tablet) as a software token by installing one of the following apps:

These are only suggestions. You can use any application compatible with the TOTP standard.

Freeotp-example.png

2 Token Management

bwUniCluster 2.0 Tokens are be managed via the My Tokens menu entry on the central bwIDM system. Here you can register, activate, deactivate and delete tokens.

2.1 Registering a new token

1. Registering a new Token starts with a click on New smartphone token. If you happen to own a USB hardware token device made by Yubikey, you can click on New Yubikey token instead.

BwUniCluster 2.0 2fa register new empty.png

2. A new windows opens. Click on Start to generate a new QR code. This may take a while. NOTE: The QR code contains a key which has to remain secret. Only use the QR code to link your software token app with bwIDM in the next step. Do not save the QR code, print it out or share it with someone else. You can always generate more codes later.

BwUniCluster 2.0 2fa register new qr.png