Skip to content

Conversation

@DennisDyallo
Copy link
Collaborator

@DennisDyallo DennisDyallo commented Sep 16, 2025

1.14.0

Release date: September 17th, 2025

Features:

  • Support has been added for the following CTAP 2.2 and YubiKey firmware version 5.8 features (#299):

    • Persistent PinUvAuthToken (PPUAT): The GetPersistentPinUvAuthToken() method has been added to retrieve PPUATs for use with read-only FIDO2 credential management operations, including EnumerateRelyingParties(), EnumerateCredentialsForRelyingParty(), and GetCredentialMetadata(). PPUATs enable applications to list discoverable credentials from YubiKeys without requiring repeated PIN entry.

    • thirdPartyPayment extension: The GetThirdPartyPaymentExtension method has been added to check for and return the status of the thirdPartyPayment extension. The thirdPartyPayment extension enables YubiKeys to be used for cross-domain credentials without redirects, as required by Secure Payment Confirmation (SPC) workflows.

    • hmac-secret-mc extension: GetHmacSecretExtension now handles both hmac-secret and hmac-secret-mc extensions when extracting and decrypting secrets. The hmac-secret-mc extension enables PRF (Pseudo-Random Function) during MakeCredential().

    • Additional AuthenticatorInfo properties: The SDK now supports parsing of several new AuthenticatorInfo properties, which are returned when calling the GetInfoCommand(). Properties include AttestationFormats, UvCountSinceLastPinEntry, LongTouchForReset, EncIdentifier, TransportsForReset, PinComplexityPolicy, PinComplexityPolicyUrl, and MaxPinLength.

  • The SDK has been updated to target .NET Framework 4.7.2, which provides broad reliability, security, and performance improvements. (#274)

  • The NuGet package metadata has been updated for the Yubico.Core.csproj and Yubico.YubiKey.csproj files to improve discoverability, consistency, and clarity. The updates include new PackageId and PackageTags fields as well as a reorganized PackageReleaseNotes field. (#265)

  • ToString overrides have been introduced in the CommandApdu and ResponseApdu classes to provide a human-readable string representation of their internal state. These changes improve debugging and logging of APDUs. (#270)

  • A new internal HkdfUtilities class has been added to the SDK. This class implements HKDF key derivation using HMAC-SHA256, as specified in RFC 5869, providing a reusable and standards-compliant key derivation utility. (#299)

Bug Fixes:

  • Previously, DeleteSlot() and DeleteSlotConfiguration() would throw an exception when the slot configuration was successfully removed as intended. This has been fixed so that no exception occurs following a successful DeleteSlot() or DeleteSlotConfiguration() operation. (#276)

  • Prerelease versions of Yubico packages are now prevented from being referenced into published NuGet packages. This fixes an issue where a prerelease version of Yubico.NativeShims was incorrectly referenced by Yubico.Core. (#282)

  • The OtpSession logger initialization has been updated to use the correct logger. (#275)

  • The detection logic for NativeShimsPath has been improved, ensuring that 32-bit processes on 64-bit systems are correctly mapped to the "x86" directory. (#284)

Documentation:

  • The FIDO2 reset documentation has been updated to fix an error in the instructions and clarify timeout durations. (#278)

  • The documentation on slot access codes has been updated to improve clarity and examples. (#268)

  • The documentation on PIV public and private keys has been updated with new sample code demonstrating how to use the latest factory methods. (#245, #272)

  • The documentation for the UseFastTrigger method has been updated to clarify information on behavior and applicability. (#294)

  • All hardcoded links to the Yubico.NET.SDK GitHub repository have been updated to point to the HEAD branch. This ensures that links to sample code point to the latest version of that code. (#286, #279)

  • An SDK overview designed to help the Copilot coding agent work more efficiently has been added to the Yubico.NET.SDK GitHub repository. (#296)

Dependencies:

  • Several dependencies across the Yubico.YubiKey and Yubico.Core projects have been updated to the latest versions. (#274)

DennisDyallo and others added 30 commits June 11, 2025 15:14
The streamlined docs now cut ~70% of the original content while providing more practical value. They focus on the new SDK patterns rather than manual DER parsing, making them much more maintainable and developer-friendly.
Copyright, tags, packageId
deps: Update dependencies

- Upgraded Microsoft.Extensions.Configuration.Json to version 8.0.1.
- Upgraded Microsoft.Extensions.Logging.Abstractions to version 8.0.3.
- Upgraded Microsoft.Extensions.Logging.Console to version 8.0.1.
docs: additional release note details for 1.13.2
feat: Add ToString override to CommandApdu and ResponseApdu
docs: Improvements to slot access codes how-to
fix: Correct logger for OtpSession
@DennisDyallo DennisDyallo changed the base branch from develop to main September 16, 2025 09:29
Fido2Session now inherits ApplicationSession in
the same way as other session classes.

PPUAT wont be set unless the key supports it

Add possibility to self compute the authParam on EnumerateCredentialsBeginCommand, EnumerateRpsBeginCommand and GetCredentialMetadata command.
refactor: FIDO2 Credential Management Authentication, ApplicationSession
@github-actions
Copy link

Test Results: Windows

    2 files      2 suites   11s ⏱️
3 972 tests 3 972 ✅ 0 💤 0 ❌
3 974 runs  3 974 ✅ 0 💤 0 ❌

Results for commit 1527069.

@github-actions
Copy link

Test Results: Ubuntu

    2 files      2 suites   15s ⏱️
3 964 tests 3 964 ✅ 0 💤 0 ❌
3 966 runs  3 966 ✅ 0 💤 0 ❌

Results for commit 1527069.

@github-actions
Copy link

Code Coverage

Package Line Rate Branch Rate Complexity Health
Yubico.Core 40% 31% 4371
Yubico.YubiKey 51% 47% 21102
Summary 49% (36171 / 73593) 44% (8886 / 20109) 25473

Minimum allowed line rate is 40%

@github-actions
Copy link

Test Results: MacOS

    2 files      2 suites   12s ⏱️
3 964 tests 3 964 ✅ 0 💤 0 ❌
3 966 runs  3 966 ✅ 0 💤 0 ❌

Results for commit 1527069.

@DennisDyallo DennisDyallo merged commit f123666 into main Sep 16, 2025
11 checks passed
@DennisDyallo DennisDyallo deleted the release/1.14.0 branch September 16, 2025 14:28
@DennisDyallo DennisDyallo restored the release/1.14.0 branch September 16, 2025 14:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

4 participants