provides the interfaces for packet validation. More...

#include <validator.hpp>

Inheritance diagram for ndn::security::Validator:

[legend]

Collaboration diagram for ndn::security::Validator:

Classes
class	Error

Public Member Functions
	Validator (Face *face=nullptr)
	Validator constructor. More...

	Validator (Face &face)

virtual	~Validator ()

void	validate (const Data &data, const OnDataValidated &onValidated, const OnDataValidationFailed &onValidationFailed)
	Validate Data and call either onValidated or onValidationFailed. More...

void	validate (const Interest &interest, const OnInterestValidated &onValidated, const OnInterestValidationFailed &onValidationFailed)
	Validate Interest and call either onValidated or onValidationFailed. More...

Static Public Member Functions
static bool	verifySignature (const Data &data, const v1::PublicKey &publicKey)
	Verify the data using the publicKey. More...

static bool	verifySignature (const Interest &interest, const v1::PublicKey &publicKey)
	Verify the signed Interest using the publicKey. More...

static bool	verifySignature (const Buffer &blob, const Signature &sig, const v1::PublicKey &publicKey)
	Verify the blob using the publicKey against the signature. More...

static bool	verifySignature (const Data &data, const Signature &sig, const v1::PublicKey &publicKey)
	Verify the data using the publicKey against the SHA256-RSA signature. More...

static bool	verifySignature (const Interest &interest, const Signature &sig, const v1::PublicKey &publicKey)
	Verify the interest using the publicKey against the SHA256-RSA signature. More...

static bool	verifySignature (const uint8_t *buf, const size_t size, const Signature &sig, const v1::PublicKey &publicKey)
	Verify the blob using the publicKey against the SHA256-RSA signature. More...

static bool	verifySignature (const Data &data, const DigestSha256 &sig)
	Verify the data against the SHA256 signature. More...

static bool	verifySignature (const Interest &interest, const DigestSha256 &sig)
	Verify the interest against the SHA256 signature. More...

static bool	verifySignature (const Buffer &blob, const DigestSha256 &sig)
	Verify the blob against the SHA256 signature. More...

static bool	verifySignature (const uint8_t *buf, const size_t size, const DigestSha256 &sig)
	Verify the blob against the SHA256 signature. More...

Protected Types
typedef function< void(const std::string &)>	OnFailure

Protected Member Functions
virtual void	checkPolicy (const Data &data, int nSteps, const OnDataValidated &onValidated, const OnDataValidationFailed &onValidationFailed, std::vector< shared_ptr< ValidationRequest >> &nextSteps)=0
	Check the Data against policy and return the next validation step if necessary. More...

virtual void	checkPolicy (const Interest &interest, int nSteps, const OnInterestValidated &onValidated, const OnInterestValidationFailed &onValidationFailed, std::vector< shared_ptr< ValidationRequest >> &nextSteps)=0
	Check the Interest against validation policy and return the next validation step if necessary. More...

void	onData (const Interest &interest, const Data &data, const shared_ptr< ValidationRequest > &nextStep)
	Process the received certificate. More...

void	validate (const Data &data, const OnDataValidated &onValidated, const OnDataValidationFailed &onValidationFailed, int nSteps)

void	validate (const Interest &interest, const OnInterestValidated &onValidated, const OnInterestValidationFailed &onValidationFailed, int nSteps)

virtual shared_ptr< const Data >	preCertificateValidation (const Data &data)
	Hooks. More...

virtual void	onNack (const Interest &interest, const lp::Nack &nack, int nRemainingRetries, const OnFailure &onFailure, const shared_ptr< ValidationRequest > &validationRequest)
	trigger when interest retrieves a Nack. More...

virtual void	onTimeout (const Interest &interest, int nRemainingRetries, const OnFailure &onFailure, const shared_ptr< ValidationRequest > &validationRequest)
	trigger when interest for certificate times out. More...

virtual void	afterCheckPolicy (const std::vector< shared_ptr< ValidationRequest >> &nextSteps, const OnFailure &onFailure)
	trigger after checkPolicy is done. More...

Protected Attributes
Face *	m_face

Detailed Description

provides the interfaces for packet validation.

Definition at line 42 of file validator.hpp.

Member Typedef Documentation

◆ OnFailure

typedef function<void(const std::string&)> ndn::security::Validator::OnFailure

protected

Definition at line 242 of file validator.hpp.

Constructor & Destructor Documentation

◆ Validator() [1/2]

ndn::security::Validator::Validator ( Face * face = nullptr )

explicit

Validator constructor.

Parameters

face	Pointer to face through which validator may retrieve certificates. Passing a null pointer implies the validator is in offline mode.

Note: Make sure the lifetime of the passed Face is longer than validator.

Definition at line 36 of file validator.cpp.

Referenced by ndn::security::Validator::Error::Error().

◆ Validator() [2/2]

ndn::security::Validator::Validator ( Face & face )

explicit

Deprecated:: Use the constructor taking Face* as parameter.

Definition at line 41 of file validator.cpp.

References ~Validator().

◆ ~Validator()

ndn::security::Validator::~Validator ( )

virtualdefault

Referenced by ndn::security::Validator::Error::Error(), and Validator().

Member Function Documentation

◆ validate() [1/4]

void ndn::security::Validator::validate	(	const Data &	data,
		const OnDataValidated &	onValidated,
		const OnDataValidationFailed &	onValidationFailed
	)

inline

Validate Data and call either onValidated or onValidationFailed.

Parameters

data	The Data with the signature to check.
onValidated	If the Data is validated, this calls onValidated(data).
onValidationFailed	If validation fails, this calls onValidationFailed(data).

Definition at line 81 of file validator.hpp.

Referenced by ndn::nfd::Controller::Controller(), onData(), nfd::rib::RibManager::onRibUpdateFailure(), and validate().

◆ validate() [2/4]

void ndn::security::Validator::validate	(	const Interest &	interest,
		const OnInterestValidated &	onValidated,
		const OnInterestValidationFailed &	onValidationFailed
	)

inline

Validate Interest and call either onValidated or onValidationFailed.

Parameters

interest	The Interest with the signature to check.
onValidated	If the Interest is validated, this calls onValidated(interest).
onValidationFailed	If validation fails, this calls onValidationFailed(interest).

Definition at line 96 of file validator.hpp.

References validate(), and verifySignature().

◆ verifySignature() [1/10]

bool ndn::security::Validator::verifySignature	(	const Data &	data,
		const v1::PublicKey &	publicKey
	)

static

Verify the data using the publicKey.

Definition at line 105 of file validator.cpp.

References ndn::Data::getSignature(), ndn::Signature::getValue(), ndn::Signature::hasKeyLocator(), ndn::Block::size(), and ndn::Data::wireEncode().

Referenced by ndn::security::conf::FixedSignerChecker::check(), ndn::security::ValidatorRegex::checkPolicy(), ndn::security::ValidatorConfig::checkPolicy(), nfd::CommandAuthenticator::makeAuthorization(), ndn::security::ValidatorRegex::onCertificateValidated(), validate(), and verifySignature().

◆ verifySignature() [2/10]

bool ndn::security::Validator::verifySignature	(	const Interest &	interest,
		const v1::PublicKey &	publicKey
	)

static

Verify the signed Interest using the publicKey.

(Note the signature covers the first n-2 name components).

Definition at line 117 of file validator.cpp.

References ndn::Interest::getName(), ndn::Signature::hasKeyLocator(), ndn::signed_interest::MIN_LENGTH_SIG_ONLY, ndn::signed_interest::POS_SIG_INFO, ndn::signed_interest::POS_SIG_VALUE, ndn::Signature::setInfo(), ndn::Signature::setValue(), ndn::Name::size(), ndn::Block::value(), ndn::Block::value_size(), verifySignature(), and ndn::Name::wireEncode().

◆ verifySignature() [3/10]

static bool ndn::security::Validator::verifySignature	(	const Buffer &	blob,
		const Signature &	sig,
		const v1::PublicKey &	publicKey
	)

inlinestatic

Verify the blob using the publicKey against the signature.

Definition at line 121 of file validator.hpp.

References ndn::Buffer::buf(), and verifySignature().

◆ verifySignature() [4/10]

static bool ndn::security::Validator::verifySignature	(	const Data &	data,
		const Signature &	sig,
		const v1::PublicKey &	publicKey
	)

inlinestatic

Verify the data using the publicKey against the SHA256-RSA signature.

Definition at line 128 of file validator.hpp.

References ndn::Data::getSignature(), ndn::Signature::getValue(), ndn::Block::size(), verifySignature(), and ndn::Data::wireEncode().

◆ verifySignature() [5/10]

static bool ndn::security::Validator::verifySignature	(	const Interest &	interest,
		const Signature &	sig,
		const v1::PublicKey &	publicKey
	)

inlinestatic

Verify the interest using the publicKey against the SHA256-RSA signature.

(Note the signature covers the first n-2 name components).

Definition at line 142 of file validator.hpp.

References ndn::Interest::getName(), ndn::Name::size(), verifySignature(), and ndn::Name::wireEncode().

◆ verifySignature() [6/10]

bool ndn::security::Validator::verifySignature	(	const uint8_t *	buf,
		const size_t	size,
		const Signature &	sig,
		const v1::PublicKey &	publicKey
	)

static

Verify the blob using the publicKey against the SHA256-RSA signature.

Definition at line 143 of file validator.cpp.

References ndn::Buffer::buf(), ndn::Oid::decode(), ndn::EC, ndn::security::v1::PublicKey::get(), ndn::security::v1::PublicKey::getKeyType(), ndn::Signature::getType(), ndn::Signature::getValue(), ndn::RSA, ndn::security::SECP256R1, ndn::security::SECP384R1, ndn::tlv::SignatureSha256WithEcdsa, ndn::tlv::SignatureSha256WithRsa, ndn::Block::value(), and ndn::Block::value_size().

◆ verifySignature() [7/10]

static bool ndn::security::Validator::verifySignature	(	const Data &	data,
		const DigestSha256 &	sig
	)

inlinestatic

Verify the data against the SHA256 signature.

Definition at line 166 of file validator.hpp.

References ndn::Data::getSignature(), ndn::Signature::getValue(), ndn::Block::size(), verifySignature(), and ndn::Data::wireEncode().

◆ verifySignature() [8/10]

static bool ndn::security::Validator::verifySignature	(	const Interest &	interest,
		const DigestSha256 &	sig
	)

inlinestatic

Verify the interest against the SHA256 signature.

(Note the signature covers the first n-2 name components).

Definition at line 179 of file validator.hpp.

References ndn::Interest::getName(), ndn::Name::size(), verifySignature(), and ndn::Name::wireEncode().

◆ verifySignature() [9/10]

static bool ndn::security::Validator::verifySignature	(	const Buffer &	blob,
		const DigestSha256 &	sig
	)

inlinestatic

Verify the blob against the SHA256 signature.

Definition at line 193 of file validator.hpp.

References ndn::Buffer::buf(), checkPolicy(), and verifySignature().

◆ verifySignature() [10/10]

bool ndn::security::Validator::verifySignature	(	const uint8_t *	buf,
		const size_t	size,
		const DigestSha256 &	sig
	)

static

Verify the blob against the SHA256 signature.

Definition at line 235 of file validator.cpp.

References ndn::crypto::computeSha256Digest(), ndn::Signature::getValue(), ndn::crypto::SHA256_DIGEST_SIZE, ndn::Block::value(), and ndn::Block::value_size().

◆ checkPolicy() [1/2]

virtual void ndn::security::Validator::checkPolicy	(	const Data &	data,
		int	nSteps,
		const OnDataValidated &	onValidated,
		const OnDataValidationFailed &	onValidationFailed,
		std::vector< shared_ptr< ValidationRequest >> &	nextSteps
	)

protectedpure virtual

Check the Data against policy and return the next validation step if necessary.

If there is no next validation step, that validation MUST have been done. i.e., either onValidated or onValidationFailed callback is invoked.

Parameters

data	The Data to check.
nSteps	The number of validation steps that have been done.
onValidated	If the Data is validated, this calls onValidated(data)
onValidationFailed	If validation fails, this calls onValidationFailed(data)
nextSteps	On return, contains the next validation step

Implemented in ndn::security::CommandInterestValidator, and ndn::security::ValidatorConfig.

Referenced by validate(), and verifySignature().

◆ checkPolicy() [2/2]

virtual void ndn::security::Validator::checkPolicy	(	const Interest &	interest,
		int	nSteps,
		const OnInterestValidated &	onValidated,
		const OnInterestValidationFailed &	onValidationFailed,
		std::vector< shared_ptr< ValidationRequest >> &	nextSteps
	)

protectedpure virtual

Check the Interest against validation policy and return the next validation step if necessary.

If there is no next validation step, that validation MUST have been done. i.e., either onValidated or onValidationFailed callback is invoked.

Parameters

interest	The Interest to check.
nSteps	The number of validation steps that have been done.
onValidated	If the Interest is validated, this calls onValidated(data)
onValidationFailed	If validation fails, this calls onValidationFailed(data)
nextSteps	On return, contains the next validation step

Implemented in ndn::security::CommandInterestValidator, and ndn::security::ValidatorConfig.

◆ onData()

void ndn::security::Validator::onData	(	const Interest &	interest,
		const Data &	data,
		const shared_ptr< ValidationRequest > &	nextStep
	)

protected

Process the received certificate.

Definition at line 89 of file validator.cpp.

References ndn::Data::getName(), preCertificateValidation(), ndn::Name::toUri(), and validate().

Referenced by afterCheckPolicy(), onNack(), and onTimeout().

◆ validate() [3/4]

void ndn::security::Validator::validate	(	const Data &	data,
		const OnDataValidated &	onValidated,
		const OnDataValidationFailed &	onValidationFailed,
		int	nSteps
	)

protected

Definition at line 69 of file validator.cpp.

References afterCheckPolicy(), and checkPolicy().

◆ validate() [4/4]

void ndn::security::Validator::validate	(	const Interest &	interest,
		const OnInterestValidated &	onValidated,
		const OnInterestValidationFailed &	onValidationFailed,
		int	nSteps
	)

protected

Definition at line 49 of file validator.cpp.

References afterCheckPolicy(), and checkPolicy().

◆ preCertificateValidation()

virtual shared_ptr<const Data> ndn::security::Validator::preCertificateValidation ( const Data & data )

inlineprotectedvirtual

Hooks.

trigger before validating requested certificate.

The Data:

matches the interest in the validation-request.
may be certificate or a data encapsulating certificate.

This method returns a data (actually certificate) that is will be passed as Data into: Validator::validate(const Data& data, const OnDataValidated& onValidated, const OnDataValidationFailed& onValidationFailed, int nSteps);

Definition at line 278 of file validator.hpp.

References afterCheckPolicy(), onNack(), and onTimeout().

Referenced by onData().

◆ onNack()

void ndn::security::Validator::onNack	(	const Interest &	interest,
		const lp::Nack &	nack,
		int	nRemainingRetries,
		const OnFailure &	onFailure,
		const shared_ptr< ValidationRequest > &	validationRequest
	)

protectedvirtual

trigger when interest retrieves a Nack.

Validator can decide how to handle a Nack, either call onFailure, or retry.

Parameters

interest	The interest that retrieves a Nack.
nack	The Nack that is retrieved.
nRemainingRetries	The number of retries left.
onFailure	Failure callback when there is no more retries remaining.
validationRequest	The validationRequest containing the context of the interest.

Definition at line 258 of file validator.cpp.

References ndn::Face::expressInterest(), ndn::Interest::getName(), ndn::tlv::Interest, m_face, onData(), onTimeout(), ndn::Interest::refreshNonce(), and ndn::Name::toUri().

Referenced by afterCheckPolicy(), onTimeout(), and preCertificateValidation().

◆ onTimeout()

void ndn::security::Validator::onTimeout	(	const Interest &	interest,
		int	nRemainingRetries,
		const OnFailure &	onFailure,
		const shared_ptr< ValidationRequest > &	validationRequest
	)

protectedvirtual

trigger when interest for certificate times out.

Validator can decide how to handle the timeout, either call onFailure, or retry.

Parameters

interest	The interest that times out.
nRemainingRetries	The number of retries left.
onFailure	Failure callback when there is no more retries remaining.
validationRequest	The validationRequest containing the context of the interest.

Definition at line 282 of file validator.cpp.

References ndn::Face::expressInterest(), ndn::Interest::getName(), ndn::tlv::Interest, m_face, onData(), onNack(), ndn::Interest::refreshNonce(), and ndn::Name::toUri().

Referenced by afterCheckPolicy(), onNack(), and preCertificateValidation().

◆ afterCheckPolicy()

void ndn::security::Validator::afterCheckPolicy	(	const std::vector< shared_ptr< ValidationRequest >> &	nextSteps,
		const OnFailure &	onFailure
	)

protectedvirtual

trigger after checkPolicy is done.

Validator can decide how to handle the set of validation requests according to the trust model.

Parameters

nextSteps	A set of validation request made by checkPolicy.
onFailure	Failure callback when errors happen in processing nextSteps.

Definition at line 305 of file validator.cpp.

References ndn::Face::expressInterest(), m_face, onData(), onNack(), and onTimeout().

Referenced by preCertificateValidation(), and validate().

Member Data Documentation

◆ m_face

Face* ndn::security::Validator::m_face

protected

Definition at line 331 of file validator.hpp.

Referenced by afterCheckPolicy(), onNack(), and onTimeout().

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

ndnSIM/ndn-cxx/src/security/validator.hpp
ndnSIM/ndn-cxx/src/security/validator.cpp

Classes

Public Member Functions

Static Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

◆ OnFailure

Constructor & Destructor Documentation

◆ Validator() [1/2]

◆ Validator() [2/2]

◆ ~Validator()

Member Function Documentation

◆ validate() [1/4]

◆ validate() [2/4]

◆ verifySignature() [1/10]

◆ verifySignature() [2/10]

◆ verifySignature() [3/10]

◆ verifySignature() [4/10]

◆ verifySignature() [5/10]

◆ verifySignature() [6/10]

◆ verifySignature() [7/10]

◆ verifySignature() [8/10]

◆ verifySignature() [9/10]

◆ verifySignature() [10/10]

◆ checkPolicy() [1/2]

◆ checkPolicy() [2/2]

◆ onData()

◆ validate() [3/4]

◆ validate() [4/4]

◆ preCertificateValidation()

◆ onNack()

◆ onTimeout()

◆ afterCheckPolicy()

Member Data Documentation

◆ m_face