xref: /aosp_15_r20/external/tink/go/keyderivation/keyset_deriver.go (revision e7b1675dde1b92d52ec075b0a92829627f2c52a5)
1*e7b1675dSTing-Kang Chang// Copyright 2022 Google LLC
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 Changpackage keyderivation
18*e7b1675dSTing-Kang Chang
19*e7b1675dSTing-Kang Changimport (
20*e7b1675dSTing-Kang Chang	"github.com/google/tink/go/keyset"
21*e7b1675dSTing-Kang Chang)
22*e7b1675dSTing-Kang Chang
23*e7b1675dSTing-Kang Chang// KeysetDeriver is the interface used to derive new keysets based on an
24*e7b1675dSTing-Kang Chang// additional input, the salt.
25*e7b1675dSTing-Kang Chang//
26*e7b1675dSTing-Kang Chang// The salt is used to create the keyset using a pseudorandom function.
27*e7b1675dSTing-Kang Chang// Implementations must be indistinguishable from ideal KeysetDerivers, which,
28*e7b1675dSTing-Kang Chang// for every salt, generates a new random keyset and caches it.
29*e7b1675dSTing-Kang Changtype KeysetDeriver interface {
30*e7b1675dSTing-Kang Chang	DeriveKeyset(salt []byte) (*keyset.Handle, error)
31*e7b1675dSTing-Kang Chang}
32