jose-jwk-thp.1 1.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495
  1. .\" generated with Ronn/v0.7.3
  2. .\" http://github.com/rtomayko/ronn/tree/0.7.3
  3. .
  4. .TH "JOSE\-JWK\-THP" "1" "June 2017" "" ""
  5. .
  6. .SH "NAME"
  7. \fBjose\-jwk\-thp\fR \- Calculates the JWK thumbprint
  8. .
  9. .SH "SYNOPSIS"
  10. \fBjose jwk thp\fR \-i JWK [\-H ALG] [\-o THP]
  11. .
  12. .SH "OVERVIEW"
  13. The \fBjose jwk thp\fR command calculates the thumbprint of one or more JWKs\.
  14. .
  15. .SH "OPTIONS"
  16. .
  17. .TP
  18. \fB\-i\fR \fIJSON\fR, \fB\-\-input\fR=\fIJSON\fR
  19. Parse JWK(Set) from JSON
  20. .
  21. .TP
  22. \fB\-i\fR \fIFILE\fR, \fB\-\-input\fR=\fIFILE\fR
  23. Read JWK(Set) from FILE
  24. .
  25. .TP
  26. \fB\-i\fR \-, \fB\-\-input\fR=\-
  27. Read JWK(Set) standard input
  28. .
  29. .TP
  30. \fB\-a\fR \fIALG\fR, \fB\-\-algorithm\fR=\fIALG\fR
  31. Use the specified hash algorithm (case sensitive)
  32. .
  33. .TP
  34. \fB\-a\fR ?, \fB\-\-algorithm\fR=?
  35. List available hash algorithms
  36. .
  37. .TP
  38. \fB\-o\fR \fIFILE\fR, \fB\-\-output\fR=\fIFILE\fR
  39. Write thumbprint(s) to FILE
  40. .
  41. .TP
  42. \fB\-o\fR \-, \fB\-\-output\fR=\-
  43. Write thumbprint(s) to standard input
  44. .
  45. .TP
  46. \fB\-f\fR \fITHP\fR, \fB\-\-find\fR=\fITHP\fR
  47. Search input keys for JWK with the given thumbprint
  48. .
  49. .SH "EXAMPLES"
  50. Calculate the S1 thumbprint of a newly generated key:
  51. .
  52. .IP "" 4
  53. .
  54. .nf
  55. $ jose jwk gen \-i \'{"alg":"ES256"}\' \-a S1 | jose jwk thp \-i\-
  56. BzmSH6W8a8LlbQ1mD0iBJdYj4x4
  57. .
  58. .fi
  59. .
  60. .IP "" 0
  61. .
  62. .P
  63. Calculate the S256 thumbprints of a JWKSet containing two keys:
  64. .
  65. .IP "" 4
  66. .
  67. .nf
  68. $ jose jwk thp \-i keys\.jwkset \-a S256
  69. 6HJwXEuRh8gAkTz4BodEvcEj_KXkgjc\-7Qez3d4VNMs
  70. jo_j_O5gqYpKcZKHPp3miTszAeV60MXHvdb_kkjjTWE
  71. .
  72. .fi
  73. .
  74. .IP "" 0
  75. .
  76. .P
  77. Find the input key with the given thumbprint:
  78. .
  79. .IP "" 4
  80. .
  81. .nf
  82. $ jose jwk thp \-i keys\.jwkset \-f HYRNOxxOOHap0amTONoy1bHnS5M \-o key\.jwk
  83. .
  84. .fi
  85. .
  86. .IP "" 0
  87. .
  88. .SH "AUTHOR"
  89. Nathaniel McCallum <npmccallum@redhat\.com>
  90. .
  91. .SH "SEE ALSO"
  92. \fBjose\-alg\fR(1), \fBjose\-jwk\-gen\fR(1),