A Signature is storage for the signature-related information (info and value) in a Data packet. More...

#include <signature.hpp>

Inheritance diagram for ndn::Signature:

Collaboration diagram for ndn::Signature:

Classes
class	Error

Public Types
enum	{ Sha256 = tlv::DigestSha256, Sha256WithRsa = tlv::SignatureSha256WithRsa, Sha256WithEcdsa = tlv::SignatureSha256WithEcdsa }

Public Member Functions
	Signature ()=default

	Signature (const Block &info, const Block &value=Block())

	Signature (const SignatureInfo &info, const Block &value=Block())

	operator bool () const

const Block &	getInfo () const
	Get SignatureInfo in the wire format. More...

void	setInfo (const Block &info)
	Set SignatureInfo from a block. More...

void	setInfo (const SignatureInfo &info)
	Set SignatureInfo. More...

const Block &	getValue () const
	Get SignatureValue in the wire format. More...

void	setValue (const Block &value)
	Get SignatureValue from a block. More...

uint32_t	getType () const
	Get signature type. More...

bool	hasKeyLocator () const
	Check if SignatureInfo block has a KeyLocator. More...

const KeyLocator &	getKeyLocator () const
	Get KeyLocator. More...

void	setKeyLocator (const KeyLocator &keyLocator)
	Set KeyLocator. More...

void	unsetKeyLocator ()
	Unset KeyLocator. More...

bool	operator== (const Signature &other) const

bool	operator!= (const Signature &other) const

Protected Attributes
SignatureInfo	m_info

Block	m_value

Detailed Description

A Signature is storage for the signature-related information (info and value) in a Data packet.

Definition at line 33 of file signature.hpp.

Member Enumeration Documentation

anonymous enum

Deprecated:: use tlv::SignatureTypeValue instead.

Enumerator
Sha256
Sha256WithRsa
Sha256WithEcdsa

Definition at line 47 of file signature.hpp.

Constructor & Destructor Documentation

ndn::Signature::Signature ( )

default

ndn::Signature::Signature	(	const Block &	info,
		const Block &	value = `Block()`
	)

explicit

Definition at line 30 of file signature.cpp.

ndn::Signature::Signature	(	const SignatureInfo &	info,
		const Block &	value = `Block()`
	)

explicit

Definition at line 37 of file signature.cpp.

Member Function Documentation

ndn::Signature::operator bool ( ) const

inline

Definition at line 61 of file signature.hpp.

References ndn::SignatureInfo::getSignatureType(), and m_info.

const Block& ndn::Signature::getInfo ( ) const

inline

Get SignatureInfo in the wire format.

Definition at line 70 of file signature.hpp.

References m_info, setInfo(), and ndn::SignatureInfo::wireEncode().

Referenced by ndn::security::KeyChain::importIdentity(), ndn::Interest::matchesData(), operator==(), ndn::security::KeyChain::selfSign(), ndn::security::KeyChain::signWithSha256(), and ndn::Data::wireEncode().

void ndn::Signature::setInfo ( const Block & info )

Set SignatureInfo from a block.

Exceptions

tlv::Error if supplied block is not formatted correctly

Definition at line 44 of file signature.cpp.

References m_info, and ndn::tlv::SignatureInfo.

Referenced by getInfo(), and ndn::Data::wireDecode().

void ndn::Signature::setInfo ( const SignatureInfo & info )

inline

Set SignatureInfo.

Definition at line 87 of file signature.hpp.

References m_info.

const Block& ndn::Signature::getValue ( ) const

inline

Get SignatureValue in the wire format.

Definition at line 96 of file signature.hpp.

References ndn::Block::encode(), m_value, and setValue().

Referenced by ndn::operator<<(), operator==(), ndn::security::KeyChain::signWithSha256(), ndn::Validator::verifySignature(), and ndn::Data::wireEncode().

void ndn::Signature::setValue ( const Block & value )

Get SignatureValue from a block.

Exceptions

tlv::Error if supplied block has type different from SignatureValue

Definition at line 50 of file signature.cpp.

References m_value, ndn::tlv::SignatureValue, and ndn::Block::type().

Referenced by getValue(), ndn::Data::setSignatureValue(), ndn::security::KeyChain::sign(), ndn::security::KeyChain::signByIdentity(), and ndn::Data::wireDecode().

uint32_t ndn::Signature::getType ( ) const

inline

Get signature type.

Definition at line 114 of file signature.hpp.

References ndn::SignatureInfo::getSignatureType(), and m_info.

Referenced by ndn::security::conf::CustomizedChecker::check(), ndn::security::conf::FixedSignerChecker::check(), ndn::ValidatorConfig::checkPolicy(), ndn::CommandInterestValidator::checkPolicy(), ndn::DigestSha256::DigestSha256(), ndn::operator<<(), ndn::SignatureSha256WithEcdsa::SignatureSha256WithEcdsa(), ndn::SignatureSha256WithRsa::SignatureSha256WithRsa(), and ndn::Validator::verifySignature().

bool ndn::Signature::hasKeyLocator ( ) const

inline

Check if SignatureInfo block has a KeyLocator.

Definition at line 123 of file signature.hpp.

References ndn::SignatureInfo::hasKeyLocator(), and m_info.

Referenced by ndn::security::conf::CustomizedChecker::check(), ndn::security::conf::FixedSignerChecker::check(), ndn::ValidatorRegex::checkPolicy(), ndn::ValidatorConfig::checkPolicy(), ndn::SecRuleSpecific::matchSignerName(), ndn::SecRuleRelative::matchSignerName(), ndn::SecRuleRelative::satisfy(), ndn::SignatureSha256WithEcdsa::SignatureSha256WithEcdsa(), ndn::SignatureSha256WithRsa::SignatureSha256WithRsa(), and ndn::Validator::verifySignature().

const KeyLocator& ndn::Signature::getKeyLocator ( ) const

inline

Get KeyLocator.

Exceptions

Signature::Error if KeyLocator does not exist

Definition at line 134 of file signature.hpp.

References ndn::SignatureInfo::getKeyLocator(), and m_info.

Referenced by ndn::SecPublicInfoSqlite3::addCertificate(), ndn::security::conf::CustomizedChecker::check(), ndn::security::conf::FixedSignerChecker::check(), ndn::ValidatorRegex::checkPolicy(), ndn::ValidatorConfig::checkPolicy(), ndn::CommandInterestValidator::checkPolicy(), ndn::SecRuleSpecific::matchSignerName(), ndn::SecRuleRelative::matchSignerName(), ndn::Certificate::printCertificate(), and ndn::SecRuleRelative::satisfy().

void ndn::Signature::setKeyLocator ( const KeyLocator & keyLocator )

inline

Set KeyLocator.

Definition at line 143 of file signature.hpp.

References m_info, and ndn::SignatureInfo::setKeyLocator().

void ndn::Signature::unsetKeyLocator ( )

inline

Unset KeyLocator.

Note that specific signature types may provide advisory (non-virtual) override to prevent unsetting KeyLocator if it is required by the specification.

Definition at line 155 of file signature.hpp.

References m_info, and ndn::SignatureInfo::unsetKeyLocator().

bool ndn::Signature::operator== ( const Signature & other ) const

inline

Definition at line 162 of file signature.hpp.

References getInfo(), and getValue().

bool ndn::Signature::operator!= ( const Signature & other ) const

inline

Definition at line 169 of file signature.hpp.

Member Data Documentation

SignatureInfo ndn::Signature::m_info

protected

Definition at line 175 of file signature.hpp.

Referenced by getInfo(), getKeyLocator(), getType(), hasKeyLocator(), operator bool(), setInfo(), setKeyLocator(), and unsetKeyLocator().

Block ndn::Signature::m_value

mutableprotected

Definition at line 176 of file signature.hpp.

Referenced by getValue(), and setValue().

The documentation for this class was generated from the following files:

ndnSIM/ndn-cxx/src/signature.hpp
ndnSIM/ndn-cxx/src/signature.cpp

Classes

Public Types

Public Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation