1 // Copyright 2017 Google Inc. 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 package com.google.crypto.tink.subtle; 18 19 import java.security.GeneralSecurityException; 20 21 /** 22 * This interface for symmetric key ciphers that are indistinguishable against chosen-plaintext 23 * attacks. 24 * 25 * <p>Said primitives do not provide authentication, thus should not be used directly, but only to 26 * construct safer primitives such as {@link com.google.crypto.tink.Aead}. 27 * 28 * @since 1.0.0 29 */ 30 public interface IndCpaCipher { 31 /** 32 * Encrypts {@code plaintext}. The resulting ciphertext is indistinguishable under 33 * chosen-plaintext attack. However, it does not have integrity protection. 34 * 35 * @return the resulting ciphertext. 36 */ encrypt(final byte[] plaintext)37 byte[] encrypt(final byte[] plaintext) throws GeneralSecurityException; 38 39 /** 40 * Decrypts {@code ciphertext}. 41 * 42 * @return the resulting plaintext. 43 */ decrypt(final byte[] ciphertext)44 byte[] decrypt(final byte[] ciphertext) throws GeneralSecurityException; 45 } 46