Использование Halite для конфиденциальности и двустороннего шифрования электронных писем

Посмотрим полный запрос и ответ

Запрос

 POST /users/1/messages HTTP/1.1 Host: yourhost.dev Cache-Control: no-cache { "from": "2", "subject": "This is my subject", "message": "super secret information!!!" } 

отклик

 { "messageId": 1 } 

Если мы запросим базу данных напрямую, запись будет выглядеть следующим образом:

 *************************** 1. row *************************** id: 1 users_id: 1 fromUserId: 2 subject: MUICAV13/brmlurlUIF6TOmhD6duztBI7vYzd4PGrJu8TinhAm69Kzv5QVFpNO55mssxsthPqmwb7l/py1iTCl0tSHUcB5Wsep0bcYDztIPhZ3g7VOcKKqu+YBTcuWprMvM22nvVdzcismGvCjkVW5hqCuNaCJPaUY+7VKRqCLg6FPY4WLMOdbY2yotQ4Q== message: MUICAaSGjcjwaDUORzctiK8rDla+w2Wm/6Z75EP7LJsRZbCk5zVHC/R6oxaJ6VrVbaB6WG1k9xtUcCt9fGN40r3zjFxp4M24QEdVu18t7A8N4wbiwd1W7LqbqjieziBchtKIJjE4oM68BlKxJMGO020GSnwNBuXIaz1b1MRVQDEsm1eT/oTx1oeLvwG1X94raKpHmK7D 

Если по какой-либо причине мы должны были отправить точно такой же запрос:

 POST /users/1/messages HTTP/1.1 Host: yourhost.dev Cache-Control: no-cache { "from": "2", "subject": "This is my subject", "message": "super secret information!!!" } 

 { "messageId": 2 } 

И снова запросите базу данных:

 *************************** 1. row *************************** id: 1 users_id: 1 fromUserId: 2 subject: MUICAV13/brmlurlUIF6TOmhD6duztBI7vYzd4PGrJu8TinhAm69Kzv5QVFpNO55mssxsthPqmwb7l/py1iTCl0tSHUcB5Wsep0bcYDztIPhZ3g7VOcKKqu+YBTcuWprMvM22nvVdzcismGvCjkVW5hqCuNaCJPaUY+7VKRqCLg6FPY4WLMOdbY2yotQ4Q== message: MUICAaSGjcjwaDUORzctiK8rDla+w2Wm/6Z75EP7LJsRZbCk5zVHC/R6oxaJ6VrVbaB6WG1k9xtUcCt9fGN40r3zjFxp4M24QEdVu18t7A8N4wbiwd1W7LqbqjieziBchtKIJjE4oM68BlKxJMGO020GSnwNBuXIaz1b1MRVQDEsm1eT/oTx1oeLvwG1X94raKpHmK7D *************************** 2. row *************************** id: 2 users_id: 1 fromUserId: 2 subject: MUICAeF/ci3fG7YWIhuLCU0pIxpbNDQ10KVWjSZF4G3K8lNVdV81LeveFyhAt/9PvJQy1ePLzl3EupJCROEQ+/L4nHUFRvCekEter2AQvnlyW03cxfjzZ6XwXBUkhzhZrT22JzxL7gSzpC6fPInAzsdDRIqhK/50wPhg/Wr29pH+PT/qwfuKr0rQWdyIfg== message: MUICAYOTzGO7DcpX7bVn4BMH4DKW+JCH1Eacj+lPx9I6eOHjNTA9jHT+u+VEz7cfdiitySU5UYYpBz+IBpV7b8hp/hwkqoLP7Durq/sPRJE/qMY9naKumaPXYW6XMhkysfwnwAIWQhjuiu/r9ARBwdTP3AgFNfVVc/jTlCuaPPZ8jw39xKCO5eNU3UyBrcXFhsGBnS6B 2 rows in set (0.00 sec) 

Обратите внимание, что хотя обычный текст в обоих сообщениях фактически одинаков, в базе данных они выглядят совершенно по-разному, поэтому даже если злоумышленник имеет доступ к базе данных напрямую, без ключа шифрования он не сможет даже сообщить сообщения связаны, не говоря уже об идентичности, или узнают их содержание.

Теперь время расшифровки!

 <?php namespace Acme\Service; use Acme\Model\Message as MessageModel; use Acme\Model\Repository\Message as MessageRepository; use Acme\Model\User as UserModel; use Doctrine\ORM\EntityManager; use Doctrine\ORM\EntityRepository; use ParagonIE\Halite\KeyFactory; use ParagonIE\Halite\Symmetric\AuthenticationKey; use ParagonIE\Halite\Symmetric\Crypto; use ParagonIE\Halite\Symmetric\EncryptionKey; /** * Class Message * @package Acme\Service */ class Message { // ... SOME CODE HERE ... /** * @param $userId * @param $messageId * @return array * @throws \InvalidArgumentException */ public function get($userId, $messageId) { /** @var MessageRepository $repository */ $repository = $this->em->getRepository('Acme\Model\Message'); /** @var MessageModel $message */ if (($message = $repository->find($messageId)) == true) { $toUser = $message->getToUser(); /* * Verify that the message belongs to the intended user */ if ($toUser->getId() == $userId) { $toUserSalt = $toUser->getSalt(); $fromUser = $message->getFromUser(); $encryptionKeySubject = KeyFactory::deriveEncryptionKey(base64_decode($toUserSalt) . 'subject' . $message->getId(), base64_decode(getenv('HALITE_ENCRYPTION_KEY_SALT'))); $encryptionKeyMessage = KeyFactory::deriveEncryptionKey(base64_decode($toUserSalt) . 'message' . $message->getId(), base64_decode(getenv('HALITE_ENCRYPTION_KEY_SALT'))); $plainSubject = Crypto::decrypt(base64_decode($message->getSubject()), $encryptionKeySubject, true); $plainMessage = Crypto::decrypt(base64_decode($message->getMessage()), $encryptionKeyMessage, true); return [ 'id' => $message->getId(), 'subject' => $plainSubject, 'message' => $plainMessage, 'name' => $fromUser->getName(), ]; } } throw new \InvalidArgumentException('Message not found'); } } 

Мы получаем хранилище таблицы сообщений с $repository = $this->em->getRepository('Acme\Model\Message'); и продолжайте загружать сообщение с $message = $repository->find($messageId) . Чтобы расшифровать, мы должны снова получить ключ шифрования так же, как мы это делали при первом сохранении сообщения, только на этот раз мы будем использовать метод \ParagonIE\Halite\Symmetric\Crypto::decrypt :

 $plainSubject = Crypto::decrypt(base64_decode($message->getSubject()), $encryptionKeySubject, true); $plainMessage = Crypto::decrypt(base64_decode($message->getMessage()), $encryptionKeyMessage, true); 

Этот метод получает 3 параметра: текст шифра, ключ шифрования и флаг, чтобы сообщить методу, что он должен ожидать необработанные двоичные байты в тексте шифра. (помните, что мы сохранили его в кодировке base64 в базе данных, поэтому нам нужно его декодировать в base64) . Теперь мы можем выполнить запрос на получение сообщения по идентификатору:

Запрос

 GET /users/1/messages/1 HTTP/1.1 Host: yourhost.dev Cache-Control: no-cache 

отклик

 { "id": 1, "subject": "This is my subject", "message": "super secret information!!!", "name": "Jane Doe" } 

Вы можете посмотреть полный исходный код здесь .

Вывод

Шифрование и дешифрование очень просто с Halite. Это не означает, что приведенный выше пример является суперзащищенным. Есть еще много возможностей для улучшения, и у Halite есть и другие интересные особенности, которые могут быть продемонстрированы в следующей статье. Помните, что вы не должны воспринимать приведенную выше реализацию как готовую продукцию — она ​​предназначена только для образовательных целей

Как вы делаете шифрование / дешифрование в PHP? Вы использовали Halite? Дайте нам знать!