TYPO3 v15 dev-main snapshot ()

Classes/Security/Exception.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the TYPO3 CMS project.
+ *
+ * It is free software; you can redistribute it and/or modify it under
+ * the terms of the GNU General Public License, either version 2
+ * of the License, or any later version.
+ *
+ * For the full copyright and license information, please read the
+ * LICENSE.txt file that was distributed with this source code.
+ *
+ * The TYPO3 project - inspiring people to share!
+ */
+
+namespace TYPO3\CMS\Extbase\Security;
+
+use TYPO3\CMS\Extbase\Exception as ExtbaseException;
+
+class Exception extends ExtbaseException {}

Classes/Security/Exception/InvalidArgumentForHashGenerationException.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the TYPO3 CMS project.
+ *
+ * It is free software; you can redistribute it and/or modify it under
+ * the terms of the GNU General Public License, either version 2
+ * of the License, or any later version.
+ *
+ * For the full copyright and license information, please read the
+ * LICENSE.txt file that was distributed with this source code.
+ *
+ * The TYPO3 project - inspiring people to share!
+ */
+
+namespace TYPO3\CMS\Extbase\Security\Exception;
+
+use TYPO3\CMS\Extbase\Security\Exception;
+
+/**
+ * An "InvalidArgumentForHashGeneration" exception
+ */
+class InvalidArgumentForHashGenerationException extends Exception {}

Classes/Security/Exception/InvalidHashException.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the TYPO3 CMS project.
+ *
+ * It is free software; you can redistribute it and/or modify it under
+ * the terms of the GNU General Public License, either version 2
+ * of the License, or any later version.
+ *
+ * For the full copyright and license information, please read the
+ * LICENSE.txt file that was distributed with this source code.
+ *
+ * The TYPO3 project - inspiring people to share!
+ */
+
+namespace TYPO3\CMS\Extbase\Security\Exception;
+
+use TYPO3\CMS\Extbase\Security\Exception;
+
+/**
+ * A "InvalidHash" Exception, thrown when a HMAC validation failed.
+ */
+class InvalidHashException extends Exception {}

Classes/Security/HashScope.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the TYPO3 CMS project.
+ *
+ * It is free software; you can redistribute it and/or modify it under
+ * the terms of the GNU General Public License, either version 2
+ * of the License, or any later version.
+ *
+ * For the full copyright and license information, please read the
+ * LICENSE.txt file that was distributed with this source code.
+ *
+ * The TYPO3 project - inspiring people to share!
+ */
+
+namespace TYPO3\CMS\Extbase\Security;
+
+/**
+ * Contains Extbase-specific scopes to be used as additional secret for HMACs.
+ * @internal
+ */
+enum HashScope: string
+{
+    case ReferringRequest = '@request';
+    case ReferringArguments = 'arguments';
+    case TrustedProperties = '__trustedProperties';
+
+    /**
+     * @return non-empty-string
+     */
+    public function prefix(): string
+    {
+        return self::class . '::' . $this->value;
+    }
+}