s2n_hkdf.h 1.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142
  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 <stdint.h>
  17. #include "crypto/s2n_hmac.h"
  18. #include "utils/s2n_blob.h"
  19. /*
  20. * Label structure is `opaque label<7..255> = "tls13 " + Label` per RFC8446.
  21. * So, we have 255-sizeof("tls13 ") = 249, the maximum label length.
  22. *
  23. * Note that all labels defined by RFC 8446 are <12 characters, which
  24. * avoids an extra hash iteration. However, the exporter functionality
  25. * (s2n_connection_tls_exporter) allows for longer labels.
  26. */
  27. #define S2N_MAX_HKDF_EXPAND_LABEL_LENGTH 249
  28. int s2n_hkdf(struct s2n_hmac_state *hmac, s2n_hmac_algorithm alg, const struct s2n_blob *salt,
  29. const struct s2n_blob *key, const struct s2n_blob *info, struct s2n_blob *output);
  30. int s2n_hkdf_extract(struct s2n_hmac_state *hmac, s2n_hmac_algorithm alg, const struct s2n_blob *salt,
  31. const struct s2n_blob *key, struct s2n_blob *pseudo_rand_key);
  32. int s2n_hkdf_expand_label(struct s2n_hmac_state *hmac, s2n_hmac_algorithm alg, const struct s2n_blob *secret, const struct s2n_blob *label,
  33. const struct s2n_blob *context, struct s2n_blob *output);
  34. bool s2n_libcrypto_supports_hkdf();