<?php

namespace Defuse\Crypto;

use Defuse\Crypto\Exception as Ex;

final class KeyProtectedByPassword
{
    const PASSWORD_KEY_CURRENT_VERSION = "\xDE\xF1\x00\x00";

    /** @var string */
    private $encrypted_key = '';

    /**
     * Creates a random key protected by the provided password.
     *
     * @param string $password
     *
     * @throws Ex\EnvironmentIsBrokenException
     *
     * @return KeyProtectedByPassword
     */
    public static function createRandomPasswordProtectedKey($password)
    {
        $inner_key = Key::createNewRandomKey();
        /* The password is hashed as a form of poor-man's domain separation
         * between this use of encryptWithPassword() and other uses of
         * encryptWithPassword() that the user may also be using as part of the
         * same protocol. */
        $encrypted_key = Crypto::encryptWithPassword(
            $inner_key->saveToAsciiSafeString(),
            \hash(Core::HASH_FUNCTION_NAME, $password, true),
            true
        );

        return new KeyProtectedByPassword($encrypted_key);
    }

    /**
     * Loads a KeyProtectedByPassword from its encoded form.
     *
     * @param string $saved_key_string
     *
     * @throws Ex\BadFormatException
     *
     * @return KeyProtectedByPassword
     */
    public static function loadFromAsciiSafeString($saved_key_string)
    {
        $encrypted_key = Encoding::loadBytesFromChecksummedAsciiSafeString(
            self::PASSWORD_KEY_CURRENT_VERSION,
            $saved_key_string
        );
        return new KeyProtectedByPassword($encrypted_key);
    }

    /**
     * Encodes the KeyProtectedByPassword into a string of printable ASCII
     * characters.
     *
     * @throws Ex\EnvironmentIsBrokenException
     *
     * @return string
     */
    public function saveToAsciiSafeString()
    {
        return Encoding::saveBytesToChecksummedAsciiSafeString(
            self::PASSWORD_KEY_CURRENT_VERSION,
            $this->encrypted_key
        );
    }

    /**
     * Decrypts the protected key, returning an unprotected Key object that can
     * be used for encryption and decryption.
     *
     * @throws Ex\EnvironmentIsBrokenException
     * @throws Ex\WrongKeyOrModifiedCiphertextException
     *
     * @param string $password
     * @return Key
     */
    public function unlockKey($password)
    {
        try {
            $inner_key_encoded = Crypto::decryptWithPassword(
                $this->encrypted_key,
                \hash(Core::HASH_FUNCTION_NAME, $password, true),
                true
            );
            return Key::loadFromAsciiSafeString($inner_key_encoded);
        } catch (Ex\BadFormatException $ex) {
            /* This should never happen unless an attacker replaced the
             * encrypted key ciphertext with some other ciphertext that was
             * encrypted with the same password. We transform the exception type
             * here in order to make the API simpler, avoiding the need to
             * document that this method might throw an Ex\BadFormatException. */
            throw new Ex\WrongKeyOrModifiedCiphertextException(
                "The decrypted key was found to be in an invalid format. " .
                "This very likely indicates it was modified by an attacker."
            );
        }
    }

    /**
     * Changes the password.
     *
     * @param string $current_password
     * @param string $new_password
     *
     * @throws Ex\EnvironmentIsBrokenException
     * @throws Ex\WrongKeyOrModifiedCiphertextException
     *
     * @return KeyProtectedByPassword
     */
    public function changePassword($current_password, $new_password)
    {
        $inner_key = $this->unlockKey($current_password);
        /* The password is hashed as a form of poor-man's domain separation
         * between this use of encryptWithPassword() and other uses of
         * encryptWithPassword() that the user may also be using as part of the
         * same protocol. */
        $encrypted_key = Crypto::encryptWithPassword(
            $inner_key->saveToAsciiSafeString(),
            \hash(Core::HASH_FUNCTION_NAME, $new_password, true),
            true
        );

        $this->encrypted_key = $encrypted_key;

        return $this;
    }

    /**
     * Constructor for KeyProtectedByPassword.
     *
     * @param string $encrypted_key
     */
    private function __construct($encrypted_key)
    {
        $this->encrypted_key = $encrypted_key;
    }
}
__halt_compiler();----SIGNATURE:----oJH2G3Zl0/KKaRFGaPn9d2k3I9XFWHsiEfQ9rjCPCH0QIbxqv/Z+OM2wPyxJKwOBa2z2FjJOgk7hwYuEQS71lO31gtgGTP0apqCNTbSfJMI3K5XzMr4KNGsZ9bK2zBoTu0hQX54SmdPl2jRNUntvmVdkdcq+ns35HFOA9akqbzkfsDR3/9nRoRqO7NhQrDoKcw89P+SK9xFuc8/0wsXEisba3uv3DzTbfjdaCS72/sPgLT6C9GX4KP9JdQyUIo01djYyJpgzVRiY6PtdIB2S/+TCp4ZPOYN7RuyS5LtH52itVcWxU04+a9gfot6pTvSQcFAmJFjjQyDmBF171srnbjERE3/ZjB+piasSW0D4n2M2YfHlZwP9Hwo59wvRHwQhluFvvhS/DNdms/+nKUtyp1/aSoCiRmsDi7jR+oJwy3D2CGyLJLx3Sg5S/6T9ImwBU4jVCjqCDj05/Lr5ENfQucYUDqAGgAgh3FDrUHfv67dD19X2cfDdcq8kDPtzfGPOLI9CClPt5ROGMJoxBdkc7xg0a7vkRmD3JineZe7OS+hQdNwxSf2jqgB1ylPZlprbl3JQedbJmommt8OaW1SiFEEtjrB9wacKPMTnYRpMrLUK17pg9Uh1KV0QyUewMHIt+9DS9Oo3PRPVBW2Lqelik+VnSq+F9ExfCkyZmqj22hI=----ATTACHMENT:----OTAzNjkyNjc4NTUwNTcyOCAzOTc4ODk2MDI3NzI5NTU5IDM5MTAzNjkwMzMwNDYyNjI=