ndn::security::v2::InterestValidationState Class Reference

Validation state for an interest packet. More...

#include <ndn-cxx/security/validation-state.hpp>

Inheritance diagram for ndn::security::v2::InterestValidationState:

Collaboration diagram for ndn::security::v2::InterestValidationState:

Public Member Functions
	InterestValidationState (const Interest &interest, const InterestValidationSuccessCallback &successCb, const InterestValidationFailureCallback &failureCb)
	Create validation state for interest. More...
	~InterestValidationState () final
	Destructor. More...
void	addCertificate (const Certificate &cert)
	Add cert to the top of the certificate chain. More...
void	fail (const ValidationError &error) final
	Call the failure callback. More...
size_t	getDepth () const noexcept
const Interest &	getOriginalInterest () const
boost::logic::tribool	getOutcome () const noexcept
template<typename T >
shared_ptr< T >	getTag () const
	Get a tag item. More...
bool	hasSeenCertificateName (const Name &certName)
	Check if certName has been previously seen and record the supplied name. More...
template<typename T >
void	removeTag () const
	Remove a tag item. More...
template<typename T >
void	setTag (shared_ptr< T > tag) const
	Set (add or replace) a tag item. More...

Public Attributes
util::Signal< InterestValidationState, Interest >	afterSuccess

Protected Attributes
boost::logic::tribool	m_outcome {boost::logic::indeterminate}

Detailed Description

Validation state for an interest packet.

Definition at line 208 of file validation-state.hpp.

Constructor & Destructor Documentation

InterestValidationState()

ndn::security::v2::InterestValidationState::InterestValidationState	(	const Interest &	interest,
		const InterestValidationSuccessCallback &	successCb,
		const InterestValidationFailureCallback &	failureCb
	)

Create validation state for interest.

The caller must ensure that state instance is valid until validation finishes (i.e., until after validateCertificateChain() and validateOriginalPacket() are called)

Definition at line 128 of file validation-state.cpp.

~InterestValidationState()

ndn::security::v2::InterestValidationState::~InterestValidationState ( )

final

Destructor.

If neither success callback nor failure callback was called, the destructor will call failure callback with IMPLEMENTATION_ERROR error code.

Definition at line 139 of file validation-state.cpp.

Member Function Documentation

addCertificate()

void ndn::security::v2::ValidationState::addCertificate ( const Certificate &  cert )

inherited

Add cert to the top of the certificate chain.

If m_certificateChain is empty, cert should be the signer of the original packet. If m_certificateChain is not empty, cert should be the signer of m_certificateChain.front().

Postcondition

m_certificateChain.front() == cert

Note

This function does not verify the signature bits.

Definition at line 49 of file validation-state.cpp.

fail()

void ndn::security::v2::InterestValidationState::fail ( const ValidationError &  error )

finalvirtual

Call the failure callback.

Implements ndn::security::v2::ValidationState.

Definition at line 171 of file validation-state.cpp.

getDepth()

size_t ndn::security::v2::ValidationState::getDepth ( ) const

inlinenoexceptinherited

Returns

Depth of certificate chain

Definition at line 81 of file validation-state.hpp.

getOriginalInterest()

const Interest& ndn::security::v2::InterestValidationState::getOriginalInterest ( ) const

inline

Returns

Original interest being validated

Definition at line 236 of file validation-state.hpp.

getOutcome()

boost::logic::tribool ndn::security::v2::ValidationState::getOutcome ( ) const

inlinenoexceptinherited

Definition at line 66 of file validation-state.hpp.

getTag()

template<typename T >

shared_ptr< T > ndn::TagHost::getTag

inherited

Get a tag item.

Template Parameters

T	type of the tag, which must be a subclass of ndn::Tag

Return values

nullptr

if no Tag of type T is stored

Definition at line 67 of file tag-host.hpp.

hasSeenCertificateName()

bool ndn::security::v2::ValidationState::hasSeenCertificateName ( const Name &  certName )

inherited

Check if certName has been previously seen and record the supplied name.

Definition at line 43 of file validation-state.cpp.

removeTag()

template<typename T >

void ndn::TagHost::removeTag

inherited

Remove a tag item.

Note

Tag can be removed even on a const tag host instance

Definition at line 94 of file tag-host.hpp.

setTag()

template<typename T >

void ndn::TagHost::setTag ( shared_ptr< T >  tag ) const

inherited

Set (add or replace) a tag item.

Template Parameters

T	type of the tag, which must be a subclass of ndn::Tag

Note

Tag can be set even on a const tag host instance

Definition at line 80 of file tag-host.hpp.

Member Data Documentation

afterSuccess

util::Signal<InterestValidationState, Interest> ndn::security::v2::InterestValidationState::afterSuccess

Definition at line 242 of file validation-state.hpp.

m_outcome

boost::logic::tribool ndn::security::v2::ValidationState::m_outcome {boost::logic::indeterminate}

protectedinherited

Definition at line 140 of file validation-state.hpp.