com.google.crypto.tink

Class CleartextKeysetHandle

java.lang.Object

com.google.crypto.tink.CleartextKeysetHandle

public final class CleartextKeysetHandle
extends Object

Static methods for reading or writing cleartext keysets.

WARNING

Reading or writing cleartext keysets is a bad practice, usage of this API should be restricted. Users can read encrypted keysets using KeysetHandle.read(com.google.crypto.tink.KeysetReader, com.google.crypto.tink.Aead).

Since:

1.0.0

Method Summary

Modifier and Type	Method and Description
static KeysetHandle	fromKeyset(Keyset keyset) Deprecated. Instead, use a KeysetHandle.Builder.
static Keyset	getKeyset(KeysetHandle keysetHandle) Deprecated. Instead, call "KeysetHandle.getAt()" to get information about individual keys or TinkProtoKeysetFormat if you need a serialized keyset.
static KeysetHandle	parseFrom(byte[] serialized) Deprecated. Call TinkProtoKeysetFormat.parseKeyset(serialized, InsecureSecretKeyAccess.get()) which has the same semantics.
static KeysetHandle	read(KeysetReader reader)
static KeysetHandle	read(KeysetReader reader, Map<String,String> monitoringAnnotations) Deprecated. Instead, use a KeysetHandle.Builder.
static void	write(KeysetHandle handle, KeysetWriter keysetWriter) Serializes and writes the Keyset managed by handle to keysetWriter.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

parseFrom

@Deprecated
public static final KeysetHandle parseFrom(byte[] serialized)
                                                throws GeneralSecurityException

Deprecated. Call TinkProtoKeysetFormat.parseKeyset(serialized, InsecureSecretKeyAccess.get()) which has the same semantics.

Returns:

a new KeysetHandle from serialized that is a serialized Keyset

Throws:

GeneralSecurityException

read

public static KeysetHandle read(KeysetReader reader)
                         throws GeneralSecurityException,
                                IOException

Returns:

a new KeysetHandle from a Keyset read with reader.

Throws:

GeneralSecurityException - when the keyset is invalid or can't be read.

IOException

read

@Deprecated
public static KeysetHandle read(KeysetReader reader,
                                            Map<String,String> monitoringAnnotations)
                                     throws GeneralSecurityException,
                                            IOException

Deprecated. Instead, use a KeysetHandle.Builder.

Creates a KeysetHandle from a KeysetReader.

The additional monitoringAnnotations are used for monitoring, and will be passed to the MonitoringClient.

Throws:

GeneralSecurityException - when the keyset is invalid or cannot be read.

IOException

getKeyset

@Deprecated
public static Keyset getKeyset(KeysetHandle keysetHandle)

Deprecated. Instead, call "KeysetHandle.getAt()" to get information about individual keys or TinkProtoKeysetFormat if you need a serialized keyset.

Returns:

the keyset underlying this keysetHandle.

fromKeyset

@Deprecated
public static KeysetHandle fromKeyset(Keyset keyset)
                                           throws GeneralSecurityException

Deprecated. Instead, use a KeysetHandle.Builder.

Returns a KeysetHandle for keyset.

Throws:

GeneralSecurityException

write

public static void write(KeysetHandle handle,
                         KeysetWriter keysetWriter)
                  throws IOException

Serializes and writes the Keyset managed by handle to keysetWriter.

Throws:

IOException