Package org.xbill.DNS

Class KEYRecord

java.lang.Object

org.xbill.DNS.Record

org.xbill.DNS.KEYBase

org.xbill.DNS.KEYRecord

All Implemented Interfaces:

Serializable, Cloneable, Comparable<Record>

public class KEYRecord
extends KEYBase

Key - contains a cryptographic public key. The data can be converted to objects implementing java.security.interfaces.PublicKey

See Also:

• DNSSEC
• DNSKEYRecord
• RFC 2535: Domain Name System Security Extensions
• RFC 3755: Legacy Resolver Compatibility for Delegation Signer (DS)
• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	KEYRecord.Flags	KEY flags identifiers.
static class	KEYRecord.Protocol	KEY protocol identifiers.

Field Summary

Fields

Modifier and Type	Field	Description
static final int	FLAG_NOAUTH	This key cannot be used for authentication
static final int	FLAG_NOCONF	This key cannot be used for confidentiality (encryption)
static final int	FLAG_NOKEY	This key cannot be used for authentication or confidentiality
static final int	OWNER_HOST	A host/end entity key
static final int	OWNER_USER	A user key
static final int	OWNER_ZONE	A zone key
static final int	PROTOCOL_ANY	Key was created for use with any protocol
static final int	PROTOCOL_DNSSEC	Key was created for use with DNSSEC
static final int	PROTOCOL_EMAIL	Key was created for use with email
static final int	PROTOCOL_IPSEC	Key was created for use with IPSEC
static final int	PROTOCOL_TLS	Key was created for use with transaction level security

Fields inherited from class org.xbill.DNS.KEYBase

alg, flags, footprint, key, proto, publicKey

Fields inherited from class org.xbill.DNS.Record

dclass, name, ttl, type

Constructor Summary

Constructors

Constructor	Description
KEYRecord()
KEYRecord(Name name, int dclass, long ttl, int flags, int proto, int alg, byte[] key)	Creates a KEY Record from the given data
KEYRecord(Name name, int dclass, long ttl, int flags, int proto, int alg, PublicKey key)	Creates a KEY Record from the given data

Method Summary

Modifier and Type	Method	Description
protected void	rdataFromString(Tokenizer st, Name origin)	Converts the text format of an RR to the internal format - must be overriden

Methods inherited from class org.xbill.DNS.KEYBase

getAlgorithm, getFlags, getFootprint, getKey, getProtocol, getPublicKey, rrFromWire, rrToString, rrToWire

Methods inherited from class org.xbill.DNS.Record

byteArrayFromString, byteArrayToString, checkByteArrayLength, checkName, checkU16, checkU32, checkU8, cloneRecord, compareTo, equals, fromString, fromString, fromWire, fromWire, fromWire, getAdditionalName, getDClass, getName, getRRsetType, getTTL, getType, hashCode, newRecord, newRecord, newRecord, newRecord, rdataToString, rdataToWireCanonical, sameRRset, sameRRset, setTTL, toString, toWire, toWire, toWireCanonical, unknownToString, withDClass, withName, writeReplace

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

FLAG_NOCONF

public static final int FLAG_NOCONF

This key cannot be used for confidentiality (encryption)

See Also:

• Constant Field Values

FLAG_NOAUTH

public static final int FLAG_NOAUTH

This key cannot be used for authentication

See Also:

• Constant Field Values

FLAG_NOKEY

public static final int FLAG_NOKEY

This key cannot be used for authentication or confidentiality

See Also:

• Constant Field Values

OWNER_ZONE

public static final int OWNER_ZONE

A zone key

See Also:

• Constant Field Values

OWNER_HOST

public static final int OWNER_HOST

A host/end entity key

See Also:

• Constant Field Values

OWNER_USER

public static final int OWNER_USER

A user key

See Also:

• Constant Field Values

PROTOCOL_TLS

public static final int PROTOCOL_TLS

Key was created for use with transaction level security

See Also:

• Constant Field Values

PROTOCOL_EMAIL

public static final int PROTOCOL_EMAIL

Key was created for use with email

See Also:

• Constant Field Values

PROTOCOL_DNSSEC

public static final int PROTOCOL_DNSSEC

Key was created for use with DNSSEC

See Also:

• Constant Field Values

PROTOCOL_IPSEC

public static final int PROTOCOL_IPSEC

Key was created for use with IPSEC

See Also:

• Constant Field Values

PROTOCOL_ANY

public static final int PROTOCOL_ANY

Key was created for use with any protocol

See Also:

• Constant Field Values

Constructor Details

KEYRecord

KEYRecord()

KEYRecord

public KEYRecord(Name name,
 int dclass,
 long ttl,
 int flags,
 int proto,
 int alg,
 byte[] key)

Creates a KEY Record from the given data

Parameters:

flags - Flags describing the key's properties

proto - The protocol that the key was created for

alg - The key's algorithm

key - Binary data representing the key

KEYRecord

public KEYRecord(Name name,
 int dclass,
 long ttl,
 int flags,
 int proto,
 int alg,
 PublicKey key)
          throws DNSSEC.DNSSECException

Creates a KEY Record from the given data

Parameters:

flags - Flags describing the key's properties

proto - The protocol that the key was created for

alg - The key's algorithm

key - The key as a PublicKey

Throws:

DNSSEC.DNSSECException - The PublicKey could not be converted into DNS format.

Method Details

rdataFromString

protected void rdataFromString(Tokenizer st,
 Name origin)
                        throws IOException

Description copied from class: Record

Converts the text format of an RR to the internal format - must be overriden

Specified by:

rdataFromString in class Record

Throws:

IOException