サポートsupport

• アプリの有効化(例:USB接続で「PIV」を有効にする

  $ ykman config usb -e PIV
  Enable FIDO2.
  Configure USB interface? [y/N]: y

• アプリの無効化(例:NFC接続で「FIDO U2F」を無効にする

  $ ykman config nfc -d U2F
  Disable FIDO U2F.
  Configure NFC interface? [y/N]: y

• PIVの情報表示

  $ ykman piv info
  PIV version: 5.2.7
  PIN tries remaining: 3
  CHUID:
  3019d4e739da739ced39ce739d836858210842108421c84210c3eb3410f3b616764e7182cf729e1bc6b8d4d335350832303330303130313e00fe00
  CCC:
  f015a000000116ff02fad0c67af91e2feb1447c69bd402f10121f20121f300f40100f50110f600f700fa00fb00fc00fd00fe00
  Slot 82:
  Algorithm: RSA2048
  Subject DN: CN=sirou@onelogin.jp|OneLoginDeviceTrust,OU=3e74154a-2b21-4dbe-8c7e-dc688dc1097c,DC=pentio,DC=onelogin,DC=com,DC=US
  Issuer DN: CN=OneLogin Inc Intermediate CA,OU=OneLogin Inc,O=OneLogin Inc,L=San Francisco,ST=CA,C=US
  Serial: 47192512350986009
  Fingerprint: 3197ff8285c50a259c766ee1f8c9c9009b11c06815866c3a9902bd73f07fcb98
  Not before: 2021-01-08 08:05:19
  Not after: 2022-01-08 08:05:19
  Slot 9e:
  Algorithm: RSA2048
  Subject DN: CN=tarou.yamada@onelogin.jp|OneLoginDeviceTrust,OU=0770325e-390f-4f11-b3b2-900beff595a4,DC=pentio,DC=onelogin,DC=com,DC=US
  Issuer DN: CN=OneLogin Inc Intermediate CA,OU=OneLogin Inc,O=OneLogin Inc,L=San Francisco,ST=CA,C=US
  Serial: 5464455165560841104
  Fingerprint: 6a954c9d5939391af506c1e6997a6b297c1ef9b19bd59e4cb7e5256e44811e6c
  Not before: 2021-01-08 03:56:48
  Not after: 2022-01-08 03:56:48

YubiKey Managerで表示されない秘匿スロット82〜95内の証明書の情報を「ykman piv info」では表示することができます

• PINの変更(例:PINを「654321」から「123456」に変更

  $ ykman piv change-pin -P654321 -n123456
  $ ykman piv access change-pin -P654321 -n123456
  New PIN set.

• PUKの変更(例:PUKを「12345678」から「87654321」に変更

  $ ykman piv change-puk -p12345678 -n87654321
  $ ykman piv access change-puk -p12345678 -n87654321
  New PUK set.

• Management Keyの変更(例:Management Keyを「010203040506070801020304050607080102030405060708」から自動生成したものに変更

  $ ykman piv change-management-key -
  $ ykman piv access change-management-key -
  Generated management key:
  78d226826796a7d4ec897c6b612606ef6780a9b1238276b4

• PINとPUKのリトライ回数を変更
  (例:Management Keyを「010203040506070801020304050607080102030405060708」、PINを「654321」に設定していたときに、PINのリトライ回数を10回、PUKのリトライ回数を15回に設定

  $ ykman piv set-pin-retries -m010203040506070801020304050607080102030405060708 -P654321 -f 10 15
  $ ykman piv access set-retries -m010203040506070801020304050607080102030405060708 -P654321 -f 10 15
  WARNING: This will reset the PIN and PUK to the factory defaults!
  Default PINs are set.
  PIN: 123456
  PUK: 12345678

  このときPINとPUKはリセットされて工場出荷時のデフォルトの値になります

• PIVのリセット

  $ ykman piv reset -f
  Resetting PIV data...
  Success! All PIV data have been cleared from your YubiKey.
  Your YubiKey now has the default PIN, PUK and Management Key:
  PIN: 123456
  PUK: 12345678
  Management Key: 010203040506070801020304050607080102030405060708

• PINのブロック解除(例:PUKが「12345678」に設定してあるPINのブロックを解除して、新しくPINを「654321」に設定

  $ ykman piv unblock-pin -p12345678 -n654321
  $ ykman piv access unblock-pin -p12345678 -n654321

  ＜動作結果表示なし＞

• 証明書のインポート
  (例:PINを「135791」、Management Keyを「78d226826796a7d4ec897c6b612606ef6780a9b1238276b4」に設定していたときに、
  パスワードを「yubikey」と設定してある「secureW2-yubikey.p12」という名前の証明書を「スロット9a」にインポート

  $ ykman piv import-certificate -
  $ ykman piv certificates import -
  m78d226826796a7d4ec897c6b612606ef6780a9b1238276b4 -P135791 -pyubikey 9a
  "secureW2-yubikey.p12"

  ＜動作結果表示なし＞

• 証明書を削除
  (例:PINを「135791」、Management Keyを「78d226826796a7d4ec897c6b612606ef6780a9b1238276b4」に設定していたときに、スロット9aの証明書を削除

  $ ykman piv delete-certificate -P135791 -
  $ ykman piv certificates delete -P135791 -
  m78d226826796a7d4ec897c6b612606ef6780a9b1238276b4 9a

  ＜動作結果表示なし＞

• 証明書のエクスポート(例:「スロット82」にある「secureW2-yubikey.p12」という名前の証明書をPEM形式でエクスポート)

  $ ykman piv export-certificate -F PEM 82 "secureW2-yubikey.p12"
  $ ykman piv certificates export -F PEM 82 "secureW2-yubikey.p12"

  ＜動作結果表示なし＞

• 鍵ペアの生成
  (例:Management Keyを「010203040506070801020304050607080102030405060708」、PINを「123456」に設定していたときに、「スロット9d」に「pubkey.pem」という名前の鍵ペアを生成

  $ ykman piv generate-key -P123456 -
  $ ykman piv keys generate -P123456 -
  m010203040506070801020304050607080102030405060708 9d pubkey.pem

  ＜動作結果表示なし＞

• 自己証明書の生成
  (例:Management Keyを「010203040506070801020304050607080102030405060708」、PINを「123456」に設定していたときに、Subject nameが「SSH Key」で「スロット9d」に「pubkey.pem」という名前の鍵ペアをもつ自己証明書を生成

  $ ykman piv generate-certificate -P123456 -
  $ ykman piv certificates generate -P123456 -
  m010203040506070801020304050607080102030405060708 -s "SSH Key" 9d 
  pubkey.pem

  ＜動作結果表示なし＞

• 認証証明書を生成
  (例:「example」という名前のファイルに「スロット8d」に入っている証明書の内容を書き込む

  $ ykman piv attest 8d "example"
  $ ykman piv keys attest 8d "example"

  ＜動作結果表示なし＞

• 署名要求(CSR)の生成
  (例: PINが「123456」で「スロット9d」に「pubkey.pem」という秘密鍵が存在していてSubject nameを「Key」としているとき、「a.txt」というファイルにCSRを生成

  $ ykman piv generate-csr -P123456 -s "Key" 9d publickey.pem "a.txt"
  $ ykman piv certificates request -P123456 -s "Key" 9d publickey.pem "a.txt"

  ＜動作結果表示なし＞

• CHUIDの生成
  (例:Management Keyを「010203040506070801020304050607080102030405060708」、PINを「123456」に設定していたときに、CHUIDを自動生成

  $ ykman piv set-chuid -P123456 -
  $ ykman piv objects generate chuid -P123456 -
  m010203040506070801020304050607080102030405060708

  ＜動作結果表示なし＞

• CCCの生成
  例:Management Keyを「010203040506070801020304050607080102030405060708」、PINを「123456」に設定していたときに、CCCを自動生成

  $ ykman piv set-ccc -P123456 -
  $ ykman piv objects generate ccc -P123456 -
  m010203040506070801020304050607080102030405060708

  ＜動作結果表示なし＞

• PIVオブジェクトの書き込み
  (例:Management Keyを「010203040506070801020304050607080102030405060708」、PINを「123456」に設定していたときに、OBJECT-IDを「5fffff」、データを書き込むファイルを「pubkey.pem」にしてPIVオブジェクトの書き込み

  $ ykman piv write-object -P123456 -
  $ ykman piv objects import -P123456 -
  m010203040506070801020304050607080102030405060708 5fffff “pubkey.pem"

  ＜動作結果表示なし＞

• PIVオブジェクトの読み込み
  (例:Management Keyを「010203040506070801020304050607080102030405060708」、PINを「123456」に設定していたときに、OBJECT-IDが「5fffff」のPIVオブジェクトの読み込み

  $ ykman piv read-object -P123456 5fffff
  $ ykman piv objects export -P123456 5fffff
  -----BEGIN PUBLIC KEY-----
  MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEiCEu0RaldiEHEFDB6m4twD5p8EjR
  PeESxrBlxKouo0ustr2pXQrRzkEJCmt1sVXJpi4bk+Gc1f/EzLAcml+cEQ==
  -----END PUBLIC KEY-----

その他のコマンドについてはこちらをご覧ください。

鍵ペア(秘密鍵)、自己署名証明書の作成方法とSSH接続についてはこちらをご覧ください。