React Native YubiKey
References & Resources
Links to the library, underlying SDKs, and relevant standards
This library
- Package:
@doko/react-native-yubikiton npm - Repository:
https://github.com/Doko-Demo-Doa/react-native-yubikit - The repository's own
README.mdandDRAFT_PLAN.mdare the most accurate source of truth for platform-support details - if anything on this site ever disagrees with the repo, trust the repo.
Underlying native SDKs
This library wraps these SDKs directly - it doesn't reimplement any cryptography or protocol logic itself:
- YubiKit iOS - pinned to SDK 4.7.0 via a Podfile override (see Installation); source at github.com/Yubico/yubikit-ios
- YubiKit Android - SDK 3.1.0; source at github.com/Yubico/yubikit-android
Standards implemented
- FIDO2 / CTAP2 Specification - via
Fido.makeCredential/Fido.getAssertion - WebAuthn Level 2 - the shape of
Fido's options/credential types - RFC 4226 - HOTP and RFC 6238 - TOTP - via the
Oathmodule - NIST SP 800-73-4 (PIV) - via the
Pivmodule - OpenPGP card specification - via the
OpenPgpmodule (Android only)
Not implemented by this library: classic FIDO U2F/CTAP1, QR-code scanning, NFC static-OTP tag reading. See the index page for the full feature-coverage table.
Apple developer docs (for the manual iOS setup steps)
- Core NFC framework - for the
NFCReaderUsageDescription/ capability setup in Installation - Apple MFi Program - background on the Lightning accessory certification the YubiKey 5Ci uses
Android developer docs
- Android USB Host API - background on how USB permission is actually granted at runtime (not via a manifest permission)
- Android NFC overview
Security guidance
Yubico general resources
Glossary
- FIDO2 / CTAP2 - the passwordless authentication standard this library implements via
Fido - WebAuthn - the browser-facing API whose credential/option shapes
Fido's types mirror - TurboModule - React Native's New Architecture native-module mechanism this library is built on exclusively
- OATH - TOTP/HOTP credential standard, implemented via the
Oathmodule - PIV - certificate-based smart-card standard (NIST SP 800-73-4), implemented via the
Pivmodule - MFi - Apple's "Made for iPhone" accessory certification; the YubiKey 5Ci uses it for its Lightning connector
- APDU - Application Protocol Data Unit, the low-level command format
Core.sendApdusends directly to the smart-card applet