s2n_signature_scheme.h 3.7 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788
  1. /*
  2. * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  3. *
  4. * Licensed under the Apache License, Version 2.0 (the "License").
  5. * You may not use this file except in compliance with the License.
  6. * A copy of the License is located at
  7. *
  8. * http://aws.amazon.com/apache2.0
  9. *
  10. * or in the "license" file accompanying this file. This file is distributed
  11. * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
  12. * express or implied. See the License for the specific language governing
  13. * permissions and limitations under the License.
  14. */
  15. #pragma once
  16. #include <strings.h>
  17. #include "api/s2n.h"
  18. #include "crypto/s2n_ecc_evp.h"
  19. #include "crypto/s2n_hash.h"
  20. #include "crypto/s2n_signature.h"
  21. struct s2n_signature_scheme {
  22. uint16_t iana_value;
  23. s2n_hash_algorithm hash_alg;
  24. s2n_signature_algorithm sig_alg;
  25. uint8_t minimum_protocol_version;
  26. uint8_t maximum_protocol_version;
  27. uint16_t libcrypto_nid;
  28. /* Curve is only specified for ECDSA Signatures */
  29. struct s2n_ecc_named_curve const *signature_curve;
  30. };
  31. struct s2n_signature_preferences {
  32. uint8_t count;
  33. const struct s2n_signature_scheme *const *signature_schemes;
  34. };
  35. extern const struct s2n_signature_scheme s2n_null_sig_scheme;
  36. /* RSA PKCS1 */
  37. /* s2n_rsa_pkcs1_md5_sha1 is not in any preference list, but it is needed since it's the default for TLS 1.0 and 1.1 if
  38. * no SignatureScheme is sent. */
  39. extern const struct s2n_signature_scheme s2n_rsa_pkcs1_md5_sha1;
  40. extern const struct s2n_signature_scheme s2n_rsa_pkcs1_sha1;
  41. extern const struct s2n_signature_scheme s2n_rsa_pkcs1_sha224;
  42. extern const struct s2n_signature_scheme s2n_rsa_pkcs1_sha256;
  43. extern const struct s2n_signature_scheme s2n_rsa_pkcs1_sha384;
  44. extern const struct s2n_signature_scheme s2n_rsa_pkcs1_sha512;
  45. /* TLS 1.2 Compatible ECDSA Schemes */
  46. extern const struct s2n_signature_scheme s2n_ecdsa_sha1;
  47. extern const struct s2n_signature_scheme s2n_ecdsa_sha224;
  48. extern const struct s2n_signature_scheme s2n_ecdsa_sha256;
  49. extern const struct s2n_signature_scheme s2n_ecdsa_sha384;
  50. extern const struct s2n_signature_scheme s2n_ecdsa_sha512;
  51. /* TLS 1.3 Compatible ECDSA Schemes */
  52. extern const struct s2n_signature_scheme s2n_ecdsa_secp256r1_sha256;
  53. extern const struct s2n_signature_scheme s2n_ecdsa_secp384r1_sha384;
  54. extern const struct s2n_signature_scheme s2n_ecdsa_secp521r1_sha512;
  55. /* RSA PSS */
  56. /*
  57. * Use RSA-PSS-RSAE instead of RSA-PSS-PSS in order to work with older certificates.
  58. * For more info see: https://crypto.stackexchange.com/a/58708
  59. */
  60. extern const struct s2n_signature_scheme s2n_rsa_pss_pss_sha256;
  61. extern const struct s2n_signature_scheme s2n_rsa_pss_pss_sha384;
  62. extern const struct s2n_signature_scheme s2n_rsa_pss_pss_sha512;
  63. extern const struct s2n_signature_scheme s2n_rsa_pss_rsae_sha256;
  64. extern const struct s2n_signature_scheme s2n_rsa_pss_rsae_sha384;
  65. extern const struct s2n_signature_scheme s2n_rsa_pss_rsae_sha512;
  66. extern const struct s2n_signature_preferences s2n_signature_preferences_20230317;
  67. extern const struct s2n_signature_preferences s2n_signature_preferences_20140601;
  68. extern const struct s2n_signature_preferences s2n_signature_preferences_20200207;
  69. extern const struct s2n_signature_preferences s2n_signature_preferences_20201021;
  70. extern const struct s2n_signature_preferences s2n_signature_preferences_20210816;
  71. extern const struct s2n_signature_preferences s2n_signature_preferences_rfc9151;
  72. extern const struct s2n_signature_preferences s2n_certificate_signature_preferences_rfc9151;
  73. extern const struct s2n_signature_preferences s2n_signature_preferences_default_fips;
  74. extern const struct s2n_signature_preferences s2n_signature_preferences_null;
  75. extern const struct s2n_signature_preferences s2n_certificate_signature_preferences_20201110;