Crescendo SDK
Loading...
Searching...
No Matches
CrescendoDLL.Token Class Referencesealed

Unified description of a single token/authenticator the SDK can drive. Combines Crescendo PC/SC tokens (full applet stack — ACA / OATH / PIV / CardManager / FIDO) with generic FIDO authenticators reachable over USB-HID or PC/SC NFC. More...

Public Member Functions

string  GetAtrDisplay ()
  Returns a human-readable ATR or an empty string when the token has no ATR.
 
string  GetCapabilitiesDisplay ()
  Returns a human-readable capability summary.
 
override string  ToString ()
  Returns a short human-readable summary of the form [index] tokenName (caps), Reader: readerName, where caps is one of Crescendo+FIDO, Crescendo, FIDO, or (none).
 

Properties

string?  FIDOMDSMetadata [get]
  FIDO Metadata Service entry name when known (currently populated only for recognized Crescendo ATRs).
 
string  Id [get]
  Stable identifier. For Crescendo+FIDO and generic FIDO tokens the value comes from CrescendoDLL.Fido.FidoDevice.Id (Container ID on Windows, else VID:PID:Serial, else VID:PID:HidPath or PCSC:<reader>). Crescendo-only PC/SC tokens (e.g. an NFC card whose FIDO probe failed) use the reader's Container ID when available, else PCSC:<reader>.
 
int  Index [get]
  Sequential index in the current CrescendoDLL.TokenDiscovery.ListAll snapshot. Suitable for the -t <n> CLI flag. Snapshot-local only — the same physical token may have a different CrescendoDLL.Token.Index in the next snapshot. Use CrescendoDLL.Token.Id for stable identity.
 
bool  IsCrescendo [get]
  True when the Crescendo applet stack (ACA, PIV, OATH, CardManager) is available on this token. Implies a Crescendo-recognized ATR over PC/SC.
 
string?  ReaderName [get]
  Name of the PC/SC reader hosting this token, or null for authenticators reachable only over USB-HID. For Crescendo tokens this distinguishes a USB CCID interface from an NFC contactless reader; for generic FIDO authenticators a non-null value identifies the NFC reader the card is sitting on.
 
bool  SupportsFido [get]
  True when the SDK can drive FIDO2 / U2F operations on this token.
 
byte?[]  TokenATR [get]
  ATR of the inserted card (PC/SC tokens only); null for HID-only authenticators.
 
string  TokenName [get]
  Human-readable name. Crescendo display name for Crescendo tokens; the HID product string for generic FIDO tokens reachable over USB-HID; empty for generic FIDO tokens reachable only via a PC/SC reader (e.g. an unknown NFC FIDO card) — in that case use CrescendoDLL.Token.ReaderName and CrescendoDLL.Token.TokenATR for identification.
 

Detailed Description

Unified description of a single token/authenticator the SDK can drive. Combines Crescendo PC/SC tokens (full applet stack — ACA / OATH / PIV / CardManager / FIDO) with generic FIDO authenticators reachable over USB-HID or PC/SC NFC.

Returned by CrescendoDLL.TokenDiscovery.ListAll. Pass an instance to the CrescendoDLL.SDKCore constructor that takes a CrescendoDLL.Token to open a session.

On Windows, multiple physical interfaces of the same authenticator (e.g. a USB security key's HID + CCID interfaces) are joined into a single CrescendoDLL.Token via SetupAPI Container ID.

Member Function Documentation

◆ GetAtrDisplay()

◆ GetCapabilitiesDisplay()

◆ ToString()

Property Documentation

◆ FIDOMDSMetadata

◆ Id

◆ Index

◆ IsCrescendo

◆ ReaderName

◆ SupportsFido

◆ TokenATR

◆ TokenName