Документация
ОС Аврора 5.0.1
ciphertest.cpp
Приведённый ниже код демонстрирует, как использовать класс QCA::Cipher.
/*
Copyright (C) 2003 Justin Karneges <justin@affinix.com>
Copyright (C) 2005-2006 Brad Hards <bradh@frogmouth.net>
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
// QtCrypto содержит объявления всех сущностей QCA.
#include <QtCrypto>
#include <cstdio>
#include <QCoreApplication>
#ifdef QT_STATICPLUGIN
#include "import_plugins.h"
#endif
int main(int argc, char **argv)
{
// Объект Initializer настраивает элементы, а также
// выполняет очистку, когда они больше не требуются.
QCA::Initializer init;
QCoreApplication app(argc, argv);
// Используется первый аргумент, если он предоставлен, или
// используется «привет», если нет аргументов.
QCA::SecureArray arg = (argc >= 2) ? argv[1] : "привет";
// Проверка AES128
if (!QCA::isSupported("aes128-cbc-pkcs7"))
printf("AES128-CBC не поддерживается!\n");
else {
// Создаётся случайный ключ — в реальном приложении он, вероятно,
// будет получен из другого источника.
QCA::SymmetricKey key(16);
// Создаётся случайный вектор инициализации — это значение нужно,
// чтобы расшифровать полученный зашифрованный текст, но его
// не нужно держать в секрете (в отличие от ключа).
QCA::InitializationVector iv(16);
// Создаётся 128-битный объект шифрования AES в режиме сцепления блоков шифротекста (CBC).
QCA::Cipher cipher(QStringLiteral("aes128"),
QCA::Cipher::CBC,
// Используется заполнение по умолчанию, что эквивалентно PKCS7 для CBC.
QCA::Cipher::DefaultPadding,
// Этот объект будет зашифрован.
QCA::Encode,
key,
iv);
// Используется зашифрованный объект, чтобы зашифровать аргумент, который был передан,
// после чего возвращается результат. Следует обратить внимание, что если данных меньше
// 16 байт (1 блок), то ничего не будет возвращено. Данные буферизуются, можно вызвать
// update() столько раз, сколько потребуется.
QCA::SecureArray u = cipher.update(arg);
// Нужно проверить, сработал ли этот вызов update().
if (!cipher.ok()) {
printf("Ошибка обновления\n");
}
// Вывод результатов этого этапа.
printf("Шифрованием AES128 для %s является [%s]\n", arg.data(), qPrintable(QCA::arrayToHex(u.toByteArray())));
// Поскольку используется дополнение PKCS7, нужно вывести последний (дополненный) блок.
// Следует обратить внимание, что всегда нужно вызывать final() даже без дополнения, чтобы провести очистку.
QCA::SecureArray f = cipher.final();
// Проверяется, сработал ли вызов final(),
if (!cipher.ok()) {
printf("Ошибка завершения\n");
}
// и выводится получившийся блок. Зашифрованный текст — это результат update()
// и результат final().
printf("Последний блок для шифрования AES128 — [0x%s]\n", qPrintable(QCA::arrayToHex(f.toByteArray())));
// Повторно используется дешифрование зашифрованного текста. Нужно использовать тот же ключ и
// вектор инициализации, что и при шифровании.
cipher.setup(QCA::Decode, key, iv);
// Создаётся единый массив зашифрованного текста. Также можно вызвать update()
// с каждым блоком по мере его получения, если это полезнее.
QCA::SecureArray cipherText = u.append(f);
// Текст расшифровывается.
QCA::SecureArray plainText = cipher.update(cipherText);
// Проверяется, сработал ли вызов update().
if (!cipher.ok()) {
printf("Ошибка обновления\n");
}
// Вывод результатов.
printf("Дешифровкой с использованием AES128 для [0x%s] является %s\n",
qPrintable(QCA::arrayToHex(cipherText.toByteArray())),
plainText.data());
// Снова нужно вызвать final(), чтобы получить последний блок (с удалённым дополнением).
plainText = cipher.final();
// Проверяется, сработал ли вызов final().
if (!cipher.ok()) {
printf("Ошибка завершения\n");
}
// Вывод результатов.
printf("Конечный блок дешифрования с использованием AES128 — это %s\n", plainText.data());
// Вместо update() и final() можно сделать всё
// за один шаг, используя process().
printf("Одноэтапное дешифрование с использованием AES128: %s\n", QCA::SecureArray(cipher.process(cipherText)).data());
}
return 0;
}