ZignSec

Test App for BankID -se

Link to the official Swedish BankID integration portal
Link to BankID´s offical PDF guide for installing a Bankid app for test

There are two ways to run the BankID app for test: 1. On a mobile app for Android/IPhone (recommended) or 2. On a PC/Mac.

1. BankID app for test on Android/IPhone mobile phone.

This is the easiest and most realistic approach since 98% of all authorizations steps are performed on the BankID mobile app, and only 2% of the authorization actions are performed on a PC or Mac. Note that the authorization request is very often initiated from a PC/Mac but the authorization action per se is performed on a mobile phone.

For Android: The link to the Android APK-file can be found here. This approach can be more convenient for testers that want to keep the BankID production app in use. The setup needs a few extra steps to allow non-trusted applications on the mobile, see for example the android instructions on the BankID help instructions below.

For IPhone: Uninstall any existing version of BankID Security App. Install BankID Security App from App Store. In Settings * BankID * Developer * Server enter cavainternal.test.bankid.com. BankID Security App will now connect to the test server. Please note that the app must be uninstalled to undo the change.

2. BankID app on on PC/Mac, configued for test aka “certificate on file”

See Step-by-step guide below.
The process should be run from demo.bankid.com and takes a couple of minutes. With a PC/Mac install there is no need to interupt the production BankID mobile app. For a more detailed description see this.

[If the testversion installation process runs into problems, you can adjust the production version of a BankID app, installed from https://install.bankid.com and configure it for test by adding the extra textfile CavaServerSelect.txt which should be saved containing the text kundtest into the folder (for Windows) %appdata%\bankid\Config (note that this instruction can also be found here https://demo.bankid.com/Konfigurera.aspx)]

Step by step – Swedish BankID for Test (on file)

Note: if the below install ends with failure try to kill the BankID process with Task Manager and start over.
Browse to demo.bankid.com and click Generate new code.

Fill out all fields, but only the email address needs to be correct. Press Order code to receive an email.

Confirmation message that asks you to open your email.

Open your email and copy the code.

Go back to the start page demo.bankid.com, now login with the received code.

Now chose Issue bankid for test.

In this example we chose to Issue BankID on file. (for a personal computer.)

The personal number and name here can be chosen freely, but the personal number needs to be correctly formatted, for example 198710243505 for a Swedish woman born on October 24th 1987.

Press Issue.

A popup will appear, press the only available button Open BankID Issuing.

A new browser window will be started where you can download the BankID application and activate your new user.

Press Download the BankID application if this is the first time. In case of problems it is often better to click “I have the most recent BankID application, proceed without installation.”

The application will be downloaded and you will need to Run the installer.

After the installation is complete you should activate your bankid with the new user and chose a password.

Press Start to start the BankID application.

In the BankID application you will immediately be asked to set a password for the new user, 6 digits is enough.

The new BankID user is setup and is ready to be used.

How to install a Swedish BankID for Test on File (long text description)

You need to install the current version of the BankID-app and also install and activate the account for BankID for Test on file. Follow these steps:

  1. Browse to https://demo.bankid.com/
  2. To get a BankID for Test (and you don’t already have one installed for Production), you first need to generate and login with a code. Click on Generate code at the bottom left.
  3. You will be redirected to  https://demo.bankid.com/CreateCode.aspx . Here you need to enter some personal information such as your name, email and organization.
  4. Press Order Code. You will now receive a personal code in an email.
  5. Return to https://demo.bankid.com/ and paste the code into the text box at the bottom left and chose Log in (with personal code)
  6. You will be redirected to this page: https://demo.bankid.com/MainMenu.aspx Press the button Issue (BankID for test)
  7. You will be redirected to this page: https://demo.bankid.com/Hamta.aspx. Here you should  use the right side of the form ”Issue BankID on file” and choose a fake or existing Swedish personal number, and any first and last name for your testperson. I chose ”191212121212” because I know that number is a technically valid personal number, and the name ”Chris” ”Cat”.
  8. You will see a popup overlay window in the browser with the title ”Open BankID issuing”. Push button  ”Open BankID issuing”.
  9. A 3-step guide will open up in a new browser window. This will guide you through the process of installing BankID-app and create and activate a test certificate on file. You can change the language in the guide to english if you want to.
  10. Press the button  ”DOWNLOAD THE BANKID-APPLICATION” or click on the link ”I already have the latest version of the BankID-app, continue without installation >” (this document has not yet checked the exact English wordings…)
  11. On the third and last step of the guide you will activate you BankID for test (your test certificate) by choosing a personal, at least 6 letter, password. Press ”CONTINUE” and in the next popup window press ”Start the application”.
  12. Then the BankID-app will pop up and you will get to create the BankID password that you will use every time you are asked to authenticate or sign through the Swedish BankID process. I for example chose the password ”chriscat”
  13. When the guide is complete you can test your ”BankID on file” through the page https://demo.bankid.com/  Click on ”Log in” (with test BankID) at the top left.
  14. You will be redirected tol https://demo.bankid.com/Logon.aspx?environment=Kundtest where you can select on the left side Log in (BankID on same device).
  15. When you have pressed  ”Log in” the BankID-app will start in a small popup window, and you can select your test user in the drop down (you can have many) and enter the password for the test user. Then you should press the button ”I authenticate”. You should not get an error message.
  16. You will be redirected back to the page: https://demo.bankid.com/MainMenu.aspx. Here you can also test the function ”Sign” by pushing the button Sign.
  17. The BankID-app will again start in a window –  This time with an user defined text to sign, select the test user and enter the user password and press the ”I Sign”-button.