ResetPivPinWithPuk Field

Namespace: Yubico.YubiKey Assembly: Yubico.YubiKey.dll

Indicates that the SDK is requesting the PIV PUK and a new PIN. This is the first call. This is used to recover the PIN using the PUK. Collect both the current PUK and a new PIN.

C#

public const KeyEntryRequest ResetPivPinWithPuk

Returns

KeyEntryRequest

Remarks

After collecting the PUK and a new PIN, submit them using the SubmitValues method, with the PUK as the currentValue and the PIN as the newValue.

When the KeyEntryData.Request is this value and the KeyEntryData.IsRetry property is false, the KeyEntryData is making the initial request.

When the KeyEntryData.Request is this value and the KeyEntryData.IsRetry property is true, the KeyEntryData is reporting that a previous attempt at resetting the PIN failed and the KeyCollector should try again to obtain the values (unless the user decides to cancel).

Note that the most likely reason a reset will fail is because the PUK was incorrect, but it can also fail if the new PIN is not valid (e.g. too short).