// Copyright 2022 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // //////////////////////////////////////////////////////////////////////////////// package com.google.crypto.tink.util; import com.google.crypto.tink.SecretKeyAccess; import com.google.crypto.tink.subtle.Random; import com.google.errorprone.annotations.Immutable; import java.security.MessageDigest; /** A class storing an immutable byte array, protecting the data via {@link SecretKeyAccess}. */ @Immutable public final class SecretBytes { private final Bytes bytes; private SecretBytes(Bytes bytes) { this.bytes = bytes; } /** * Creates a new SecretBytes with the contents given in {@code value}. * *

The parameter {@code access} must be non-null. */ public static SecretBytes copyFrom(byte[] value, SecretKeyAccess access) { if (access == null) { throw new NullPointerException("SecretKeyAccess required"); } return new SecretBytes(Bytes.copyFrom(value)); } /** Creates a new SecretBytes with bytes chosen uniformly at random of length {@code length}. */ public static SecretBytes randomBytes(int length) { return new SecretBytes(Bytes.copyFrom(Random.randBytes(length))); } /** * Returns a copy of the bytes wrapped by this object. * *

The parameter {@code access} must be non-null. */ public byte[] toByteArray(SecretKeyAccess access) { if (access == null) { throw new NullPointerException("SecretKeyAccess required"); } return bytes.toByteArray(); } /** Returns the length of the bytes wrapped by this object. */ public int size() { return bytes.size(); } /** * Returns true if the {@code other} byte array has the same bytes, in time depending only on the * length of both SecretBytes objects. */ public boolean equalsSecretBytes(SecretBytes other) { byte[] myArray = bytes.toByteArray(); byte[] otherArray = other.bytes.toByteArray(); return MessageDigest.isEqual(myArray, otherArray); } }