xref: /aosp_15_r20/external/tink/cc/jwt/jwk_set_converter.h (revision e7b1675dde1b92d52ec075b0a92829627f2c52a5)
1 // Copyright 2021 Google LLC
2 //
3 // Licensed under the Apache License, Version 2.0 (the "License");
4 // you may not use this file except in compliance with the License.
5 // You may obtain a copy of the License at
6 //
7 //     http://www.apache.org/licenses/LICENSE-2.0
8 //
9 // Unless required by applicable law or agreed to in writing, software
10 // distributed under the License is distributed on an "AS IS" BASIS,
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 // See the License for the specific language governing permissions and
13 // limitations under the License.
14 //
15 ///////////////////////////////////////////////////////////////////////////////
16 
17 #ifndef TINK_JWT_JWK_SET_CONVERTER_H_
18 #define TINK_JWT_JWK_SET_CONVERTER_H_
19 
20 #include <memory>
21 #include <string>
22 
23 #include "absl/strings/string_view.h"
24 #include "tink/keyset_handle.h"
25 #include "tink/util/statusor.h"
26 
27 namespace crypto {
28 namespace tink {
29 
30 // Converts a Json Web Key (JWK) set into a Tink KeysetHandle.
31 //
32 // It requires that all keys in the set have the "alg" field set. Currently,
33 // only public keys for algorithms RS256, RS384, RS512, ES256, ES384 and ES512
34 // are supported.
35 //
36 // JWK is defined in https://www.rfc-editor.org/rfc/rfc7517.txt.
37 util::StatusOr<std::unique_ptr<KeysetHandle>> JwkSetToPublicKeysetHandle(
38     absl::string_view jwk_set);
39 
40 // Converts a Tink KeysetHandle with JWT keys into a Json Web Key (JWK) set.
41 //
42 // Currently only public keys for algorithms ES256, ES384 and ES512 are
43 // supported.
44 //
45 // JWK is defined in https://www.rfc-editor.org/rfc/rfc7517.txt.
46 util::StatusOr<std::string> JwkSetFromPublicKeysetHandle(
47     const KeysetHandle& keyset_handle);
48 
49 }  // namespace tink
50 }  // namespace crypto
51 
52 #endif  // TINK_JWT_JWK_SET_CONVERTER_H_
53