Source: security/validator-config.js

  1. /**
  2.  * Copyright (C) 2018 Regents of the University of California.
  3.  * @author: Jeff Thompson <jefft0@remap.ucla.edu>
  4.  * @author: From ndn-cxx security https://github.com/named-data/ndn-cxx/blob/master/src/security/validator-config.cpp
  5.  *
  6.  * This program is free software: you can redistribute it and/or modify
  7.  * it under the terms of the GNU Lesser General Public License as published by
  8.  * the Free Software Foundation, either version 3 of the License, or
  9.  * (at your option) any later version.
  10.  *
  11.  * This program is distributed in the hope that it will be useful,
  12.  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14.  * GNU Lesser General Public License for more details.
  15.  *
  16.  * You should have received a copy of the GNU Lesser General Public License
  17.  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  18.  * A copy of the GNU Lesser General Public License is in the file COPYING.
  19.  */
  21. /** @ignore */
  22. var CertificateFetcher = require('./v2/certificate-fetcher.js').CertificateFetcher; /** @ignore */
  23. var ValidationPolicyConfig = require('./v2/validation-policy-config.js').ValidationPolicyConfig; /** @ignore */
  24. var CertificateFetcherFromNetwork = require('./v2/certificate-fetcher-from-network.js').CertificateFetcherFromNetwork; /** @ignore */
  25. var Validator = require('./v2/validator.js').Validator;
  27. /**
  28.  * ValidatorConfig extends Validator to implements a validator which can be
  29.  * set up via a configuration file.
  30.  *
  31.  * The constructor has two forms:
  32.  * ValidatorConfig(fetcher) - Create a ValidatorConfig that uses the given
  33.  * certificate fetcher.
  34.  * ValidatorConfig(face) - Create a ValidatorConfig that uses a
  35.  * CertificateFetcherFromNetwork for the given Face.
  36.  * @param {CertificateFetcher} fetcher the certificate fetcher to use.
  37.  * @param {Face} face The face for the certificate fetcher to call
  38.  * expressInterest.
  39.  * @constructor
  40.  */
  41. var ValidatorConfig = function ValidatorConfig(fetcherOrFace)
  42. {
  43.   if (fetcherOrFace instanceof CertificateFetcher) {
  44.     // Call the base constructor.
  45.     Validator.call(this, new ValidationPolicyConfig(), fetcherOrFace);
  46.     // TODO: Use getInnerPolicy().
  47.     this.policyConfig_ = this.getPolicy();
  48.   }
  49.   else {
  50.     // Call the base constructor.
  51.     Validator.call
  52.       (this, new ValidationPolicyConfig(),
  53.        new CertificateFetcherFromNetwork(fetcherOrFace));
  54.     // TODO: Use getInnerPolicy().
  55.     this.policyConfig_ = this.getPolicy();
  56.   }
  57. };
  59. ValidatorConfig.prototype = new Validator
  60.   (new ValidationPolicyConfig(), new CertificateFetcherFromNetwork(null));
  61. ValidatorConfig.prototype.name = "ValidatorConfig";
  63. exports.ValidatorConfig = ValidatorConfig;
  65. /**
  66.  * There are three forms of load:
  67.  * load(filePath) - Load the configuration from the given config file.
  68.  * load(input, inputName) - Load the configuration from the given input string.
  69.  * load(configSection, inputName) - Load the configuration from the given
  70.  * configSection.
  71.  * Each of these forms of load replaces any existing configuration.
  72.  * @param {String} filePath The The path of the config file.
  73.  * @param {String} input The contents of the configuration rules, with lines
  74.  * separated by "\n" or "\r\n".
  75.  * @param {BoostInfoTree} The configuration section loaded from the config file.
  76.  * It should have one "validator" section.
  77.  * @param {String} inputName Used for log messages, etc.
  78.  */
  79. ValidatorConfig.prototype.load = function
  80.   (filePathOrInputOrConfigSection, inputName)
  81. {
  82.   this.policyConfig_.load(filePathOrInputOrConfigSection, inputName);
  83. };