Abstraction that implements a validation policy for Interest and Data packets. More...
#include <ndn-cxx/security/validation-policy.hpp>
Public Types | |
using | ValidationContinuation = std::function< void(const shared_ptr< CertificateRequest > &certRequest, const shared_ptr< ValidationState > &state)> |
Public Member Functions | |
virtual | ~ValidationPolicy ()=default |
virtual void | checkPolicy (const Certificate &certificate, const shared_ptr< ValidationState > &state, const ValidationContinuation &continueValidation) |
Check certificate against the policy. More... | |
virtual void | checkPolicy (const Data &data, const shared_ptr< ValidationState > &state, const ValidationContinuation &continueValidation)=0 |
Check data against the policy. More... | |
virtual void | checkPolicy (const Interest &interest, const shared_ptr< ValidationState > &state, const ValidationContinuation &continueValidation)=0 |
Check interest against the policy. More... | |
ValidationPolicy & | getInnerPolicy () |
Return the inner policy. More... | |
bool | hasInnerPolicy () const |
Check if inner policy is set. More... | |
void | setInnerPolicy (unique_ptr< ValidationPolicy > innerPolicy) |
Set inner policy. More... | |
void | setValidator (Validator &validator) |
Set validator to which the policy is associated. More... | |
Protected Attributes | |
unique_ptr< ValidationPolicy > | m_innerPolicy |
Validator * | m_validator = nullptr |
Abstraction that implements a validation policy for Interest and Data packets.
Definition at line 37 of file validation-policy.hpp.
using ndn::security::v2::ValidationPolicy::ValidationContinuation = std::function<void(const shared_ptr<CertificateRequest>& certRequest, const shared_ptr<ValidationState>& state)> |
Definition at line 40 of file validation-policy.hpp.
|
virtualdefault |
|
inlinevirtual |
Check certificate
against the policy.
Unless overridden by the policy, this check defaults to checkPolicy(const Data&, ...)
.
Depending on implementation of the policy, this check can be done synchronously or asynchronously.
Semantics of checkPolicy has changed from v1::Validator
state->fail
with appropriate error code and error description.Definition at line 139 of file validation-policy.hpp.
|
pure virtual |
Check data
against the policy.
Depending on implementation of the policy, this check can be done synchronously or asynchronously.
Semantics of checkPolicy has changed from v1::Validator
state->fail
with appropriate error code and error description.Implemented in ndn::security::v2::ValidationPolicySimpleHierarchy, ndn::security::v2::ValidationPolicySignedInterest, ndn::security::v2::validator_config::ValidationPolicyConfig, ndn::security::v2::ValidationPolicyCommandInterest, and ndn::security::v2::ValidationPolicyAcceptAll.
|
pure virtual |
Check interest
against the policy.
Depending on implementation of the policy, this check can be done synchronously or asynchronously.
Semantics of checkPolicy has changed from v1::Validator
state->fail
with appropriate error code and error description.Implemented in ndn::security::v2::ValidationPolicySimpleHierarchy, ndn::security::v2::ValidationPolicySignedInterest, ndn::security::v2::validator_config::ValidationPolicyConfig, ndn::security::v2::ValidationPolicyCommandInterest, and ndn::security::v2::ValidationPolicyAcceptAll.
ValidationPolicy & ndn::security::v2::ValidationPolicy::getInnerPolicy | ( | ) |
Return the inner policy.
If the inner policy was not set, behavior is undefined.
Definition at line 49 of file validation-policy.cpp.
|
inline |
Check if inner policy is set.
Definition at line 67 of file validation-policy.hpp.
void ndn::security::v2::ValidationPolicy::setInnerPolicy | ( | unique_ptr< ValidationPolicy > | innerPolicy | ) |
Set inner policy.
Multiple assignments of the inner policy will create a "chain" of linked policies. The inner policy from the latest invocation of setInnerPolicy will be at the bottom of the policy list.
For example, sequence of this->setInnerPolicy(policy1)
and this->setInnerPolicy(policy2)
, will result in this->m_innerPolicy == policy1
, this->m_innerPolicy->m_innerPolicy == policy2', and this->m_innerPolicy->m_innerPolicy->m_innerPolicy == nullptr
.
std::invalid_argument | exception, if innerPolicy is nullptr. |
Definition at line 30 of file validation-policy.cpp.
void ndn::security::v2::ValidationPolicy::setValidator | ( | Validator & | validator | ) |
Set validator to which the policy is associated.
Definition at line 55 of file validation-policy.cpp.
|
protected |
Definition at line 147 of file validation-policy.hpp.
|
protected |
Definition at line 146 of file validation-policy.hpp.