У меня есть приложение C/С++, и мне нужно создать сертификат pem X509, содержащий как открытый, так и закрытый ключ. Сертификат может быть сам подписан или без знака, не имеет значения.
Я хочу сделать это внутри приложения, а не из командной строки.
Какие функции OpenSSL будут делать это для меня? Любой образец кода является бонусом!
Сначала вам нужно ознакомиться с терминологией и механизмами.
Сертификат X.509 certificate по определению не включает в себя закрытый ключ. Вместо этого это версия открытого ключа, подписанная СА (вместе с любыми атрибутами, которые СА помещает в подпись). Формат PEM на самом деле поддерживает только раздельное хранение ключа и сертификата, хотя вы можете затем объединить их.
В любом случае вам нужно будет вызывать 20+ различные функции API OpenSSL для создания ключа и самозаверяющего сертификата. Пример приведен в самом источнике OpenSSL, в demos/x509/mkcert.c
Для более подробного ответа см. объяснение Натана Османа ниже.
Я понимаю, что это очень поздний (и длинный) ответ. Но, учитывая, насколько хорошо этот вопрос оценивается в результатах поисковой системы, я полагал, что, возможно, стоит написать достойный ответ.
Многое из того, что вы прочтете ниже, заимствовано из этой демонстрации и документов OpenSSL. Приведенный ниже код применяется как к C, так и к С++.
Прежде чем мы сможем создать сертификат, нам нужно создать закрытый ключ. OpenSSL предоставляет структуру EVP_PKEY для хранения секретного ключа, независимого от алгоритма, в памяти. Эта структура объявлена в openssl/evp.h, но включена openssl/x509.h (которая нам понадобится позже), поэтому вам не нужно явно включать заголовок.
Чтобы выделить структуру EVP_PKEY, мы используем EVP_PKEY_new:
EVP_PKEY * pkey;
pkey = EVP_PKEY_new();
Существует также соответствующая функция для освобождения структуры - EVP_PKEY_free -, которая принимает один аргумент: структура EVP_PKEY, инициализированная выше.
Теперь нам нужно сгенерировать ключ. В нашем примере мы создадим ключ RSA. Это делается с помощью функции RSA_generate_key, которая объявлена в openssl/rsa.h. Эта функция возвращает указатель на структуру RSA.
Простой вызов функции может выглядеть так:
RSA * rsa;
rsa = RSA_generate_key(
2048, /* number of bits for the key - 2048 is a sensible value */
RSA_F4, /* exponent - RSA_F4 is defined as 0x10001L */
NULL, /* callback - can be NULL if we aren't displaying progress */
NULL /* callback argument - not needed in this case */
);
Если возвращаемое значение RSA_generate_key равно NULL, то что-то пошло не так. Если нет, то теперь у нас есть ключ RSA, и мы можем назначить его нашей структуре EVP_PKEY из ранее:
EVP_PKEY_assign_RSA(pkey, rsa);
Структура RSA будет автоматически освобождена при освобождении структуры EVP_PKEY.
Теперь для самого сертификата.
OpenSSL использует структуру X509 для представления сертификата x509 в памяти. Определение для этой структуры находится в openssl/x509.h. Первая функция, которая нам понадобится, - X509_new. Его использование относительно просто:
X509 * x509;
x509 = X509_new();
Как и в случае с EVP_PKEY, существует соответствующая функция для освобождения структуры - X509_free.
Теперь нам нужно установить несколько свойств сертификата, используя некоторые функции X509_*:
ASN1_INTEGER_set(X509_get_serialNumber(x509), 1);
Указывает серийный номер нашего сертификата на "1". Некоторые HTTP-серверы с открытым исходным кодом отказываются принимать сертификат с серийным номером "0", который является значением по умолчанию. Следующий шаг - указать промежуток времени, в течение которого сертификат действительно действителен. Мы делаем это со следующими двумя вызовами функций:
X509_gmtime_adj(X509_get_notBefore(x509), 0);
X509_gmtime_adj(X509_get_notAfter(x509), 31536000L);
Первая строка устанавливает свойство сертификата notBefore в текущее время. (Функция X509_gmtime_adj добавляет указанное количество секунд в текущее время - в этом случае нет.) Вторая строка устанавливает свойство сертификата notAfter на 365 дней (60 секунд * 60 минут * 24 часа * 365 дней).).
Теперь нам нужно установить открытый ключ для нашего сертификата с помощью ключа, сгенерированного нами ранее:
X509_set_pubkey(x509, pkey);
Поскольку это самозаверяющий сертификат, мы устанавливаем имя эмитента на имя субъекта. Первым шагом в этом процессе является получение имени субъекта:
X509_NAME * name;
name = X509_get_subject_name(x509);
Если вы когда-либо создавали самозаверяющий сертификат в командной строке, вы, вероятно, помните, что вас попросили указать код страны. Здесь, где мы предоставляем его вместе с организацией ( "O" ) и общим именем ( "CN" ):
X509_NAME_add_entry_by_txt(name, "C", MBSTRING_ASC,
(unsigned char *)"CA", -1, -1, 0);
X509_NAME_add_entry_by_txt(name, "O", MBSTRING_ASC,
(unsigned char *)"MyCompany Inc.", -1, -1, 0);
X509_NAME_add_entry_by_txt(name, "CN", MBSTRING_ASC,
(unsigned char *)"localhost", -1, -1, 0);
(Я использую значение "CA" здесь, потому что я канадский и наш код страны. Также обратите внимание, что параметр # 4 должен быть явно добавлен к unsigned char *.)
Теперь мы можем установить имя эмитента:
X509_set_issuer_name(x509, name);
И, наконец, мы готовы выполнить процесс подписания. Назовем X509_sign ключом, который мы сгенерировали ранее. Код для этого очень прост:
X509_sign(x509, pkey, EVP_sha1());
Обратите внимание, что мы используем SHA-1 хеширующий алгоритм для подписи ключа. Это отличается от демонстрации mkcert.c, упомянутой в начале этого ответа, в которой используется MD5.
Теперь у нас есть самозаверяющий сертификат! Но мы еще не закончили - нам нужно записать эти файлы на диск. К счастью, OpenSSL мы также там рассмотрели функции PEM_*, которые объявлены в openssl/pem.h. Первый, который нам понадобится, - PEM_write_PrivateKey для сохранения нашего закрытого ключа.
FILE * f;
f = fopen("key.pem", "wb");
PEM_write_PrivateKey(
f, /* write the key to the file we've opened */
pkey, /* our key from earlier */
EVP_des_ede3_cbc(), /* default cipher for encrypting the key on disk */
"replace_me", /* passphrase required for decrypting the key on disk */
10, /* length of the passphrase string */
NULL, /* callback for requesting a password */
NULL /* data to pass to the callback */
);
Если вы не хотите шифровать закрытый ключ, просто передайте NULL для третьего и четвертого параметров выше. В любом случае, вы обязательно захотите убедиться, что файл не читается в мире. (Для пользователей Unix это означает chmod 600 key.pem.)
Уф! Теперь мы ограничимся одной функцией - нам нужно записать сертификат на диск. Для этого нам нужна функция PEM_write_X509:
FILE * f;
f = fopen("cert.pem", "wb");
PEM_write_X509(
f, /* write the certificate to the file we've opened */
x509 /* our certificate */
);
И все готово! Надеюсь, информации в этом ответе достаточно, чтобы дать вам общее представление о том, как все работает, хотя мы едва поцарапали поверхность OpenSSL.
Для тех, кто заинтересован в том, как выглядит весь код выше в реальном приложении, я собрал Gist (написанный на С++), который вы можете просмотреть .
Есть ли вероятность сделать это с помощью вызова system из вашего приложения? Несколько веских причин для этого:
Лицензирование: вызов исполняемого файла openssl, возможно, отделяет его от вашего приложения и может дать определенные преимущества. Отказ от ответственности: проконсультируйтесь с адвокатом по этому вопросу.
Документация: OpenSSL поставляется с феноменальной документацией из командной строки, которая значительно упрощает потенциально сложный инструмент.
Тестирование: вы можете использовать OpenSSL из командной строки, пока не поймете, как создавать сертификаты. Есть много вариантов; ожидайте потратить около дня на это, пока вы не получите все подробные сведения. После этого тривиально включить команду в ваше приложение.
Если вы решите использовать API, просмотрите список разработчиков openssl-dev на сайте www.openssl.org.
Удачи!
Очень простое руководство по созданию цифровых сертификатов http://publib.boulder.ibm.com/infocenter/rsthelp/v8r0m0/index.jsp?topic=/com.ibm.rational.test.lt.doc/topics/tcreatecertopenssl.html
О выполнении этих команд из вашего кода я не уверен.
Натан Осман подробно и подробно объяснил, что эту же проблему нужно решить в C++, поэтому вот мое небольшое дополнение, переписанная концепция в стиле cpp с учетом нескольких предостережений:
bool generateX509(const std::string& certFileName, const std::string& keyFileName, long daysValid)
{
bool result = false;
std::unique_ptr<BIO, void (*)(BIO *)> certFile { BIO_new_file(certFileName.data(), "wb"), BIO_free_all };
std::unique_ptr<BIO, void (*)(BIO *)> keyFile { BIO_new_file(keyFileName.data(), "wb"), BIO_free_all };
if (certFile && keyFile)
{
std::unique_ptr<RSA, void (*)(RSA *)> rsa { RSA_new(), RSA_free };
std::unique_ptr<BIGNUM, void (*)(BIGNUM *)> bn { BN_new(), BN_free };
BN_set_word(bn.get(), RSA_F4);
int rsa_ok = RSA_generate_key_ex(rsa.get(), RSA_KEY_LENGTH, bn.get(), nullptr);
if (rsa_ok == 1)
{
// --- cert generation ---
std::unique_ptr<X509, void (*)(X509 *)> cert { X509_new(), X509_free };
std::unique_ptr<EVP_PKEY, void (*)(EVP_PKEY *)> pkey { EVP_PKEY_new(), EVP_PKEY_free};
// The RSA structure will be automatically freed when the EVP_PKEY structure is freed.
EVP_PKEY_assign(pkey.get(), EVP_PKEY_RSA, reinterpret_cast<char*>(rsa.release()));
ASN1_INTEGER_set(X509_get_serialNumber(cert.get()), 1); // serial number
X509_gmtime_adj(X509_get_notBefore(cert), 0); // now
X509_gmtime_adj(X509_get_notAfter(cert), daysValid * 24 * 3600); // accepts secs
X509_set_pubkey(cert.get(), pkey.get());
// 1 -- X509_NAME may disambig with wincrypt.h
// 2 -- DO NO FREE the name internal pointer
X509_name_st* name = X509_get_subject_name(cert.get());
const uchar country[] = "RU";
const uchar company[] = "MyCompany, PLC";
const uchar common_name[] = "localhost";
X509_NAME_add_entry_by_txt(name, "C", MBSTRING_ASC, country, -1, -1, 0);
X509_NAME_add_entry_by_txt(name, "O", MBSTRING_ASC, company, -1, -1, 0);
X509_NAME_add_entry_by_txt(name, "CN", MBSTRING_ASC, common_name, -1, -1, 0);
X509_set_issuer_name(cert.get(), name);
X509_sign(cert.get(), pkey.get(), EVP_sha256()); // some hash type here
int ret = PEM_write_bio_PrivateKey(keyFile.get(), pkey.get(), nullptr, nullptr, 0, nullptr, nullptr);
int ret2 = PEM_write_bio_X509(certFile.get(), cert.get());
result = (ret == 1) && (ret2 == 1); // OpenSSL return codes
}
}
return result;
}
Конечно, должно быть больше проверок возвращаемых значений функции, на самом деле все они должны быть проверены, но это сделало бы образец слишком "ветвящимся" и в любом случае довольно легко улучшить.