Программно создавать сертификат X509 с использованием OpenSSL

Ответ 1

Сначала вам нужно ознакомиться с терминологией и механизмами.

Сертификат X.509 certificate по определению не включает в себя закрытый ключ. Вместо этого это версия открытого ключа, подписанная СА (вместе с любыми атрибутами, которые СА помещает в подпись). Формат PEM на самом деле поддерживает только раздельное хранение ключа и сертификата, хотя вы можете затем объединить их.

В любом случае вам нужно будет вызывать 20+ различные функции API OpenSSL для создания ключа и самозаверяющего сертификата. Пример приведен в самом источнике OpenSSL, в demos/x509/mkcert.c

Для более подробного ответа см. объяснение Натана Османа ниже.

Ответ 2

Я понимаю, что это очень поздний (и длинный) ответ. Но, учитывая, насколько хорошо этот вопрос оценивается в результатах поисковой системы, я полагал, что, возможно, стоит написать достойный ответ.

Многое из того, что вы прочтете ниже, заимствовано из этой демонстрации и документов 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 (написанный на С++), который вы можете просмотреть .

Ответ 3

Есть ли вероятность сделать это с помощью вызова system из вашего приложения? Несколько веских причин для этого:

• Лицензирование: вызов исполняемого файла openssl, возможно, отделяет его от вашего приложения и может дать определенные преимущества. Отказ от ответственности: проконсультируйтесь с адвокатом по этому вопросу.

• Документация: OpenSSL поставляется с феноменальной документацией из командной строки, которая значительно упрощает потенциально сложный инструмент.

• Тестирование: вы можете использовать OpenSSL из командной строки, пока не поймете, как создавать сертификаты. Есть много вариантов; ожидайте потратить около дня на это, пока вы не получите все подробные сведения. После этого тривиально включить команду в ваше приложение.

Если вы решите использовать API, просмотрите список разработчиков openssl-dev на сайте www.openssl.org.

Удачи!

Ответ 4

Очень простое руководство по созданию цифровых сертификатов http://publib.boulder.ibm.com/infocenter/rsthelp/v8r0m0/index.jsp?topic=/com.ibm.rational.test.lt.doc/topics/tcreatecertopenssl.html

О выполнении этих команд из вашего кода я не уверен.

Ответ 5

Натан Осман подробно и подробно объяснил, что эту же проблему нужно решить в 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;
}

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