xref: /aosp_15_r20/external/tink/java_src/proto/aes_siv.proto (revision e7b1675dde1b92d52ec075b0a92829627f2c52a5)
1*e7b1675dSTing-Kang Chang// Copyright 2017 Google Inc.
2*e7b1675dSTing-Kang Chang//
3*e7b1675dSTing-Kang Chang// Licensed under the Apache License, Version 2.0 (the "License");
4*e7b1675dSTing-Kang Chang// you may not use this file except in compliance with the License.
5*e7b1675dSTing-Kang Chang// You may obtain a copy of the License at
6*e7b1675dSTing-Kang Chang//
7*e7b1675dSTing-Kang Chang//      http://www.apache.org/licenses/LICENSE-2.0
8*e7b1675dSTing-Kang Chang//
9*e7b1675dSTing-Kang Chang// Unless required by applicable law or agreed to in writing, software
10*e7b1675dSTing-Kang Chang// distributed under the License is distributed on an "AS IS" BASIS,
11*e7b1675dSTing-Kang Chang// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12*e7b1675dSTing-Kang Chang// See the License for the specific language governing permissions and
13*e7b1675dSTing-Kang Chang// limitations under the License.
14*e7b1675dSTing-Kang Chang//
15*e7b1675dSTing-Kang Chang////////////////////////////////////////////////////////////////////////////////
16*e7b1675dSTing-Kang Chang
17*e7b1675dSTing-Kang Changsyntax = "proto3";
18*e7b1675dSTing-Kang Chang
19*e7b1675dSTing-Kang Changpackage google.crypto.tink;
20*e7b1675dSTing-Kang Chang
21*e7b1675dSTing-Kang Changoption java_package = "com.google.crypto.tink.proto";
22*e7b1675dSTing-Kang Changoption java_multiple_files = true;
23*e7b1675dSTing-Kang Changoption go_package = "github.com/google/tink/go/proto/aes_siv_go_proto";
24*e7b1675dSTing-Kang Chang
25*e7b1675dSTing-Kang Chang// Tink implements RFC 5297 (https://www.rfc-editor.org/rfc/rfc5297) for
26*e7b1675dSTing-Kang Chang// AES-SIV, putting the SIV/Tag at the beginning of the ciphertext.
27*e7b1675dSTing-Kang Chang//
28*e7b1675dSTing-Kang Chang// While the RFC 5297 supports a list of associated datas, Tink only supports
29*e7b1675dSTing-Kang Chang// exactly one associated data, which corresponds to a list with one element in
30*e7b1675dSTing-Kang Chang// RFC 5297. An empty associated data is a list with one empty element, and not
31*e7b1675dSTing-Kang Chang// an empty list.
32*e7b1675dSTing-Kang Chang
33*e7b1675dSTing-Kang Changmessage AesSivKeyFormat {
34*e7b1675dSTing-Kang Chang  // Only valid value is: 64.
35*e7b1675dSTing-Kang Chang  uint32 key_size = 1;
36*e7b1675dSTing-Kang Chang  uint32 version = 2;
37*e7b1675dSTing-Kang Chang}
38*e7b1675dSTing-Kang Chang
39*e7b1675dSTing-Kang Chang// key_type: type.googleapis.com/google.crypto.tink.AesSivKey
40*e7b1675dSTing-Kang Changmessage AesSivKey {
41*e7b1675dSTing-Kang Chang  uint32 version = 1;
42*e7b1675dSTing-Kang Chang  // First half is AES-CTR key, second is AES-SIV.
43*e7b1675dSTing-Kang Chang  bytes key_value = 2;
44*e7b1675dSTing-Kang Chang}
45