xref: /aosp_15_r20/external/tink/cc/jwt/internal/jwt_public_key_sign_internal.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_INTERNAL_JWT_PUBLIC_KEY_SIGN_INTERNAL_H_
18 #define TINK_JWT_INTERNAL_JWT_PUBLIC_KEY_SIGN_INTERNAL_H_
19 
20 #include <string>
21 
22 #include "absl/strings/string_view.h"
23 #include "tink/jwt/raw_jwt.h"
24 #include "tink/util/status.h"
25 #include "tink/util/statusor.h"
26 
27 namespace crypto {
28 namespace tink {
29 
30 ///////////////////////////////////////////////////////////////////////////////
31 // Internal interface for signing JWT.
32 //
33 // Sees RFC 7519 and RFC 7515. Security guarantees: similar to PublicKeySign.
34 class JwtPublicKeySignInternal {
35  public:
36   // Computes a signature, and encodes the JWT and the signature in the JWS
37   // compact serialization format.
38   //
39   // When `kid` has a value, the token will have a kid header. `kid` is set by
40   // the primitive wrapper based on the output prefix type and the key id.
41   virtual crypto::tink::util::StatusOr<std::string> SignAndEncodeWithKid(
42       const RawJwt& token, absl::optional<absl::string_view> kid) const = 0;
43 
44   virtual ~JwtPublicKeySignInternal() = default;
45 };
46 
47 }  // namespace tink
48 }  // namespace crypto
49 
50 #endif  // TINK_JWT_INTERNAL_JWT_PUBLIC_KEY_SIGN_INTERNAL_H_
51