From b9baae828668f8caca9d5177b97d17579c2b3c7a Mon Sep 17 00:00:00 2001 From: superskybird Date: Thu, 13 Aug 2020 10:44:06 +0800 Subject: [PATCH] Deployed 71c7a7a with MkDocs version: 1.1.2 --- hardware/index.html | 9 +++++---- search/search_index.json | 2 +- sitemap.xml | 8 ++++---- sitemap.xml.gz | Bin 196 -> 196 bytes 4 files changed, 10 insertions(+), 9 deletions(-) diff --git a/hardware/index.html b/hardware/index.html index 23d2b69..5c4bb8c 100644 --- a/hardware/index.html +++ b/hardware/index.html @@ -412,7 +412,8 @@

Overview

-

We have two types of OpenSK, V1 and V2. They have almost same schematic but different casing.

+

We have two types of OpenSK, V1 and V2. They have almost same schematic but different casing.
+Currently only V2 is available to the market.

OpenSK V2

OpenSK V1

@@ -422,7 +423,7 @@

The LED and User button are together. The button material is transparent, so user can see LED light through the button.

1. Switch To bootloader mode

-

After user connects the device to computer, user should push and hold on the user button for more than 8 seconds, then OpenSK will be in bootloader mode.

+

After user connects the device to computer, push and hold on the user button for more than 8 seconds and then release the button. If the red LED is breathing, OpenSK is in bootloader mode.

2. LED status

@@ -436,12 +437,12 @@ - + - + diff --git a/search/search_index.json b/search/search_index.json index de712e3..84e3115 100644 --- a/search/search_index.json +++ b/search/search_index.json @@ -1 +1 @@ -{"config":{"lang":["en"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"\u00b6 Welcome to Feitian OpenSK USB Dongle \u00b6 OpenSK was announced by Google at January 30, 2020. It is a fully open-source FIDO security key implementation, include hardware and software. In that announcement , Google said By opening up OpenSK as a research platform, our hope is that it will be used by researchers, security key manufacturers, and enthusiasts to help develop innovative features and accelerate security key adoption. The firmware of OpenSK is developed in Rust and it implements both FIDO U2F and FIDO2 specifications . These specifications are released by FIDO Alliance , which is an open industry association with a focused mission: authentication standards to help reduce the world\u2019s over-reliance on passwords. FEITIAN is the Board Member. To help and accelerate FIDO security key adoption, FEITIAN improves the housing and makes new design of OpenSK USB Dongle, remove unused PCB components, public the design. Users can build firmware from source code of Google OpenSK github repository without changing anything, provision it to this OpenSK hardware, to experence and try FIDO authentications. Before you try to program firmware to OpenSK, please read original OpenSK guide at first. The following documents are most like additional remarks. OpenSK Model \u00b6 We have two model of OpenSK USB Dongle, V1 and V2. They are designed according to nRF52840 USB dongle , which is used by Google OpenSK firmware. The difference between V1 and V2 is the method to enter bootloader mode. To OpenSK V1, user should insert a paper clip or a SIM-eject tool to the RESET button hole to enter bootloader mode. This is similar as user push the RESET button on nRF52840 USB dongle. To OpenSK V2, after user connects the device to computer, he should push and hold on the user button for more 8 seconds, then OpenSK will be in bootloader mode. For detailed informations, please refer to hardware description page . Programming firmware \u00b6 Pre-requisite \u00b6 The OpenSK USB Dongle V1 or V2. Before you program the firmware to OpenSK USB Dongle, you should switch it to bootloader mode. Please refer to Harware Page to learn how to switch OpenSK to bootloader mode. Read Original OpenSK guide. Before you perform following opertaions, please read OpenSK and its installation guide to learn how to customize your security key, for example, to change the signature counter mechnisam and Attestation Certificate. Install nrfutil tool. This tool allows you to directly flash firmware to OpenSK over USB without additional hardware. Develop Environment and configuration \u00b6 Prepare develop environment. You should prepare developing environment by yourself according to this section . Clone Google OpenSK github repository . $ git clone --recursive https://github.com/google/OpenSK.git Initial setup. If you just cloned this repository, you need to run the following script: $ ./setup.sh For more information, please refer to Initial setup . Configure the OpenSK security parameter. Please follow the description to change Attestation Certificate as you want. If you are not familar with OpenSK and FIDO, we recommend you do not change anything. Flashing the firmware \u00b6 Although you can download the firmware to our OpenSK V1 and V2 by using J-LINK as described in OpenSK installation guide , we recommend you program the firmware through USB interface, it is more convenient. Switch OpenSK to bootloader mode. Please refer to OpenSK Model or hardware page to learn how to switch OpenSK to bootloader mode. The LEDs show different behaviour in differet mode. Please refer to hardware page to see LED status of OpenSK V1 and V2 . Program the OpenSK USB dongle. $ ./deploy.py --board=nrf52840_dongle_dfu --opensk --programmer=nordicdfu When prompt Press [ENTER] when ready. Just press Enter, the firmware will be flahsed to your OpenSK USB Dongle. When progress bar reaches 100%, OpenSK USB Dongle will be in working mode automatically. You can now test FIDO function. Test FIDO functions \u00b6 Please refer to Test Page .","title":"Home"},{"location":"#_1","text":"","title":""},{"location":"#welcome-to-feitian-opensk-usb-dongle","text":"OpenSK was announced by Google at January 30, 2020. It is a fully open-source FIDO security key implementation, include hardware and software. In that announcement , Google said By opening up OpenSK as a research platform, our hope is that it will be used by researchers, security key manufacturers, and enthusiasts to help develop innovative features and accelerate security key adoption. The firmware of OpenSK is developed in Rust and it implements both FIDO U2F and FIDO2 specifications . These specifications are released by FIDO Alliance , which is an open industry association with a focused mission: authentication standards to help reduce the world\u2019s over-reliance on passwords. FEITIAN is the Board Member. To help and accelerate FIDO security key adoption, FEITIAN improves the housing and makes new design of OpenSK USB Dongle, remove unused PCB components, public the design. Users can build firmware from source code of Google OpenSK github repository without changing anything, provision it to this OpenSK hardware, to experence and try FIDO authentications. Before you try to program firmware to OpenSK, please read original OpenSK guide at first. The following documents are most like additional remarks.","title":"Welcome to Feitian OpenSK USB Dongle"},{"location":"#opensk-model","text":"We have two model of OpenSK USB Dongle, V1 and V2. They are designed according to nRF52840 USB dongle , which is used by Google OpenSK firmware. The difference between V1 and V2 is the method to enter bootloader mode. To OpenSK V1, user should insert a paper clip or a SIM-eject tool to the RESET button hole to enter bootloader mode. This is similar as user push the RESET button on nRF52840 USB dongle. To OpenSK V2, after user connects the device to computer, he should push and hold on the user button for more 8 seconds, then OpenSK will be in bootloader mode. For detailed informations, please refer to hardware description page .","title":"OpenSK Model"},{"location":"#programming-firmware","text":"","title":"Programming firmware"},{"location":"#pre-requisite","text":"The OpenSK USB Dongle V1 or V2. Before you program the firmware to OpenSK USB Dongle, you should switch it to bootloader mode. Please refer to Harware Page to learn how to switch OpenSK to bootloader mode. Read Original OpenSK guide. Before you perform following opertaions, please read OpenSK and its installation guide to learn how to customize your security key, for example, to change the signature counter mechnisam and Attestation Certificate. Install nrfutil tool. This tool allows you to directly flash firmware to OpenSK over USB without additional hardware.","title":"Pre-requisite"},{"location":"#develop-environment-and-configuration","text":"Prepare develop environment. You should prepare developing environment by yourself according to this section . Clone Google OpenSK github repository . $ git clone --recursive https://github.com/google/OpenSK.git Initial setup. If you just cloned this repository, you need to run the following script: $ ./setup.sh For more information, please refer to Initial setup . Configure the OpenSK security parameter. Please follow the description to change Attestation Certificate as you want. If you are not familar with OpenSK and FIDO, we recommend you do not change anything.","title":"Develop Environment and configuration"},{"location":"#flashing-the-firmware","text":"Although you can download the firmware to our OpenSK V1 and V2 by using J-LINK as described in OpenSK installation guide , we recommend you program the firmware through USB interface, it is more convenient. Switch OpenSK to bootloader mode. Please refer to OpenSK Model or hardware page to learn how to switch OpenSK to bootloader mode. The LEDs show different behaviour in differet mode. Please refer to hardware page to see LED status of OpenSK V1 and V2 . Program the OpenSK USB dongle. $ ./deploy.py --board=nrf52840_dongle_dfu --opensk --programmer=nordicdfu When prompt Press [ENTER] when ready. Just press Enter, the firmware will be flahsed to your OpenSK USB Dongle. When progress bar reaches 100%, OpenSK USB Dongle will be in working mode automatically. You can now test FIDO function.","title":"Flashing the firmware"},{"location":"#test-fido-functions","text":"Please refer to Test Page .","title":"Test FIDO functions"},{"location":"about/","text":"Feitian Technologies US, Inc. \u00b6 Website: https://xpasskey.com Online Store: https://shop.ftsafe.us [US & CANADA] Amazon Store: https://www.amazon.com/s?me=A30V4CZBKPUCSD&marketplaceID=ATVPDKIKX0DER Feitian Technologies Co., Ltd. \u00b6 Website: https://www.ftsafe.com Online Store: https://www.ftsafe.com/Store [Other regions] Alibaba Store: https://ftsafe.en.alibaba.com/ [Other regions]","title":"About"},{"location":"about/#feitian-technologies-us-inc","text":"Website: https://xpasskey.com Online Store: https://shop.ftsafe.us [US & CANADA] Amazon Store: https://www.amazon.com/s?me=A30V4CZBKPUCSD&marketplaceID=ATVPDKIKX0DER","title":"Feitian Technologies US, Inc."},{"location":"about/#feitian-technologies-co-ltd","text":"Website: https://www.ftsafe.com Online Store: https://www.ftsafe.com/Store [Other regions] Alibaba Store: https://ftsafe.en.alibaba.com/ [Other regions]","title":"Feitian Technologies Co., Ltd."},{"location":"hardware/","text":"Overview \u00b6 We have two types of OpenSK, V1 and V2. They have almost same schematic but different casing. OpenSK V2 \u00b6 It has a metal housing with only one button in the aft area. NOTE The LED and User button are together. The button material is transparent, so user can see LED light through the button. 1. Switch To bootloader mode \u00b6 After user connects the device to computer, user should push and hold on the user button for more than 8 seconds, then OpenSK will be in bootloader mode. 2. LED status \u00b6 LED behaviour Mode type Triger Method Red LED is breathing bootloader mode Use a paper clip or a SIM-eject tool to push RESET button in RESET button hole Red LED is flashing bootloader mode Flashing the firmware No LED on Working mode Idle R/G/B LED is flashing Working mode Wait for user presence when receiving FIDO command 3. Hardware \u00b6 The hardawre schematic and PCB are shared here . OpenSK V1 \u00b6 It has a 3D-printed case with one user button and one RESET button. 1. Switch To bootloader mode \u00b6 After connect OpenSK to USB port, please insert a paper clip or a SIM-eject tool to the RESET button hole to switch it to bootloader mode. This is similar as user pushes the RESET button on original nRF52840 USB dongle. NOTE RESET button hole is covered by OpenSK label. So if you want to program the firmware occasionally, you can choose not to cover the label although we send the label to you together with OpenSK hardware. 2. LED status \u00b6 LED behaviour Mode type Triger Method Blue LED is breathing bootloader mode Use a paper clip or a SIM-eject tool to push RESET button in RESET button hole Blue LED is flashing bootloader mode Flashing the firmware No LED on Working mode Idle R/G/B LED is flashing Working mode Wait for user presence when receiving FIDO command 3. Hardware \u00b6 The hardawre schematic and PCB files can be downloaded here .","title":"Hardware"},{"location":"hardware/#overview","text":"We have two types of OpenSK, V1 and V2. They have almost same schematic but different casing.","title":"Overview"},{"location":"hardware/#opensk-v2","text":"It has a metal housing with only one button in the aft area. NOTE The LED and User button are together. The button material is transparent, so user can see LED light through the button.","title":"OpenSK V2"},{"location":"hardware/#1-switch-to-bootloader-mode","text":"After user connects the device to computer, user should push and hold on the user button for more than 8 seconds, then OpenSK will be in bootloader mode.","title":"1. Switch To bootloader mode"},{"location":"hardware/#2-led-status","text":"LED behaviour Mode type Triger Method Red LED is breathing bootloader mode Use a paper clip or a SIM-eject tool to push RESET button in RESET button hole Red LED is flashing bootloader mode Flashing the firmware No LED on Working mode Idle R/G/B LED is flashing Working mode Wait for user presence when receiving FIDO command","title":"2. LED status"},{"location":"hardware/#3-hardware","text":"The hardawre schematic and PCB are shared here .","title":"3. Hardware"},{"location":"hardware/#opensk-v1","text":"It has a 3D-printed case with one user button and one RESET button.","title":"OpenSK V1"},{"location":"hardware/#1-switch-to-bootloader-mode_1","text":"After connect OpenSK to USB port, please insert a paper clip or a SIM-eject tool to the RESET button hole to switch it to bootloader mode. This is similar as user pushes the RESET button on original nRF52840 USB dongle. NOTE RESET button hole is covered by OpenSK label. So if you want to program the firmware occasionally, you can choose not to cover the label although we send the label to you together with OpenSK hardware.","title":"1. Switch To bootloader mode"},{"location":"hardware/#2-led-status_1","text":"LED behaviour Mode type Triger Method Blue LED is breathing bootloader mode Use a paper clip or a SIM-eject tool to push RESET button in RESET button hole Blue LED is flashing bootloader mode Flashing the firmware No LED on Working mode Idle R/G/B LED is flashing Working mode Wait for user presence when receiving FIDO command","title":"2. LED status"},{"location":"hardware/#3-hardware_1","text":"The hardawre schematic and PCB files can be downloaded here .","title":"3. Hardware"},{"location":"test/","text":"Congratulations that you have got your own OpenSK USB dongle, now you can try FIDO functions to do fast online authentication. OpenSK implements FIDO2(CTAP2) and FIDO U2F specifications, it can support any website leveraging W3C WebAuthN . Manage OpenSK \u00b6 There are two ways to manage your OpenSK USB Dongle, include Reset, Set PIN and Change PIN. Windows Settings \u00b6 Open the Windows Settings app , select Accounts , select Sign-in options , select Security Key , and then select Manage . You can then attach OpenSK to USB port to manage it as as you want. NOTE Please refer to Microsoft Document for detailed information. Security Key option in Windows Settings is only available from Windows 10 1903. Chrome Browser \u00b6 From Chrome browser, open URL chrome://settings/securityKeys , or open menu \"Settings\u201d => \u201cPrivacy and security\u201d (More)=> \u201cManage security keys\u201d. You can see Manage security keys page, then you can do corresponding operations following the tips. NOTE I don't know the exact version of Chrome which started to add this UI, but please update it to latest version to have this function. Demo Websites \u00b6 There are a lot of Demo websites list here , you can try and test. Here I recommend - https://webauthn.io/ (from DUO) - https://webauthndemo.appspot.com/ (from Google) WARNING I can not guaranty that all the demo websites can work well with OpenSK. Real use cases \u00b6 There are a lot of online servides which can use FIDO2/U2F to do 2FA or passwordless authentication, please refer to FEITIAN website and click corresponding service ICON to learn. Here just emphasize services from two big FIDO players, Google and Microsoft. Google \u00b6 - Google 2-Step Verification \u00b6 Please refer to Google's help to bind OpenSK to your Google services. Or Take a look at 2.1 of Feitian's help document to bind and try OpenSK instead of ePass FIDO security key. - Googel Advanced Protection \u00b6 Please refer to landing page or help page of Google Advanced Protection to get how to setup. Microsoft \u00b6 Microsoft Account Passwordless Logon \u00b6 Please refer to Microsoft Blog to learn how to do Microsoft Account Passwordless Logon with FIDO2 security keys. Or Take a look at Chapter 2.2 of FEITIAN FIDO2 scenarios to configure OpenSK with Microsoft Account step by step. Others \u00b6 Surely there are a lot of other online services except for Google's and Microsoft's, you can learn from - FIDO2 Scenarios and U2F Scenarios from Feitian's resources. - Knowledge Base from Feitian - fido.ftsafe.com Dedicated FIDO website from Feitian. Here you can find list of online services to use FIDO.","title":"Test FIDO"},{"location":"test/#manage-opensk","text":"There are two ways to manage your OpenSK USB Dongle, include Reset, Set PIN and Change PIN.","title":"Manage OpenSK"},{"location":"test/#windows-settings","text":"Open the Windows Settings app , select Accounts , select Sign-in options , select Security Key , and then select Manage . You can then attach OpenSK to USB port to manage it as as you want. NOTE Please refer to Microsoft Document for detailed information. Security Key option in Windows Settings is only available from Windows 10 1903.","title":"Windows Settings"},{"location":"test/#chrome-browser","text":"From Chrome browser, open URL chrome://settings/securityKeys , or open menu \"Settings\u201d => \u201cPrivacy and security\u201d (More)=> \u201cManage security keys\u201d. You can see Manage security keys page, then you can do corresponding operations following the tips. NOTE I don't know the exact version of Chrome which started to add this UI, but please update it to latest version to have this function.","title":"Chrome Browser"},{"location":"test/#demo-websites","text":"There are a lot of Demo websites list here , you can try and test. Here I recommend - https://webauthn.io/ (from DUO) - https://webauthndemo.appspot.com/ (from Google) WARNING I can not guaranty that all the demo websites can work well with OpenSK.","title":"Demo Websites"},{"location":"test/#real-use-cases","text":"There are a lot of online servides which can use FIDO2/U2F to do 2FA or passwordless authentication, please refer to FEITIAN website and click corresponding service ICON to learn. Here just emphasize services from two big FIDO players, Google and Microsoft.","title":"Real use cases"},{"location":"test/#google","text":"","title":"Google"},{"location":"test/#-google-2-step-verification","text":"Please refer to Google's help to bind OpenSK to your Google services. Or Take a look at 2.1 of Feitian's help document to bind and try OpenSK instead of ePass FIDO security key.","title":"- Google 2-Step Verification"},{"location":"test/#-googel-advanced-protection","text":"Please refer to landing page or help page of Google Advanced Protection to get how to setup.","title":"- Googel Advanced Protection"},{"location":"test/#microsoft","text":"","title":"Microsoft"},{"location":"test/#microsoft-account-passwordless-logon","text":"Please refer to Microsoft Blog to learn how to do Microsoft Account Passwordless Logon with FIDO2 security keys. Or Take a look at Chapter 2.2 of FEITIAN FIDO2 scenarios to configure OpenSK with Microsoft Account step by step.","title":"Microsoft Account Passwordless Logon"},{"location":"test/#others","text":"Surely there are a lot of other online services except for Google's and Microsoft's, you can learn from - FIDO2 Scenarios and U2F Scenarios from Feitian's resources. - Knowledge Base from Feitian - fido.ftsafe.com Dedicated FIDO website from Feitian. Here you can find list of online services to use FIDO.","title":"Others"}]} \ No newline at end of file +{"config":{"lang":["en"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"\u00b6 Welcome to Feitian OpenSK USB Dongle \u00b6 OpenSK was announced by Google at January 30, 2020. It is a fully open-source FIDO security key implementation, include hardware and software. In that announcement , Google said By opening up OpenSK as a research platform, our hope is that it will be used by researchers, security key manufacturers, and enthusiasts to help develop innovative features and accelerate security key adoption. The firmware of OpenSK is developed in Rust and it implements both FIDO U2F and FIDO2 specifications . These specifications are released by FIDO Alliance , which is an open industry association with a focused mission: authentication standards to help reduce the world\u2019s over-reliance on passwords. FEITIAN is the Board Member. To help and accelerate FIDO security key adoption, FEITIAN improves the housing and makes new design of OpenSK USB Dongle, remove unused PCB components, public the design. Users can build firmware from source code of Google OpenSK github repository without changing anything, provision it to this OpenSK hardware, to experence and try FIDO authentications. Before you try to program firmware to OpenSK, please read original OpenSK guide at first. The following documents are most like additional remarks. OpenSK Model \u00b6 We have two model of OpenSK USB Dongle, V1 and V2. They are designed according to nRF52840 USB dongle , which is used by Google OpenSK firmware. The difference between V1 and V2 is the method to enter bootloader mode. To OpenSK V1, user should insert a paper clip or a SIM-eject tool to the RESET button hole to enter bootloader mode. This is similar as user push the RESET button on nRF52840 USB dongle. To OpenSK V2, after user connects the device to computer, he should push and hold on the user button for more 8 seconds, then OpenSK will be in bootloader mode. For detailed informations, please refer to hardware description page . Programming firmware \u00b6 Pre-requisite \u00b6 The OpenSK USB Dongle V1 or V2. Before you program the firmware to OpenSK USB Dongle, you should switch it to bootloader mode. Please refer to Harware Page to learn how to switch OpenSK to bootloader mode. Read Original OpenSK guide. Before you perform following opertaions, please read OpenSK and its installation guide to learn how to customize your security key, for example, to change the signature counter mechnisam and Attestation Certificate. Install nrfutil tool. This tool allows you to directly flash firmware to OpenSK over USB without additional hardware. Develop Environment and configuration \u00b6 Prepare develop environment. You should prepare developing environment by yourself according to this section . Clone Google OpenSK github repository . $ git clone --recursive https://github.com/google/OpenSK.git Initial setup. If you just cloned this repository, you need to run the following script: $ ./setup.sh For more information, please refer to Initial setup . Configure the OpenSK security parameter. Please follow the description to change Attestation Certificate as you want. If you are not familar with OpenSK and FIDO, we recommend you do not change anything. Flashing the firmware \u00b6 Although you can download the firmware to our OpenSK V1 and V2 by using J-LINK as described in OpenSK installation guide , we recommend you program the firmware through USB interface, it is more convenient. Switch OpenSK to bootloader mode. Please refer to OpenSK Model or hardware page to learn how to switch OpenSK to bootloader mode. The LEDs show different behaviour in differet mode. Please refer to hardware page to see LED status of OpenSK V1 and V2 . Program the OpenSK USB dongle. $ ./deploy.py --board=nrf52840_dongle_dfu --opensk --programmer=nordicdfu When prompt Press [ENTER] when ready. Just press Enter, the firmware will be flahsed to your OpenSK USB Dongle. When progress bar reaches 100%, OpenSK USB Dongle will be in working mode automatically. You can now test FIDO function. Test FIDO functions \u00b6 Please refer to Test Page .","title":"Home"},{"location":"#_1","text":"","title":""},{"location":"#welcome-to-feitian-opensk-usb-dongle","text":"OpenSK was announced by Google at January 30, 2020. It is a fully open-source FIDO security key implementation, include hardware and software. In that announcement , Google said By opening up OpenSK as a research platform, our hope is that it will be used by researchers, security key manufacturers, and enthusiasts to help develop innovative features and accelerate security key adoption. The firmware of OpenSK is developed in Rust and it implements both FIDO U2F and FIDO2 specifications . These specifications are released by FIDO Alliance , which is an open industry association with a focused mission: authentication standards to help reduce the world\u2019s over-reliance on passwords. FEITIAN is the Board Member. To help and accelerate FIDO security key adoption, FEITIAN improves the housing and makes new design of OpenSK USB Dongle, remove unused PCB components, public the design. Users can build firmware from source code of Google OpenSK github repository without changing anything, provision it to this OpenSK hardware, to experence and try FIDO authentications. Before you try to program firmware to OpenSK, please read original OpenSK guide at first. The following documents are most like additional remarks.","title":"Welcome to Feitian OpenSK USB Dongle"},{"location":"#opensk-model","text":"We have two model of OpenSK USB Dongle, V1 and V2. They are designed according to nRF52840 USB dongle , which is used by Google OpenSK firmware. The difference between V1 and V2 is the method to enter bootloader mode. To OpenSK V1, user should insert a paper clip or a SIM-eject tool to the RESET button hole to enter bootloader mode. This is similar as user push the RESET button on nRF52840 USB dongle. To OpenSK V2, after user connects the device to computer, he should push and hold on the user button for more 8 seconds, then OpenSK will be in bootloader mode. For detailed informations, please refer to hardware description page .","title":"OpenSK Model"},{"location":"#programming-firmware","text":"","title":"Programming firmware"},{"location":"#pre-requisite","text":"The OpenSK USB Dongle V1 or V2. Before you program the firmware to OpenSK USB Dongle, you should switch it to bootloader mode. Please refer to Harware Page to learn how to switch OpenSK to bootloader mode. Read Original OpenSK guide. Before you perform following opertaions, please read OpenSK and its installation guide to learn how to customize your security key, for example, to change the signature counter mechnisam and Attestation Certificate. Install nrfutil tool. This tool allows you to directly flash firmware to OpenSK over USB without additional hardware.","title":"Pre-requisite"},{"location":"#develop-environment-and-configuration","text":"Prepare develop environment. You should prepare developing environment by yourself according to this section . Clone Google OpenSK github repository . $ git clone --recursive https://github.com/google/OpenSK.git Initial setup. If you just cloned this repository, you need to run the following script: $ ./setup.sh For more information, please refer to Initial setup . Configure the OpenSK security parameter. Please follow the description to change Attestation Certificate as you want. If you are not familar with OpenSK and FIDO, we recommend you do not change anything.","title":"Develop Environment and configuration"},{"location":"#flashing-the-firmware","text":"Although you can download the firmware to our OpenSK V1 and V2 by using J-LINK as described in OpenSK installation guide , we recommend you program the firmware through USB interface, it is more convenient. Switch OpenSK to bootloader mode. Please refer to OpenSK Model or hardware page to learn how to switch OpenSK to bootloader mode. The LEDs show different behaviour in differet mode. Please refer to hardware page to see LED status of OpenSK V1 and V2 . Program the OpenSK USB dongle. $ ./deploy.py --board=nrf52840_dongle_dfu --opensk --programmer=nordicdfu When prompt Press [ENTER] when ready. Just press Enter, the firmware will be flahsed to your OpenSK USB Dongle. When progress bar reaches 100%, OpenSK USB Dongle will be in working mode automatically. You can now test FIDO function.","title":"Flashing the firmware"},{"location":"#test-fido-functions","text":"Please refer to Test Page .","title":"Test FIDO functions"},{"location":"about/","text":"Feitian Technologies US, Inc. \u00b6 Website: https://xpasskey.com Online Store: https://shop.ftsafe.us [US & CANADA] Amazon Store: https://www.amazon.com/s?me=A30V4CZBKPUCSD&marketplaceID=ATVPDKIKX0DER Feitian Technologies Co., Ltd. \u00b6 Website: https://www.ftsafe.com Online Store: https://www.ftsafe.com/Store [Other regions] Alibaba Store: https://ftsafe.en.alibaba.com/ [Other regions]","title":"About"},{"location":"about/#feitian-technologies-us-inc","text":"Website: https://xpasskey.com Online Store: https://shop.ftsafe.us [US & CANADA] Amazon Store: https://www.amazon.com/s?me=A30V4CZBKPUCSD&marketplaceID=ATVPDKIKX0DER","title":"Feitian Technologies US, Inc."},{"location":"about/#feitian-technologies-co-ltd","text":"Website: https://www.ftsafe.com Online Store: https://www.ftsafe.com/Store [Other regions] Alibaba Store: https://ftsafe.en.alibaba.com/ [Other regions]","title":"Feitian Technologies Co., Ltd."},{"location":"hardware/","text":"Overview \u00b6 We have two types of OpenSK, V1 and V2. They have almost same schematic but different casing. Currently only V2 is available to the market. OpenSK V2 \u00b6 It has a metal housing with only one button in the aft area. NOTE The LED and User button are together. The button material is transparent, so user can see LED light through the button. 1. Switch To bootloader mode \u00b6 After user connects the device to computer, push and hold on the user button for more than 8 seconds and then release the button. If the red LED is breathing, OpenSK is in bootloader mode. 2. LED status \u00b6 LED behaviour Mode type Triger Method Red LED is breathing bootloader mode Connect OpenSK to USB port, press the user button for more than 8 seconds and then release the button Red LED is flashing bootloader mode Flash the firmware No LED on Working mode Idle R/G/B LED is flashing Working mode Wait for user presence when receiving FIDO command 3. Hardware \u00b6 The hardawre schematic and PCB are shared here . OpenSK V1 \u00b6 It has a 3D-printed case with one user button and one RESET button. 1. Switch To bootloader mode \u00b6 After connect OpenSK to USB port, please insert a paper clip or a SIM-eject tool to the RESET button hole to switch it to bootloader mode. This is similar as user pushes the RESET button on original nRF52840 USB dongle. NOTE RESET button hole is covered by OpenSK label. So if you want to program the firmware occasionally, you can choose not to cover the label although we send the label to you together with OpenSK hardware. 2. LED status \u00b6 LED behaviour Mode type Triger Method Blue LED is breathing bootloader mode Use a paper clip or a SIM-eject tool to push RESET button in RESET button hole Blue LED is flashing bootloader mode Flashing the firmware No LED on Working mode Idle R/G/B LED is flashing Working mode Wait for user presence when receiving FIDO command 3. Hardware \u00b6 The hardawre schematic and PCB files can be downloaded here .","title":"Hardware"},{"location":"hardware/#overview","text":"We have two types of OpenSK, V1 and V2. They have almost same schematic but different casing. Currently only V2 is available to the market.","title":"Overview"},{"location":"hardware/#opensk-v2","text":"It has a metal housing with only one button in the aft area. NOTE The LED and User button are together. The button material is transparent, so user can see LED light through the button.","title":"OpenSK V2"},{"location":"hardware/#1-switch-to-bootloader-mode","text":"After user connects the device to computer, push and hold on the user button for more than 8 seconds and then release the button. If the red LED is breathing, OpenSK is in bootloader mode.","title":"1. Switch To bootloader mode"},{"location":"hardware/#2-led-status","text":"LED behaviour Mode type Triger Method Red LED is breathing bootloader mode Connect OpenSK to USB port, press the user button for more than 8 seconds and then release the button Red LED is flashing bootloader mode Flash the firmware No LED on Working mode Idle R/G/B LED is flashing Working mode Wait for user presence when receiving FIDO command","title":"2. LED status"},{"location":"hardware/#3-hardware","text":"The hardawre schematic and PCB are shared here .","title":"3. Hardware"},{"location":"hardware/#opensk-v1","text":"It has a 3D-printed case with one user button and one RESET button.","title":"OpenSK V1"},{"location":"hardware/#1-switch-to-bootloader-mode_1","text":"After connect OpenSK to USB port, please insert a paper clip or a SIM-eject tool to the RESET button hole to switch it to bootloader mode. This is similar as user pushes the RESET button on original nRF52840 USB dongle. NOTE RESET button hole is covered by OpenSK label. So if you want to program the firmware occasionally, you can choose not to cover the label although we send the label to you together with OpenSK hardware.","title":"1. Switch To bootloader mode"},{"location":"hardware/#2-led-status_1","text":"LED behaviour Mode type Triger Method Blue LED is breathing bootloader mode Use a paper clip or a SIM-eject tool to push RESET button in RESET button hole Blue LED is flashing bootloader mode Flashing the firmware No LED on Working mode Idle R/G/B LED is flashing Working mode Wait for user presence when receiving FIDO command","title":"2. LED status"},{"location":"hardware/#3-hardware_1","text":"The hardawre schematic and PCB files can be downloaded here .","title":"3. Hardware"},{"location":"test/","text":"Congratulations that you have got your own OpenSK USB dongle, now you can try FIDO functions to do fast online authentication. OpenSK implements FIDO2(CTAP2) and FIDO U2F specifications, it can support any website leveraging W3C WebAuthN . Manage OpenSK \u00b6 There are two ways to manage your OpenSK USB Dongle, include Reset, Set PIN and Change PIN. Windows Settings \u00b6 Open the Windows Settings app , select Accounts , select Sign-in options , select Security Key , and then select Manage . You can then attach OpenSK to USB port to manage it as as you want. NOTE Please refer to Microsoft Document for detailed information. Security Key option in Windows Settings is only available from Windows 10 1903. Chrome Browser \u00b6 From Chrome browser, open URL chrome://settings/securityKeys , or open menu \"Settings\u201d => \u201cPrivacy and security\u201d (More)=> \u201cManage security keys\u201d. You can see Manage security keys page, then you can do corresponding operations following the tips. NOTE I don't know the exact version of Chrome which started to add this UI, but please update it to latest version to have this function. Demo Websites \u00b6 There are a lot of Demo websites list here , you can try and test. Here I recommend - https://webauthn.io/ (from DUO) - https://webauthndemo.appspot.com/ (from Google) WARNING I can not guaranty that all the demo websites can work well with OpenSK. Real use cases \u00b6 There are a lot of online servides which can use FIDO2/U2F to do 2FA or passwordless authentication, please refer to FEITIAN website and click corresponding service ICON to learn. Here just emphasize services from two big FIDO players, Google and Microsoft. Google \u00b6 - Google 2-Step Verification \u00b6 Please refer to Google's help to bind OpenSK to your Google services. Or Take a look at 2.1 of Feitian's help document to bind and try OpenSK instead of ePass FIDO security key. - Googel Advanced Protection \u00b6 Please refer to landing page or help page of Google Advanced Protection to get how to setup. Microsoft \u00b6 Microsoft Account Passwordless Logon \u00b6 Please refer to Microsoft Blog to learn how to do Microsoft Account Passwordless Logon with FIDO2 security keys. Or Take a look at Chapter 2.2 of FEITIAN FIDO2 scenarios to configure OpenSK with Microsoft Account step by step. Others \u00b6 Surely there are a lot of other online services except for Google's and Microsoft's, you can learn from - FIDO2 Scenarios and U2F Scenarios from Feitian's resources. - Knowledge Base from Feitian - fido.ftsafe.com Dedicated FIDO website from Feitian. Here you can find list of online services to use FIDO.","title":"Test FIDO"},{"location":"test/#manage-opensk","text":"There are two ways to manage your OpenSK USB Dongle, include Reset, Set PIN and Change PIN.","title":"Manage OpenSK"},{"location":"test/#windows-settings","text":"Open the Windows Settings app , select Accounts , select Sign-in options , select Security Key , and then select Manage . You can then attach OpenSK to USB port to manage it as as you want. NOTE Please refer to Microsoft Document for detailed information. Security Key option in Windows Settings is only available from Windows 10 1903.","title":"Windows Settings"},{"location":"test/#chrome-browser","text":"From Chrome browser, open URL chrome://settings/securityKeys , or open menu \"Settings\u201d => \u201cPrivacy and security\u201d (More)=> \u201cManage security keys\u201d. You can see Manage security keys page, then you can do corresponding operations following the tips. NOTE I don't know the exact version of Chrome which started to add this UI, but please update it to latest version to have this function.","title":"Chrome Browser"},{"location":"test/#demo-websites","text":"There are a lot of Demo websites list here , you can try and test. Here I recommend - https://webauthn.io/ (from DUO) - https://webauthndemo.appspot.com/ (from Google) WARNING I can not guaranty that all the demo websites can work well with OpenSK.","title":"Demo Websites"},{"location":"test/#real-use-cases","text":"There are a lot of online servides which can use FIDO2/U2F to do 2FA or passwordless authentication, please refer to FEITIAN website and click corresponding service ICON to learn. Here just emphasize services from two big FIDO players, Google and Microsoft.","title":"Real use cases"},{"location":"test/#google","text":"","title":"Google"},{"location":"test/#-google-2-step-verification","text":"Please refer to Google's help to bind OpenSK to your Google services. Or Take a look at 2.1 of Feitian's help document to bind and try OpenSK instead of ePass FIDO security key.","title":"- Google 2-Step Verification"},{"location":"test/#-googel-advanced-protection","text":"Please refer to landing page or help page of Google Advanced Protection to get how to setup.","title":"- Googel Advanced Protection"},{"location":"test/#microsoft","text":"","title":"Microsoft"},{"location":"test/#microsoft-account-passwordless-logon","text":"Please refer to Microsoft Blog to learn how to do Microsoft Account Passwordless Logon with FIDO2 security keys. Or Take a look at Chapter 2.2 of FEITIAN FIDO2 scenarios to configure OpenSK with Microsoft Account step by step.","title":"Microsoft Account Passwordless Logon"},{"location":"test/#others","text":"Surely there are a lot of other online services except for Google's and Microsoft's, you can learn from - FIDO2 Scenarios and U2F Scenarios from Feitian's resources. - Knowledge Base from Feitian - fido.ftsafe.com Dedicated FIDO website from Feitian. Here you can find list of online services to use FIDO.","title":"Others"}]} \ No newline at end of file diff --git a/sitemap.xml b/sitemap.xml index da6872e..058f516 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -1,19 +1,19 @@ None - 2020-06-11 + 2020-08-13 daily None - 2020-06-11 + 2020-08-13 daily None - 2020-06-11 + 2020-08-13 daily None - 2020-06-11 + 2020-08-13 daily \ No newline at end of file diff --git a/sitemap.xml.gz b/sitemap.xml.gz index 2601fd1b6aec916dd73d9c570710fc101d0e1f6a..4fc68fba0b695c45072b20ad8ce2b0c8b511c05d 100644 GIT binary patch literal 196 zcmb2|=HU3Y!X%#Qe{p6>YHnhIUPW#W!`q1)`3@-vw0*Z@P1L`zE5!NbvlmPF9W=J7 zh-kHk-H*%2di3s&C*lGZ#N4S;^}Cnp_xVes(4!~S zftzPdU8A`=)+#?|@`}J+j`7X=I^(2%Kl;+WM#``FjQ#8HYm#zb-hRYe#`efemWhD@ E096lNeEYHnhIUPW#W!`q1)`3@-vw0*Z@P1JX{mN1=?*XQ?(Vad^H zEly7_yt>W3Ozqvedqw5<|JMI|=<<7p&d%2j$9A`c^#m`9eO~>zt!@dTP-b}{`#e!{%jjB@}i#T6fSAOy1K5>~{t7r22 z)U(-fpL`=jU+&oyda3sm?=PV*q2Es3Sl*!j=^Dog!~bjUZ|*AhzCTT0c-D<#StbSs E0ENe3uK)l5
Red LED is breathing bootloader modeUse a paper clip or a SIM-eject tool to push RESET button in RESET button holeConnect OpenSK to USB port, press the user button for more than 8 seconds and then release the button
Red LED is flashing bootloader modeFlashing the firmwareFlash the firmware
No LED on