Getting Started with OpenSK

Introduction

This guide details how to get started with the OpenSK using the nRF52840 MDK USB Dongle without going through the complete toolchain installation.

What you'll need

Upgrade to UF2 Bootloader

The nRF52840 MDK USB Dongle was previously shipped with Open Bootloader with Device Firmware Update (DFU) functionality.

Currently, the prebuilt OpenSK firmware only works with the UF2 Bootloader. If your dongle is using UF2 Bootloader, just skip this step.

Note

As Open Bootloader update must come from signed packages, the new UF2 Bootloader must be signed. The signed package is located in: firmware/open_bootloader/uf2_bootloader-0.2.13-44-gb2b4284-nosd_signed.zip

Enter DFU mode by holding the dongle's RESET/USR button and connecting to your PC. Use the following command to update firmware:

nrfutil dfu usb-serial -pkg uf2_bootloader-0.2.13-44-gb2b4284-nosd_signed.zip -p <your-serial-port-name>

Flash OpenSK via UF2 Bootloader

The prebuilt OpenSK firmware is located in firmware/OpenSK with the .uf2-format.

Enter DFU mode by holding the dongle's RESET/USR button and connecting to your PC. A flash drive with the name MDK-DONGLE will appear.

Copy opensk_nrf52840_mdk_usb_dongle_gece14d7.uf2 image to MDK-DONGLE.

When programming is completed, the OpenSK will run automatically. The device named OpenSK will detected by the computer.

Test OpenSK

Now you can test the OpenSK via WebAuthn.io:

Explore More

The two-factor authentication (2FA) has been successfully deployed by a growing number of websites, including Google, social networks, cloud providers, and many others. Happy trying!

Create an Issue

Interested in contributing to this project? Want to report a bug? Feel free to click here: