cleaned up composer

2026-02-18 20:17:19 -06:00
parent 3c94239da7
commit 3e153679bd
5952 changed files with 271417 additions and 203117 deletions
@@ -0,0 +1,34 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Jose\Component\Encryption\Algorithm\ContentEncryption;
+
+use Override;
+
+final readonly class A128CBCHS256 extends AESCBCHS
+{
+    #[Override]
+    public function getCEKSize(): int
+    {
+        return 256;
+    }
+
+    #[Override]
+    public function name(): string
+    {
+        return 'A128CBC-HS256';
+    }
+
+    #[Override]
+    protected function getHashAlgorithm(): string
+    {
+        return 'sha256';
+    }
+
+    #[Override]
+    protected function getMode(): string
+    {
+        return 'aes-128-cbc';
+    }
+}
@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Jose\Component\Encryption\Algorithm\ContentEncryption;
+
+use Override;
+
+final readonly class A128GCM extends AESGCM
+{
+    #[Override]
+    public function getCEKSize(): int
+    {
+        return 128;
+    }
+
+    #[Override]
+    public function name(): string
+    {
+        return 'A128GCM';
+    }
+
+    #[Override]
+    protected function getMode(): string
+    {
+        return 'aes-128-gcm';
+    }
+}
@@ -0,0 +1,34 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Jose\Component\Encryption\Algorithm\ContentEncryption;
+
+use Override;
+
+final readonly class A192CBCHS384 extends AESCBCHS
+{
+    #[Override]
+    public function getCEKSize(): int
+    {
+        return 384;
+    }
+
+    #[Override]
+    public function name(): string
+    {
+        return 'A192CBC-HS384';
+    }
+
+    #[Override]
+    protected function getHashAlgorithm(): string
+    {
+        return 'sha384';
+    }
+
+    #[Override]
+    protected function getMode(): string
+    {
+        return 'aes-192-cbc';
+    }
+}
@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Jose\Component\Encryption\Algorithm\ContentEncryption;
+
+use Override;
+
+final readonly class A192GCM extends AESGCM
+{
+    #[Override]
+    public function getCEKSize(): int
+    {
+        return 192;
+    }
+
+    #[Override]
+    public function name(): string
+    {
+        return 'A192GCM';
+    }
+
+    #[Override]
+    protected function getMode(): string
+    {
+        return 'aes-192-gcm';
+    }
+}
@@ -0,0 +1,34 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Jose\Component\Encryption\Algorithm\ContentEncryption;
+
+use Override;
+
+final readonly class A256CBCHS512 extends AESCBCHS
+{
+    #[Override]
+    public function getCEKSize(): int
+    {
+        return 512;
+    }
+
+    #[Override]
+    public function name(): string
+    {
+        return 'A256CBC-HS512';
+    }
+
+    #[Override]
+    protected function getHashAlgorithm(): string
+    {
+        return 'sha512';
+    }
+
+    #[Override]
+    protected function getMode(): string
+    {
+        return 'aes-256-cbc';
+    }
+}
@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Jose\Component\Encryption\Algorithm\ContentEncryption;
+
+use Override;
+
+final readonly class A256GCM extends AESGCM
+{
+    #[Override]
+    public function getCEKSize(): int
+    {
+        return 256;
+    }
+
+    #[Override]
+    public function name(): string
+    {
+        return 'A256GCM';
+    }
+
+    #[Override]
+    protected function getMode(): string
+    {
+        return 'aes-256-gcm';
+    }
+}
@@ -0,0 +1,120 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Jose\Component\Encryption\Algorithm\ContentEncryption;
+
+use Jose\Component\Core\Util\Base64UrlSafe;
+use Jose\Component\Encryption\Algorithm\ContentEncryptionAlgorithm;
+use Override;
+use RuntimeException;
+use function extension_loaded;
+use function strlen;
+use const OPENSSL_RAW_DATA;
+
+abstract readonly class AESCBCHS implements ContentEncryptionAlgorithm
+{
+    public function __construct()
+    {
+        if (! extension_loaded('openssl')) {
+            throw new RuntimeException('Please install the OpenSSL extension');
+        }
+    }
+
+    #[Override]
+    public function allowedKeyTypes(): array
+    {
+        return []; //Irrelevant
+    }
+
+    #[Override]
+    public function encryptContent(
+        string $data,
+        string $cek,
+        string $iv,
+        ?string $aad,
+        string $encoded_protected_header,
+        ?string &$tag = null
+    ): string {
+        $k = substr($cek, $this->getCEKSize() / 16);
+        $result = openssl_encrypt($data, $this->getMode(), $k, OPENSSL_RAW_DATA, $iv);
+        if ($result === false) {
+            throw new RuntimeException('Unable to encrypt the content');
+        }
+
+        $tag = $this->calculateAuthenticationTag($result, $cek, $iv, $aad, $encoded_protected_header);
+
+        return $result;
+    }
+
+    #[Override]
+    public function decryptContent(
+        string $data,
+        string $cek,
+        string $iv,
+        ?string $aad,
+        string $encoded_protected_header,
+        string $tag
+    ): string {
+        if (! $this->isTagValid($data, $cek, $iv, $aad, $encoded_protected_header, $tag)) {
+            throw new RuntimeException('Unable to decrypt or to verify the tag.');
+        }
+        $k = substr($cek, $this->getCEKSize() / 16);
+
+        $result = openssl_decrypt($data, $this->getMode(), $k, OPENSSL_RAW_DATA, $iv);
+        if ($result === false) {
+            throw new RuntimeException('Unable to decrypt or to verify the tag.');
+        }
+
+        return $result;
+    }
+
+    #[Override]
+    public function getIVSize(): int
+    {
+        return 128;
+    }
+
+    protected function calculateAuthenticationTag(
+        string $encrypted_data,
+        string $cek,
+        string $iv,
+        ?string $aad,
+        string $encoded_header
+    ): string {
+        $calculated_aad = $encoded_header;
+        if ($aad !== null) {
+            $calculated_aad .= '.' . Base64UrlSafe::encodeUnpadded($aad);
+        }
+        $mac_key = substr($cek, 0, $this->getCEKSize() / 16);
+        $auth_data_length = strlen($encoded_header);
+
+        $secured_input = implode('', [
+            $calculated_aad,
+            $iv,
+            $encrypted_data,
+            pack('N2', ($auth_data_length / 2_147_483_647) * 8, ($auth_data_length % 2_147_483_647) * 8),
+        ]);
+        $hash = hash_hmac($this->getHashAlgorithm(), $secured_input, $mac_key, true);
+
+        return substr($hash, 0, strlen($hash) / 2);
+    }
+
+    protected function isTagValid(
+        string $encrypted_data,
+        string $cek,
+        string $iv,
+        ?string $aad,
+        string $encoded_header,
+        string $authentication_tag
+    ): bool {
+        return hash_equals(
+            $authentication_tag,
+            $this->calculateAuthenticationTag($encrypted_data, $cek, $iv, $aad, $encoded_header)
+        );
+    }
+
+    abstract protected function getHashAlgorithm(): string;
+
+    abstract protected function getMode(): string;
+}
@@ -0,0 +1,80 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Jose\Component\Encryption\Algorithm\ContentEncryption;
+
+use Jose\Component\Core\Util\Base64UrlSafe;
+use Jose\Component\Encryption\Algorithm\ContentEncryptionAlgorithm;
+use Override;
+use RuntimeException;
+use function extension_loaded;
+use const OPENSSL_RAW_DATA;
+
+abstract readonly class AESGCM implements ContentEncryptionAlgorithm
+{
+    public function __construct()
+    {
+        if (! extension_loaded('openssl')) {
+            throw new RuntimeException('Please install the OpenSSL extension');
+        }
+    }
+
+    #[Override]
+    public function allowedKeyTypes(): array
+    {
+        return []; //Irrelevant
+    }
+
+    #[Override]
+    public function encryptContent(
+        string $data,
+        string $cek,
+        string $iv,
+        ?string $aad,
+        string $encoded_protected_header,
+        ?string &$tag = null
+    ): string {
+        $calculated_aad = $encoded_protected_header;
+        if ($aad !== null) {
+            $calculated_aad .= '.' . Base64UrlSafe::encodeUnpadded($aad);
+        }
+        $tag = '';
+        $result = openssl_encrypt($data, $this->getMode(), $cek, OPENSSL_RAW_DATA, $iv, $tag, $calculated_aad);
+        if ($result === false) {
+            throw new RuntimeException('Unable to encrypt the content');
+        }
+
+        return $result;
+    }
+
+    #[Override]
+    public function decryptContent(
+        string $data,
+        string $cek,
+        string $iv,
+        ?string $aad,
+        string $encoded_protected_header,
+        string $tag
+    ): string {
+        $calculated_aad = $encoded_protected_header;
+        if ($aad !== null) {
+            $calculated_aad .= '.' . Base64UrlSafe::encodeUnpadded($aad);
+        }
+
+        $result = openssl_decrypt($data, $this->getMode(), $cek, OPENSSL_RAW_DATA, $iv, $tag, $calculated_aad);
+        if ($result === false) {
+            throw new RuntimeException('Unable to decrypt the content');
+        }
+
+        return $result;
+    }
+
+    #[Override]
+    public function getIVSize(): int
+    {
+        return 96;
+    }
+
+    abstract protected function getMode(): string;
+}