FileCipher.kt

/*
  Copyright (C) 2026 Sber

  Licensed under the Apache License, Version 2.0 (the "License");
  you may not use this file except in compliance with the License.
  You may obtain a copy of the License at

          http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.
*/

package org.archtool.fileloader2.service.crypto

import java.security.SecureRandom
import java.util.UUID
import javax.crypto.Cipher
import javax.crypto.SecretKey
import javax.crypto.SecretKeyFactory
import javax.crypto.spec.GCMParameterSpec
import javax.crypto.spec.PBEKeySpec
import javax.crypto.spec.SecretKeySpec
import org.archtool.fileloader2.configuration.properties.CryptoProperties
import org.springframework.stereotype.Component

/**
 * Шифрование содержимого файлов: AES-256-GCM, тег 128 бит, ключ отдельный для каждого файла.
 *
 * Стандартный провайдер JDK при расшифровке AES-GCM отдаёт данные только после проверки тега (в doFinal),
 * поэтому расшифровка выполняется целиком в памяти.
 */
@Component
class FileCipher(
    private val cryptoProperties: CryptoProperties,
) {
    private val secureRandom = SecureRandom()

    /**
     * @return случайная соль для получения ключа шифрования, 16 байт
     */
    fun generateSalt(): ByteArray = randomBytes(SALT_LENGTH_BYTES)

    /**
     * @return случайный вектор инициализации AES-GCM, 12 байт
     */
    fun generateIv(): ByteArray = randomBytes(IV_LENGTH_BYTES)

    /**
     * Создаёт шифратор из готового ключа. Дёшево, в отличие от получения ключа: подходит, когда одно и то же
     * содержимое нужно зашифровать повторно (тот же ключ и IV дают тот же шифротекст). Экземпляр одноразовый.
     *
     * @param key ключ файла, полученный [deriveKey]
     * @param iv вектор инициализации файла
     * @return инициализированный шифратор
     */
    fun encryptor(key: SecretKey, iv: ByteArray): Cipher = cipher(Cipher.ENCRYPT_MODE, key, iv)

    /**
     * Создаёт дешифратор файла. Ошибка проверки тега целостности (изменённая фраза или повреждённые данные)
     * обнаруживается в doFinal и выбрасывается как AEADBadTagException.
     *
     * @param fileId идентификатор файла, участвует в получении ключа
     * @param salt соль файла
     * @param iv вектор инициализации файла
     * @return инициализированный дешифратор
     */
    fun decryptor(fileId: UUID, salt: ByteArray, iv: ByteArray): Cipher = cipher(Cipher.DECRYPT_MODE, deriveKey(fileId, salt), iv)

    /**
     * Получает ключ AES-256 через PBKDF2WithHmacSHA256 (65 536 итераций) из строки «фраза::id файла».
     * Ключ объекта S3 в строку не входит, поэтому смена префикса ключей S3 на расшифровку не влияет.
     * Операция дорогая (десятки миллисекунд процессора), поэтому для повторного шифрования ключ стоит получить один раз.
     *
     * @param fileId идентификатор файла
     * @param salt соль файла
     * @return ключ шифрования файла
     */
    fun deriveKey(fileId: UUID, salt: ByteArray): SecretKey {
        val passwordMaterial = cryptoProperties.phrase + "::" + fileId
        val spec = PBEKeySpec(passwordMaterial.toCharArray(), salt, PBKDF2_ITERATIONS, KEY_SIZE_BITS)
        try {
            val raw = SecretKeyFactory.getInstance(KDF_ALGO).generateSecret(spec).encoded
            return SecretKeySpec(raw, KEY_ALGO)
        } finally {
            spec.clearPassword()
        }
    }

    /**
     * @param mode Cipher.ENCRYPT_MODE или Cipher.DECRYPT_MODE
     * @param key ключ файла
     * @param iv вектор инициализации файла
     * @return AES-GCM Cipher с ключом файла
     */
    private fun cipher(mode: Int, key: SecretKey, iv: ByteArray): Cipher {
        return Cipher.getInstance(CIPHER_ALGO).apply {
            init(mode, key, GCMParameterSpec(GCM_TAG_LENGTH_BITS, iv))
        }
    }

    /**
     * @param length число байт
     * @return криптографически случайные байты
     */
    private fun randomBytes(length: Int): ByteArray = ByteArray(length).also { secureRandom.nextBytes(it) }

    companion object {
        /** На сколько байт зашифрованное содержимое длиннее исходного: тег AES-GCM */
        const val ENCRYPTION_OVERHEAD_BYTES = 16

        private const val CIPHER_ALGO = "AES/GCM/NoPadding"
        private const val KEY_ALGO = "AES"
        private const val KDF_ALGO = "PBKDF2WithHmacSHA256"
        private const val KEY_SIZE_BITS = 256
        private const val PBKDF2_ITERATIONS = 65_536
        private const val GCM_TAG_LENGTH_BITS = ENCRYPTION_OVERHEAD_BYTES * 8
        private const val IV_LENGTH_BYTES = 12
        private const val SALT_LENGTH_BYTES = 16
    }
}