Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security Policy
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

piv

package

Go to main page

Versions in this module

v1

v1.8.6

Jun 18, 2024

Changes in this version

+ const FormfactorUSBAKeychainFIPS

+ const FormfactorUSBANanoFIPS

+ const FormfactorUSBCKeychainFIPS

+ const FormfactorUSBCLightningKeychainFIPS

+ const FormfactorUSBCNanoFIPS

type Formfactor

+ func (f Formfactor) String() string

+ type KeyInfo struct

+ Algorithm Algorithm

+ Origin Origin

+ PINPolicy PINPolicy

+ PublicKey crypto.PublicKey

+ TouchPolicy TouchPolicy

+ type Origin int

+ const OriginGenerated

+ const OriginImported

+ type Verifier struct

+ Roots *x509.CertPool

+ func (v *Verifier) Verify(attestationCert, slotCert *x509.Certificate) (*Attestation, error)

type YubiKey

+ func (yk *YubiKey) KeyInfo(slot Slot) (KeyInfo, error)

+ func (yk *YubiKey) VerifyPIN(pin string) error

v1.8.5

Aug 9, 2021

v1.8.4

Jul 27, 2021

v1.8.3

Jul 27, 2021

v1.8.2

Jul 27, 2021

v1.8.1

Jul 26, 2021

Changes in this version

+ const FormfactorUSBAKeychain

+ const FormfactorUSBANano

+ const FormfactorUSBCKeychain

+ const FormfactorUSBCLightningKeychain

+ const FormfactorUSBCNano

+ var DefaultManagementKey = [24]byte

+ var DefaultPIN = "123456"

+ var DefaultPUK = "12345678"

+ var ErrNotFound = errors.New("data object or application not found")

+ var SlotAuthentication = Slot

+ var SlotCardAuthentication = Slot

+ var SlotKeyManagement = Slot

+ var SlotSignature = Slot

+ func Cards() ([]string, error)

+ type Algorithm int

+ const AlgorithmEC256

+ const AlgorithmEC384

+ const AlgorithmEd25519

+ const AlgorithmRSA1024

+ const AlgorithmRSA2048

+ type Attestation struct

+ Formfactor Formfactor

+ PINPolicy PINPolicy

+ Serial uint32

+ Slot Slot

+ TouchPolicy TouchPolicy

+ Version Version

+ func Verify(attestationCert, slotCert *x509.Certificate) (*Attestation, error)

+ type AuthErr struct

+ Retries int

+ func (v AuthErr) Error() string

+ type CardID struct

+ GUID [16]byte

+ type ECDSAPrivateKey struct

+ func (k *ECDSAPrivateKey) Public() crypto.PublicKey

+ func (k *ECDSAPrivateKey) SharedKey(peer *ecdsa.PublicKey) ([]byte, error)

+ func (k *ECDSAPrivateKey) Sign(rand io.Reader, digest []byte, opts crypto.SignerOpts) ([]byte, error)

+ type Formfactor int

+ type Key struct

+ Algorithm Algorithm

+ PINPolicy PINPolicy

+ TouchPolicy TouchPolicy

+ type KeyAuth struct

+ PIN string

+ PINPolicy PINPolicy

+ PINPrompt func() (pin string, err error)

+ type Metadata struct

+ ManagementKey *[24]byte

+ type PINPolicy int

+ const PINPolicyAlways

+ const PINPolicyNever

+ const PINPolicyOnce

+ type Slot struct

+ Key uint32

+ Object uint32

+ func RetiredKeyManagementSlot(key uint32) (Slot, bool)

+ func (s Slot) String() string

+ type TouchPolicy int

+ const TouchPolicyAlways

+ const TouchPolicyCached

+ const TouchPolicyNever

+ type Version struct

+ Major int

+ Minor int

+ Patch int

+ type YubiKey struct

+ func Open(card string) (*YubiKey, error)

+ func (yk *YubiKey) Attest(slot Slot) (*x509.Certificate, error)

+ func (yk *YubiKey) AttestationCertificate() (*x509.Certificate, error)

+ func (yk *YubiKey) CardID() (*CardID, error)

+ func (yk *YubiKey) Certificate(slot Slot) (*x509.Certificate, error)

+ func (yk *YubiKey) Close() error

+ func (yk *YubiKey) GenerateKey(key [24]byte, slot Slot, opts Key) (crypto.PublicKey, error)

+ func (yk *YubiKey) Metadata(pin string) (*Metadata, error)

+ func (yk *YubiKey) PrivateKey(slot Slot, public crypto.PublicKey, auth KeyAuth) (crypto.PrivateKey, error)

+ func (yk *YubiKey) Reset() error

+ func (yk *YubiKey) Retries() (int, error)

+ func (yk *YubiKey) Serial() (uint32, error)

+ func (yk *YubiKey) SetCardID(key [24]byte, id *CardID) error

+ func (yk *YubiKey) SetCertificate(key [24]byte, slot Slot, cert *x509.Certificate) error

+ func (yk *YubiKey) SetManagementKey(oldKey, newKey [24]byte) error

+ func (yk *YubiKey) SetMetadata(key [24]byte, m *Metadata) error

+ func (yk *YubiKey) SetPIN(oldPIN, newPIN string) error

+ func (yk *YubiKey) SetPUK(oldPUK, newPUK string) error

+ func (yk *YubiKey) SetPrivateKeyInsecure(key [24]byte, slot Slot, private crypto.PrivateKey, policy Key) error

+ func (yk *YubiKey) Unblock(puk, newPIN string) error

+ func (yk *YubiKey) Version() Version