openssl-glossary.pod 2.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798
  1. =pod
  2. =head1 NAME
  3. openssl-glossary - An OpenSSL Glossary
  4. =head1 DESCRIPTION
  5. =for comment Please keep the items in case-insensitive alphabetical order
  6. =over 4
  7. =item ASN.1, ASN1
  8. ASN.1 ("Abstract Syntax Notation One") is a notation for describing abstract
  9. types and values. It is defined in the ITU-T documents X.680 to X.683:
  10. L<https://www.itu.int/rec/T-REC-X.680>,
  11. L<https://www.itu.int/rec/T-REC-X.681>,
  12. L<https://www.itu.int/rec/T-REC-X.682>,
  13. L<https://www.itu.int/rec/T-REC-X.683>
  14. =item DER ("Distinguished Encoding Rules")
  15. DER is a binary encoding of data, structured according to an ASN.1
  16. specification. This is a common encoding used for cryptographic objects
  17. such as private and public keys, certificates, CRLs, ...
  18. It is defined in ITU-T document X.690:
  19. L<https://www.itu.int/rec/T-REC-X.690>
  20. =item MSBLOB
  21. MSBLOB is a Microsoft specific binary format for RSA and DSA keys, both
  22. private and public. This form is never passphrase protected.
  23. =item PEM ("Privacy Enhanced Message")
  24. PEM is a format used for encoding of binary content into a mail and ASCII
  25. friendly form. The content is a series of base64-encoded lines, surrounded
  26. by begin/end markers each on their own line. For example:
  27. -----BEGIN PRIVATE KEY-----
  28. MIICdg....
  29. ... bhTQ==
  30. -----END PRIVATE KEY-----
  31. Optional header line(s) may appear after the begin line, and their existence
  32. depends on the type of object being written or read.
  33. For all OpenSSL uses, the binary content is expected to be a DER encoded
  34. structure.
  35. This is defined in IETF RFC 1421:
  36. L<https://tools.ietf.org/html/rfc1421>
  37. =item PKCS#8 (also known as "pkcs8" in some parts of OpenSSL)
  38. PKCS#8 is a specification of an ASN.1 structure that OpenSSL uses for
  39. storing or transmitting any private key in a key type agnostic manner, and
  40. has both an unencrypted and an encrypted form.
  41. This is specified in RFC 5208:
  42. L<https://tools.ietf.org/html/rfc5208>
  43. =item PVK
  44. PVK is a Microsoft specific binary format for RSA and DSA private keys.
  45. This form may be passphrase protected.
  46. =item SubjectPublicKeyInfo
  47. SubjectPublicKeyInfo is an ASN.1 structure that OpenSSL uses for storing and
  48. transmitting any public key in a key type agnostic manner.
  49. This is specified as part of the specification for certificates, RFC 5280:
  50. L<https://tools.ietf.org/html/rfc5280>
  51. =back
  52. =head1 HISTORY
  53. This glossary was added in OpenSSL 3.0.
  54. =head1 COPYRIGHT
  55. Copyright 2020 The OpenSSL Project Authors. All Rights Reserved.
  56. Licensed under the Apache License 2.0 (the "License"). You may not use
  57. this file except in compliance with the License. You can obtain a copy
  58. in the file LICENSE in the source distribution or at
  59. L<https://www.openssl.org/source/license.html>.
  60. =cut