AddContentSecurityPolicyEvent.php 2.1 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465
  1. <?php
  2. declare(strict_types=1);
  3. /**
  4. * @copyright Copyright (c) 2019, Roeland Jago Douma <roeland@famdouma.nl>
  5. *
  6. * @author Christoph Wurst <christoph@winzerhof-wurst.at>
  7. * @author Morris Jobke <hey@morrisjobke.de>
  8. * @author Roeland Jago Douma <roeland@famdouma.nl>
  9. *
  10. * @license GNU AGPL version 3 or any later version
  11. *
  12. * This program is free software: you can redistribute it and/or modify
  13. * it under the terms of the GNU Affero General Public License as
  14. * published by the Free Software Foundation, either version 3 of the
  15. * License, or (at your option) any later version.
  16. *
  17. * This program is distributed in the hope that it will be useful,
  18. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  19. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  20. * GNU Affero General Public License for more details.
  21. *
  22. * You should have received a copy of the GNU Affero General Public License
  23. * along with this program. If not, see <http://www.gnu.org/licenses/>.
  24. *
  25. */
  26. namespace OCP\Security\CSP;
  27. use OC\Security\CSP\ContentSecurityPolicyManager;
  28. use OCP\AppFramework\Http\EmptyContentSecurityPolicy;
  29. use OCP\EventDispatcher\Event;
  30. /**
  31. * Allows to inject something into the default content policy. This is for
  32. * example useful when you're injecting Javascript code into a view belonging
  33. * to another controller and cannot modify its Content-Security-Policy itself.
  34. * Note that the adjustment is only applied to applications that use AppFramework
  35. * controllers.
  36. *
  37. * WARNING: Using this API incorrectly may make the instance more insecure.
  38. * Do think twice before adding whitelisting resources. Please do also note
  39. * that it is not possible to use the `disallowXYZ` functions.
  40. *
  41. * @since 17.0.0
  42. */
  43. class AddContentSecurityPolicyEvent extends Event {
  44. /** @var ContentSecurityPolicyManager */
  45. private $policyManager;
  46. /**
  47. * @since 17.0.0
  48. */
  49. public function __construct(ContentSecurityPolicyManager $policyManager) {
  50. parent::__construct();
  51. $this->policyManager = $policyManager;
  52. }
  53. /**
  54. * @since 17.0.0
  55. */
  56. public function addPolicy(EmptyContentSecurityPolicy $csp): void {
  57. $this->policyManager->addDefaultPolicy($csp);
  58. }
  59. }