COSE

Class Signer

java.lang.Object

COSE.Signer

Direct Known Subclasses:

CounterSign

public class Signer
extends Object

The Signer class is used to implement the COSE_Signer object. This provides the information dealing with a single signature for the SignMessage class.

Create a Signer object for adding a new signature to a message, existing signers will have a Signer object created for them when a SignMessage object is created by Message.DecodeFromBytes.

Examples of using this class can be found in
Single Signer Example an example of signing and verify a message with a single signature.
Multiple Signer Example an example of signing and verifying a message which has multiple signatures.

Author:

jimsch

Field Summary

Fields

Modifier and Type	Field and Description
protected String	contextString
static int	DO_NOT_SEND Used to place an attribute in the do not send attribute map Attributes in this map are available for lookup and use but will not be transmitted as part of the message.
static int	DontSendAttributes Deprecated. As of COSE 0.9.1, use Attribute.DO_NOT_SEND
protected byte[]	externalData Holder for the external data object that is authenticated as part of the message
protected com.upokecenter.cbor.CBORObject	objDontSend Internal map of attributes which are not a part of the encoded message.
protected com.upokecenter.cbor.CBORObject	objProtected Internal map of protected attributes
protected com.upokecenter.cbor.CBORObject	objUnprotected Internal map of unprotected attributes
static int	PROTECTED Used to place an attribute in the protected attribute map Attributes placed in this map are part of the integrity check if the cryptographic algorithm supports authenticated data.
static int	ProtectedAttributes Deprecated. As of COSE 0.9.1, use Attribute.PROTECT
protected byte[]	rgbProtected The encoded byte string for the protected attributes.
protected byte[]	rgbSignature
static int	UNPROTECTED Used to place an attribute in the unprotected attribute map Attributes placed in this map are not integrity protected.
static int	UnprotectedAttributes Deprecated. As of COSE 0.9.1, use Attribute.UNPROTECT

Constructor Summary

Constructors

Constructor and Description
Signer() Create a new signer object to add to a SignMessage
Signer(OneKey key) Create a new signer object for a SignMessage and set the key to be used.

Method Summary

Modifier and Type	Method and Description
void	addAttribute(com.upokecenter.cbor.CBORObject label, com.upokecenter.cbor.CBORObject value, int where) Set an attribute in the COSE object.
void	addAttribute(HeaderKeys label, byte[] value, int where) Set an attribute in the COSE object.
void	addAttribute(HeaderKeys label, com.upokecenter.cbor.CBORObject value, int where) Set an attribute in the COSE object.
void	AddProtected(com.upokecenter.cbor.CBORObject label, com.upokecenter.cbor.CBORObject value) Deprecated. As of COSE 0.9.0, use addAttribute(CBORObject, CBORObject, Attribute.PROTECTED);
void	AddProtected(HeaderKeys label, byte[] value) Deprecated. As of COSE 0.9.0, use addAttribute(HeaderKeys, byte[], Attribute.PROTECTED);
void	AddProtected(HeaderKeys label, com.upokecenter.cbor.CBORObject value) Deprecated. As of COSE 0.9.0, use addAttribute(HeaderKeys, CBORObject, Attribute.PROTECTED);
void	AddUnprotected(com.upokecenter.cbor.CBORObject label, com.upokecenter.cbor.CBORObject value) Deprecated. As of COSE 0.9.1, use addAttribute(HeaderKeys, byte[], Attribute.UNPROTECTED);
void	AddUnprotected(HeaderKeys label, byte[] value) Deprecated. As of COSE 0.9.1, use addAttribute(HeaderKeys, byte[], Attribute.UNPROTECTED);
void	AddUnprotected(HeaderKeys label, com.upokecenter.cbor.CBORObject value) Deprecated. As of COSE 0.9.1, use addAttribute(HeaderKeys, byte[], Attribute.UNPROTECTED);
void	clearKey() Remove the key object from the signer
protected void	DecodeFromCBORObject(com.upokecenter.cbor.CBORObject obj) Internal function used in creating a Sign1Message object from a byte string.
protected com.upokecenter.cbor.CBORObject	EncodeToCBORObject() Internal function used to create a serialization of a COSE_Sign1 message
com.upokecenter.cbor.CBORObject	findAttribute(com.upokecenter.cbor.CBORObject label) Locate an attribute in one of the attribute buckets The buckets are searched in the order protected, unprotected, unsent.
com.upokecenter.cbor.CBORObject	findAttribute(com.upokecenter.cbor.CBORObject label, int where) Locate an attribute in one of the attribute buckets The buckets are searched in the order protected, unprotected, unsent.
com.upokecenter.cbor.CBORObject	findAttribute(HeaderKeys label) Locate an attribute in one of the attribute buckets The buckets are searched in the order protected, unprotected, unsent.
com.upokecenter.cbor.CBORObject	findAttribute(HeaderKeys label, int where) Locate an attribute in one of the attribute buckets The buckets are searched in the order protected, unprotected, unsent.
com.upokecenter.cbor.CBORObject	getDoNotSendAttributes() Return the entire map of do not send attributes
byte[]	getExternal() Get the optional external data field to be authenticated * @return external authenticated data
com.upokecenter.cbor.CBORObject	getProtectedAttributes() Return the entire map of protected attributes
com.upokecenter.cbor.CBORObject	getUnprotectedAttributes() Return the entire map of unprotected attributes
void	removeAttribute(com.upokecenter.cbor.CBORObject label) Remove an attribute from the set of all attribute maps.
void	removeAttribute(HeaderKeys label) Remove an attribute from the set of all attribute maps.
void	setExternal(byte[] rgbData) Set the optional external data field to be authenticated
void	setKey(com.upokecenter.cbor.CBORObject keyIn) Deprecated. As of COSE 0.9.1, use setKey(OneKey)
void	setKey(OneKey keyIn) Set a key object on a signer
void	sign(byte[] rgbBodyProtected, byte[] rgbContent)
boolean	validate(byte[] rgbBodyProtected, byte[] rgbContent)

Methods inherited from class java.lang.Object

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

Field Detail

rgbSignature

protected byte[] rgbSignature

contextString

protected String contextString

objProtected

protected com.upokecenter.cbor.CBORObject objProtected

Internal map of protected attributes

objUnprotected

protected com.upokecenter.cbor.CBORObject objUnprotected

Internal map of unprotected attributes

objDontSend

protected com.upokecenter.cbor.CBORObject objDontSend

Internal map of attributes which are not a part of the encoded message.

rgbProtected

protected byte[] rgbProtected

The encoded byte string for the protected attributes. If this variable is set then the message was either decoded or as been cryptographically signed/encrypted/maced. If it is set, then do not allow objProtected to be modified.

externalData

protected byte[] externalData

Holder for the external data object that is authenticated as part of the message

ProtectedAttributes

@Deprecated
public static final int ProtectedAttributes

Deprecated. As of COSE 0.9.1, use Attribute.PROTECT

Used to place an attribute in the protected attribute map Attributes placed in this map are part of the integrity check if the cryptographic algorithm supports authenticated data.

See Also:

Constant Field Values

UnprotectedAttributes

@Deprecated
public static final int UnprotectedAttributes

Deprecated. As of COSE 0.9.1, use Attribute.UNPROTECT

Used to place an attribute in the unprotected attribute map Attributes placed in this map are not integrity protected.

See Also:

Constant Field Values

DontSendAttributes

@Deprecated
public static final int DontSendAttributes

Deprecated. As of COSE 0.9.1, use Attribute.DO_NOT_SEND

Used to place an attribute in the do not send attribute map Attributes in this map are available for lookup and use but will not be transmitted as part of the message.

See Also:

Constant Field Values

PROTECTED

public static final int PROTECTED

Used to place an attribute in the protected attribute map Attributes placed in this map are part of the integrity check if the cryptographic algorithm supports authenticated data.

See Also:

Constant Field Values

UNPROTECTED

public static final int UNPROTECTED

Used to place an attribute in the unprotected attribute map Attributes placed in this map are not integrity protected.

See Also:

Constant Field Values

DO_NOT_SEND

public static final int DO_NOT_SEND

Used to place an attribute in the do not send attribute map Attributes in this map are available for lookup and use but will not be transmitted as part of the message.

See Also:

Constant Field Values

Constructor Detail

Signer

public Signer()

Create a new signer object to add to a SignMessage

Signer

public Signer(OneKey key)

Create a new signer object for a SignMessage and set the key to be used.

Parameters:

key - key to use for signing.

Method Detail

clearKey

public void clearKey()

Remove the key object from the signer

Since:

COSE 0.9.1

setKey

@Deprecated
public void setKey(com.upokecenter.cbor.CBORObject keyIn)
                         throws CoseException

Deprecated. As of COSE 0.9.1, use setKey(OneKey)

Provide the key for the signer

Parameters:

keyIn - key to be used for signing or verification

Throws:

CoseException - Errors generated by the COSE module

setKey

public void setKey(OneKey keyIn)
            throws CoseException

Set a key object on a signer

Parameters:

keyIn - key to be used for signing or verification

Throws:

CoseException

Since:

COSE 0.9.1

DecodeFromCBORObject

protected void DecodeFromCBORObject(com.upokecenter.cbor.CBORObject obj)
                             throws CoseException

Internal function used in creating a Sign1Message object from a byte string.

Parameters:

obj - COSE_Sign1 encoded object.

Throws:

CoseException - Errors generated by the COSE module

EncodeToCBORObject

protected com.upokecenter.cbor.CBORObject EncodeToCBORObject()
                                                      throws CoseException

Internal function used to create a serialization of a COSE_Sign1 message

Returns:

CBOR object which can be encoded.

Throws:

CoseException - Errors generated by the COSE module

sign

public void sign(byte[] rgbBodyProtected,
                 byte[] rgbContent)
          throws CoseException

Throws:

CoseException

validate

public boolean validate(byte[] rgbBodyProtected,
                        byte[] rgbContent)
                 throws CoseException

Throws:

CoseException

addAttribute

public void addAttribute(com.upokecenter.cbor.CBORObject label,
                         com.upokecenter.cbor.CBORObject value,
                         int where)
                  throws CoseException

Set an attribute in the COSE object. Setting an attribute in one map will remove it from all other maps as a side effect.

Parameters:

label - CBOR object which identifies the attribute in the map

value - CBOR object which contains the value of the attribute

where - Identifies which of the buckets to place the attribute in. ProtectedAttributes - attributes cryptographically protected UnprotectedAttributes - attributes not cryptographically protected DontSendAttributes - attributes used locally and not transmitted

Throws:

CoseException - COSE Package exception

addAttribute

public void addAttribute(HeaderKeys label,
                         com.upokecenter.cbor.CBORObject value,
                         int where)
                  throws CoseException

Set an attribute in the COSE object. Setting an attribute in one map will remove it from all other maps as a side effect.

Parameters:

label - HeaderKeys label which identifies the attribute in the map

value - CBOR object which contains the value of the attribute

where - Identifies which of the buckets to place the attribute in. ProtectedAttributes - attributes cryptographically protected UnprotectedAttributes - attributes not cryptographically protected DontSendAttributes - attributes used locally and not transmitted

Throws:

CoseException - COSE Package exception

addAttribute

public void addAttribute(HeaderKeys label,
                         byte[] value,
                         int where)
                  throws CoseException

Set an attribute in the COSE object. Setting an attribute in one map will remove it from all other maps as a side effect.

Parameters:

label - HeaderKeys label which identifies the attribute in the map

value - CBOR object which contains the value of the attribute

where - Identifies which of the buckets to place the attribute in. ProtectedAttributes - attributes cryptographically protected UnprotectedAttributes - attributes not cryptographically protected DontSendAttributes - attributes used locally and not transmitted

Throws:

CoseException - COSE Package exception

AddProtected

@Deprecated
public void AddProtected(com.upokecenter.cbor.CBORObject label,
                                      com.upokecenter.cbor.CBORObject value)
                               throws CoseException

Deprecated. As of COSE 0.9.0, use addAttribute(CBORObject, CBORObject, Attribute.PROTECTED);

Set an attribute in the protect bucket of the COSE object

Parameters:

label - CBOR object which identifies the attribute in the map

value - CBOR object which contains the value of the attribute

Throws:

CoseException - COSE Package exception

AddProtected

@Deprecated
public void AddProtected(HeaderKeys label,
                                      com.upokecenter.cbor.CBORObject value)
                               throws CoseException

Deprecated. As of COSE 0.9.0, use addAttribute(HeaderKeys, CBORObject, Attribute.PROTECTED);

Set an attribute in the protect bucket of the COSE object

Parameters:

label - HeaderKeys label which identifies the attribute in the map

value - CBOR object which contains the value of the attribute

Throws:

CoseException - COSE Package exception

AddProtected

@Deprecated
public void AddProtected(HeaderKeys label,
                                      byte[] value)
                               throws CoseException

Deprecated. As of COSE 0.9.0, use addAttribute(HeaderKeys, byte[], Attribute.PROTECTED);

Set an attribute in the protect bucket of the COSE object

Parameters:

label - CBOR object which identifies the attribute in the map

value - byte array of value

Throws:

CoseException - COSE Package exception

AddUnprotected

@Deprecated
public void AddUnprotected(com.upokecenter.cbor.CBORObject label,
                                        com.upokecenter.cbor.CBORObject value)
                                 throws CoseException

Deprecated. As of COSE 0.9.1, use addAttribute(HeaderKeys, byte[], Attribute.UNPROTECTED);

Set an attribute in the unprotected bucket of the COSE object

Parameters:

label - value identifies the attribute in the map

value - value to be associated with the label

Throws:

CoseException - COSE Package exception

AddUnprotected

@Deprecated
public void AddUnprotected(HeaderKeys label,
                                        com.upokecenter.cbor.CBORObject value)
                                 throws CoseException

Deprecated. As of COSE 0.9.1, use addAttribute(HeaderKeys, byte[], Attribute.UNPROTECTED);

Set an attribute in the unprotected bucket of the COSE object

Parameters:

label - identifies the attribute in the map

value - value to be associated with the label

Throws:

CoseException - COSE Package exception

AddUnprotected

@Deprecated
public void AddUnprotected(HeaderKeys label,
                                        byte[] value)
                                 throws CoseException

Deprecated. As of COSE 0.9.1, use addAttribute(HeaderKeys, byte[], Attribute.UNPROTECTED);

Set an attribute in the unprotected bucket of the COSE object

Parameters:

label - identifies the attribute in the map

value - value to be associated with the label

Throws:

CoseException - COSE Package exception

findAttribute

public com.upokecenter.cbor.CBORObject findAttribute(com.upokecenter.cbor.CBORObject label)

Locate an attribute in one of the attribute buckets The buckets are searched in the order protected, unprotected, unsent.

Parameters:

label - - Label of the value to be searched for

Returns:

- CBORObject with the value if found; otherwise null

findAttribute

public com.upokecenter.cbor.CBORObject findAttribute(com.upokecenter.cbor.CBORObject label,
                                                     int where)

Locate an attribute in one of the attribute buckets The buckets are searched in the order protected, unprotected, unsent.

Parameters:

label - - HeaderKey enumeration value to search for

where - which maps to search for the label

Returns:

- CBORObject with the value if found; otherwise null

findAttribute

public com.upokecenter.cbor.CBORObject findAttribute(HeaderKeys label)

Locate an attribute in one of the attribute buckets The buckets are searched in the order protected, unprotected, unsent.

Parameters:

label - - HeaderKey enumeration value to search for

Returns:

- CBORObject with the value if found; otherwise null

findAttribute

public com.upokecenter.cbor.CBORObject findAttribute(HeaderKeys label,
                                                     int where)

Locate an attribute in one of the attribute buckets The buckets are searched in the order protected, unprotected, unsent.

Parameters:

label - - HeaderKey enumeration value to search for

where - which maps to search for the label

Returns:

- CBORObject with the value if found; otherwise null

getProtectedAttributes

public com.upokecenter.cbor.CBORObject getProtectedAttributes()

Return the entire map of protected attributes

Returns:

the protected attribute map

getUnprotectedAttributes

public com.upokecenter.cbor.CBORObject getUnprotectedAttributes()

Return the entire map of unprotected attributes

Returns:

the unprotected attribute map

getDoNotSendAttributes

public com.upokecenter.cbor.CBORObject getDoNotSendAttributes()

Return the entire map of do not send attributes

Returns:

the do not send attribute map

removeAttribute

public void removeAttribute(com.upokecenter.cbor.CBORObject label)
                     throws CoseException

Remove an attribute from the set of all attribute maps.

Parameters:

label - attribute to be removed

Throws:

CoseException - if integrity protection would be modified.

removeAttribute

public void removeAttribute(HeaderKeys label)
                     throws CoseException

Remove an attribute from the set of all attribute maps.

Parameters:

label - attribute to be removed

Throws:

CoseException

getExternal

public byte[] getExternal()

Get the optional external data field to be authenticated * @return external authenticated data

setExternal

public void setExternal(byte[] rgbData)

Set the optional external data field to be authenticated

Parameters:

rgbData - - data to be authenticated