keyEncryptionAlgorithmManager = $keyEncryptionAlgorithmManager; $this->contentEncryptionAlgorithmManager = $contentEncryptionAlgorithmManager; $this->compressionManager = $compressionManager; } /** * Reset the current data. * * @return JWEBuilder */ public function create(): self { $this->payload = null; $this->aad = null; $this->recipients = []; $this->sharedProtectedHeader = []; $this->sharedHeader = []; $this->compressionMethod = null; $this->contentEncryptionAlgorithm = null; $this->keyManagementMode = null; return $this; } /** * Returns the key encryption algorithm manager. */ public function getKeyEncryptionAlgorithmManager(): AlgorithmManager { return $this->keyEncryptionAlgorithmManager; } /** * Returns the content encryption algorithm manager. */ public function getContentEncryptionAlgorithmManager(): AlgorithmManager { return $this->contentEncryptionAlgorithmManager; } /** * Returns the compression method manager. */ public function getCompressionMethodManager(): CompressionMethodManager { return $this->compressionManager; } /** * Set the payload of the JWE to build. * * @throws InvalidArgumentException if the payload is not encoded in UTF-8 * * @return JWEBuilder */ public function withPayload(string $payload): self { if ('UTF-8' !== mb_detect_encoding($payload, 'UTF-8', true)) { throw new InvalidArgumentException('The payload must be encoded in UTF-8'); } $clone = clone $this; $clone->payload = $payload; return $clone; } /** * Set the Additional Authenticated Data of the JWE to build. * * @return JWEBuilder */ public function withAAD(?string $aad): self { $clone = clone $this; $clone->aad = $aad; return $clone; } /** * Set the shared protected header of the JWE to build. * * @return JWEBuilder */ public function withSharedProtectedHeader(array $sharedProtectedHeader): self { $this->checkDuplicatedHeaderParameters($sharedProtectedHeader, $this->sharedHeader); foreach ($this->recipients as $recipient) { $this->checkDuplicatedHeaderParameters($sharedProtectedHeader, $recipient->getHeader()); } $clone = clone $this; $clone->sharedProtectedHeader = $sharedProtectedHeader; return $clone; } /** * Set the shared header of the JWE to build. * * @return JWEBuilder */ public function withSharedHeader(array $sharedHeader): self { $this->checkDuplicatedHeaderParameters($this->sharedProtectedHeader, $sharedHeader); foreach ($this->recipients as $recipient) { $this->checkDuplicatedHeaderParameters($sharedHeader, $recipient->getHeader()); } $clone = clone $this; $clone->sharedHeader = $sharedHeader; return $clone; } /** * Adds a recipient to the JWE to build. * * @throws InvalidArgumentException if key management modes are incompatible * @throws InvalidArgumentException if the compression method is invalid * * @return JWEBuilder */ public function addRecipient(JWK $recipientKey, array $recipientHeader = []): self { $this->checkDuplicatedHeaderParameters($this->sharedProtectedHeader, $recipientHeader); $this->checkDuplicatedHeaderParameters($this->sharedHeader, $recipientHeader); $clone = clone $this; $completeHeader = array_merge($clone->sharedHeader, $recipientHeader, $clone->sharedProtectedHeader); $clone->checkAndSetContentEncryptionAlgorithm($completeHeader); $keyEncryptionAlgorithm = $clone->getKeyEncryptionAlgorithm($completeHeader); if (null === $clone->keyManagementMode) { $clone->keyManagementMode = $keyEncryptionAlgorithm->getKeyManagementMode(); } else { if (!$clone->areKeyManagementModesCompatible($clone->keyManagementMode, $keyEncryptionAlgorithm->getKeyManagementMode())) { throw new InvalidArgumentException('Foreign key management mode forbidden.'); } } $compressionMethod = $clone->getCompressionMethod($completeHeader); if (null !== $compressionMethod) { if (null === $clone->compressionMethod) { $clone->compressionMethod = $compressionMethod; } elseif ($clone->compressionMethod->name() !== $compressionMethod->name()) { throw new InvalidArgumentException('Incompatible compression method.'); } } if (null === $compressionMethod && null !== $clone->compressionMethod) { throw new InvalidArgumentException('Inconsistent compression method.'); } $clone->checkKey($keyEncryptionAlgorithm, $recipientKey); $clone->recipients[] = [ 'key' => $recipientKey, 'header' => $recipientHeader, 'key_encryption_algorithm' => $keyEncryptionAlgorithm, ]; return $clone; } /** * Builds the JWE. * * @throws LogicException if no payload is set * @throws LogicException if there are no recipient */ public function build(): JWE { if (null === $this->payload) { throw new LogicException('Payload not set.'); } if (0 === count($this->recipients)) { throw new LogicException('No recipient.'); } $additionalHeader = []; $cek = $this->determineCEK($additionalHeader); $recipients = []; foreach ($this->recipients as $recipient) { $recipient = $this->processRecipient($recipient, $cek, $additionalHeader); $recipients[] = $recipient; } if (0 !== count($additionalHeader) && 1 === count($this->recipients)) { $sharedProtectedHeader = array_merge($additionalHeader, $this->sharedProtectedHeader); } else { $sharedProtectedHeader = $this->sharedProtectedHeader; } $encodedSharedProtectedHeader = 0 === count($sharedProtectedHeader) ? '' : Base64Url::encode(JsonConverter::encode($sharedProtectedHeader)); list($ciphertext, $iv, $tag) = $this->encryptJWE($cek, $encodedSharedProtectedHeader); return new JWE($ciphertext, $iv, $tag, $this->aad, $this->sharedHeader, $sharedProtectedHeader, $encodedSharedProtectedHeader, $recipients); } /** * @throws InvalidArgumentException if the content encryption algorithm is not valid */ private function checkAndSetContentEncryptionAlgorithm(array $completeHeader): void { $contentEncryptionAlgorithm = $this->getContentEncryptionAlgorithm($completeHeader); if (null === $this->contentEncryptionAlgorithm) { $this->contentEncryptionAlgorithm = $contentEncryptionAlgorithm; } elseif ($contentEncryptionAlgorithm->name() !== $this->contentEncryptionAlgorithm->name()) { throw new InvalidArgumentException('Inconsistent content encryption algorithm'); } } /** * @throws InvalidArgumentException if the key encryption algorithm is not valid */ private function processRecipient(array $recipient, string $cek, array &$additionalHeader): Recipient { $completeHeader = array_merge($this->sharedHeader, $recipient['header'], $this->sharedProtectedHeader); $keyEncryptionAlgorithm = $recipient['key_encryption_algorithm']; if (!$keyEncryptionAlgorithm instanceof KeyEncryptionAlgorithm) { throw new InvalidArgumentException('The key encryption algorithm is not valid'); } $encryptedContentEncryptionKey = $this->getEncryptedKey($completeHeader, $cek, $keyEncryptionAlgorithm, $additionalHeader, $recipient['key'], $recipient['sender_key'] ?? null); $recipientHeader = $recipient['header']; if (0 !== count($additionalHeader) && 1 !== count($this->recipients)) { $recipientHeader = array_merge($recipientHeader, $additionalHeader); $additionalHeader = []; } return new Recipient($recipientHeader, $encryptedContentEncryptionKey); } /** * @throws InvalidArgumentException if the content encryption algorithm is not valid */ private function encryptJWE(string $cek, string $encodedSharedProtectedHeader): array { if (!$this->contentEncryptionAlgorithm instanceof ContentEncryptionAlgorithm) { throw new InvalidArgumentException('The content encryption algorithm is not valid'); } $iv_size = $this->contentEncryptionAlgorithm->getIVSize(); $iv = $this->createIV($iv_size); $payload = $this->preparePayload(); $tag = null; $ciphertext = $this->contentEncryptionAlgorithm->encryptContent($payload, $cek, $iv, $this->aad, $encodedSharedProtectedHeader, $tag); return [$ciphertext, $iv, $tag]; } /** * @return string */ private function preparePayload(): ?string { $prepared = $this->payload; if (null === $this->compressionMethod) { return $prepared; } return $this->compressionMethod->compress($prepared); } /** * @throws InvalidArgumentException if the key encryption algorithm is not supported */ private function getEncryptedKey(array $completeHeader, string $cek, KeyEncryptionAlgorithm $keyEncryptionAlgorithm, array &$additionalHeader, JWK $recipientKey, ?JWK $senderKey): ?string { if ($keyEncryptionAlgorithm instanceof KeyEncryption) { return $this->getEncryptedKeyFromKeyEncryptionAlgorithm($completeHeader, $cek, $keyEncryptionAlgorithm, $recipientKey, $additionalHeader); } if ($keyEncryptionAlgorithm instanceof KeyWrapping) { return $this->getEncryptedKeyFromKeyWrappingAlgorithm($completeHeader, $cek, $keyEncryptionAlgorithm, $recipientKey, $additionalHeader); } if ($keyEncryptionAlgorithm instanceof KeyAgreementWithKeyWrapping) { return $this->getEncryptedKeyFromKeyAgreementAndKeyWrappingAlgorithm($completeHeader, $cek, $keyEncryptionAlgorithm, $additionalHeader, $recipientKey, $senderKey); } if ($keyEncryptionAlgorithm instanceof KeyAgreement) { return null; } if ($keyEncryptionAlgorithm instanceof DirectEncryption) { return null; } throw new InvalidArgumentException('Unsupported key encryption algorithm.'); } /** * @throws InvalidArgumentException if the content encryption algorithm is invalid */ private function getEncryptedKeyFromKeyAgreementAndKeyWrappingAlgorithm(array $completeHeader, string $cek, KeyAgreementWithKeyWrapping $keyEncryptionAlgorithm, array &$additionalHeader, JWK $recipientKey, ?JWK $senderKey): string { if (null === $this->contentEncryptionAlgorithm) { throw new InvalidArgumentException('Invalid content encryption algorithm'); } return $keyEncryptionAlgorithm->wrapAgreementKey($recipientKey, $senderKey, $cek, $this->contentEncryptionAlgorithm->getCEKSize(), $completeHeader, $additionalHeader); } private function getEncryptedKeyFromKeyEncryptionAlgorithm(array $completeHeader, string $cek, KeyEncryption $keyEncryptionAlgorithm, JWK $recipientKey, array &$additionalHeader): string { return $keyEncryptionAlgorithm->encryptKey($recipientKey, $cek, $completeHeader, $additionalHeader); } private function getEncryptedKeyFromKeyWrappingAlgorithm(array $completeHeader, string $cek, KeyWrapping $keyEncryptionAlgorithm, JWK $recipientKey, array &$additionalHeader): string { return $keyEncryptionAlgorithm->wrapKey($recipientKey, $cek, $completeHeader, $additionalHeader); } /** * @throws InvalidArgumentException if the content encryption algorithm is invalid * @throws InvalidArgumentException if the key type is not valid * @throws InvalidArgumentException if the key management mode is not supported */ private function checkKey(KeyEncryptionAlgorithm $keyEncryptionAlgorithm, JWK $recipientKey): void { if (null === $this->contentEncryptionAlgorithm) { throw new InvalidArgumentException('Invalid content encryption algorithm'); } KeyChecker::checkKeyUsage($recipientKey, 'encryption'); if ('dir' !== $keyEncryptionAlgorithm->name()) { KeyChecker::checkKeyAlgorithm($recipientKey, $keyEncryptionAlgorithm->name()); } else { KeyChecker::checkKeyAlgorithm($recipientKey, $this->contentEncryptionAlgorithm->name()); } } private function determineCEK(array &$additionalHeader): string { if (null === $this->contentEncryptionAlgorithm) { throw new InvalidArgumentException('Invalid content encryption algorithm'); } switch ($this->keyManagementMode) { case KeyEncryption::MODE_ENCRYPT: case KeyEncryption::MODE_WRAP: return $this->createCEK($this->contentEncryptionAlgorithm->getCEKSize()); case KeyEncryption::MODE_AGREEMENT: if (1 !== count($this->recipients)) { throw new LogicException('Unable to encrypt for multiple recipients using key agreement algorithms.'); } /** @var JWK $key */ $recipientKey = $this->recipients[0]['key']; $senderKey = $this->recipients[0]['sender_key'] ?? null; $algorithm = $this->recipients[0]['key_encryption_algorithm']; if (!$algorithm instanceof KeyAgreement) { throw new InvalidArgumentException('Invalid content encryption algorithm'); } $completeHeader = array_merge($this->sharedHeader, $this->recipients[0]['header'], $this->sharedProtectedHeader); return $algorithm->getAgreementKey($this->contentEncryptionAlgorithm->getCEKSize(), $this->contentEncryptionAlgorithm->name(), $recipientKey, $senderKey, $completeHeader, $additionalHeader); case KeyEncryption::MODE_DIRECT: if (1 !== count($this->recipients)) { throw new LogicException('Unable to encrypt for multiple recipients using key agreement algorithms.'); } /** @var JWK $key */ $key = $this->recipients[0]['key']; if ('oct' !== $key->get('kty')) { throw new RuntimeException('Wrong key type.'); } return Base64Url::decode($key->get('k')); default: throw new InvalidArgumentException(sprintf('Unsupported key management mode "%s".', $this->keyManagementMode)); } } private function getCompressionMethod(array $completeHeader): ?CompressionMethod { if (!array_key_exists('zip', $completeHeader)) { return null; } return $this->compressionManager->get($completeHeader['zip']); } private function areKeyManagementModesCompatible(string $current, string $new): bool { $agree = KeyEncryptionAlgorithm::MODE_AGREEMENT; $dir = KeyEncryptionAlgorithm::MODE_DIRECT; $enc = KeyEncryptionAlgorithm::MODE_ENCRYPT; $wrap = KeyEncryptionAlgorithm::MODE_WRAP; $supportedKeyManagementModeCombinations = [$enc.$enc => true, $enc.$wrap => true, $wrap.$enc => true, $wrap.$wrap => true, $agree.$agree => false, $agree.$dir => false, $agree.$enc => false, $agree.$wrap => false, $dir.$agree => false, $dir.$dir => false, $dir.$enc => false, $dir.$wrap => false, $enc.$agree => false, $enc.$dir => false, $wrap.$agree => false, $wrap.$dir => false]; if (array_key_exists($current.$new, $supportedKeyManagementModeCombinations)) { return $supportedKeyManagementModeCombinations[$current.$new]; } return false; } private function createCEK(int $size): string { return random_bytes($size / 8); } private function createIV(int $size): string { return random_bytes($size / 8); } /** * @throws InvalidArgumentException if the header parameter "alg" is missing * @throws InvalidArgumentException if the header parameter "alg" is not supported or not a key encryption algorithm */ private function getKeyEncryptionAlgorithm(array $completeHeader): KeyEncryptionAlgorithm { if (!isset($completeHeader['alg'])) { throw new InvalidArgumentException('Parameter "alg" is missing.'); } $keyEncryptionAlgorithm = $this->keyEncryptionAlgorithmManager->get($completeHeader['alg']); if (!$keyEncryptionAlgorithm instanceof KeyEncryptionAlgorithm) { throw new InvalidArgumentException(sprintf('The key encryption algorithm "%s" is not supported or not a key encryption algorithm instance.', $completeHeader['alg'])); } return $keyEncryptionAlgorithm; } /** * @throws InvalidArgumentException if the header parameter "enc" is missing * @throws InvalidArgumentException if the header parameter "enc" is not supported or not a content encryption algorithm */ private function getContentEncryptionAlgorithm(array $completeHeader): ContentEncryptionAlgorithm { if (!isset($completeHeader['enc'])) { throw new InvalidArgumentException('Parameter "enc" is missing.'); } $contentEncryptionAlgorithm = $this->contentEncryptionAlgorithmManager->get($completeHeader['enc']); if (!$contentEncryptionAlgorithm instanceof ContentEncryptionAlgorithm) { throw new InvalidArgumentException(sprintf('The content encryption algorithm "%s" is not supported or not a content encryption algorithm instance.', $completeHeader['enc'])); } return $contentEncryptionAlgorithm; } /** * @throws InvalidArgumentException if the header contains duplicated entries */ private function checkDuplicatedHeaderParameters(array $header1, array $header2): void { $inter = array_intersect_key($header1, $header2); if (0 !== count($inter)) { throw new InvalidArgumentException(sprintf('The header contains duplicated entries: %s.', implode(', ', array_keys($inter)))); } } }