класс OpenSSL::PKey::DSA

static VALUE
ossl_dsa_export(int argc, VALUE *argv, VALUE self)
{
    OSSL_3_const DSA *dsa;

    GetDSA(self, dsa);
    if (DSA_HAS_PRIVATE(dsa))
        return ossl_pkey_export_traditional(argc, argv, self, 0);
    else
        return ossl_pkey_export_spki(self, 0);
}

Сериализует закрытый или открытый ключ в кодировке PEM.

Когда ключ содержит только открытые компоненты

Сериализует его в X.509 SubjectPublicKeyInfo. Параметры cipher и password игнорируются.

Ключ в кодировке PEM будет выглядеть так:

-----BEGIN PUBLIC KEY-----
[...]
-----END PUBLIC KEY-----

Вместо этого рассмотрите использование public_to_pem. Это сериализует ключ в X.509 SubjectPublicKeyInfo независимо от того, является ли он открытым или закрытым ключом.

Когда ключ содержит закрытые компоненты и параметры не указаны

Сериализует его в традиционный OpenSSL DSAPrivateKey.

Ключ в кодировке PEM будет выглядеть так:

-----BEGIN DSA PRIVATE KEY-----
[...]
-----END DSA PRIVATE KEY-----

Когда ключ содержит закрытые компоненты и указаны cipher и password

Сериализует его в традиционный OpenSSL DSAPrivateKey и шифрует его в традиционном формате шифрования PEM OpenSSL. cipher должен быть именем шифра, понятным для OpenSSL::Cipher.new, или экземпляром OpenSSL::Cipher.

Зашифрованный ключ в кодировке PEM будет выглядеть так:

-----BEGIN DSA PRIVATE KEY-----
Proc-Type: 4,ENCRYPTED
DEK-Info: AES-128-CBC,733F5302505B34701FC41F5C0746E4C0

[...]
-----END DSA PRIVATE KEY-----

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

Этот метод сохранён для совместимости. Его следует использовать только в том случае, если требуется традиционный, нестандартный формат OpenSSL.

Вместо этого рассмотрите использование public_to_pem (X.509 SubjectPublicKeyInfo) или private_to_pem (PKCS #8 PrivateKeyInfo или EncryptedPrivateKeyInfo).

static VALUE
ossl_dsa_get_params(VALUE self)
{
    OSSL_3_const DSA *dsa;
    VALUE hash;
    const BIGNUM *p, *q, *g, *pub_key, *priv_key;

    GetDSA(self, dsa);
    DSA_get0_pqg(dsa, &p, &q, &g);
    DSA_get0_key(dsa, &pub_key, &priv_key);

    hash = rb_hash_new();
    rb_hash_aset(hash, rb_str_new2("p"), ossl_bn_new(p));
    rb_hash_aset(hash, rb_str_new2("q"), ossl_bn_new(q));
    rb_hash_aset(hash, rb_str_new2("g"), ossl_bn_new(g));
    rb_hash_aset(hash, rb_str_new2("pub_key"), ossl_bn_new(pub_key));
    rb_hash_aset(hash, rb_str_new2("priv_key"), ossl_bn_new(priv_key));

    return hash;
}

Хранит все параметры ключа в хэше. НЕБЕЗОПАСНО: КОНФИДЕНЦИАЛЬНАЯ ИНФОРМАЦИЯ МОЖЕТ БЫТЬ РАСКРЫТА!!! Не используйте :-)) (На ваше усмотрение)

static VALUE
ossl_dsa_is_private(VALUE self)
{
    OSSL_3_const DSA *dsa;

    GetDSA(self, dsa);

    return DSA_PRIVATE(self, dsa) ? Qtrue : Qfalse;
}

Указывает, содержит ли этот экземпляр DSA связанный с ним закрытый ключ или нет. Закрытый ключ можно получить с помощью DSA#private_key.

static VALUE
ossl_dsa_is_public(VALUE self)
{
    const DSA *dsa;
    const BIGNUM *bn;

    GetDSA(self, dsa);
    DSA_get0_key(dsa, &bn, NULL);

    return bn ? Qtrue : Qfalse;
}

Указывает, содержит ли этот экземпляр DSA связанный с ним открытый ключ или нет. Открытый ключ можно получить с помощью DSA#public_key.

# File ext/openssl/lib/openssl/pkey.rb, line 153
def public_key
  OpenSSL::PKey.read(public_to_der)
end

Возвращает новый экземпляр DSA, который содержит только параметры DSA и открытый ключ.

Этот метод предоставляется для обратной совместимости. В большинстве случаев нет необходимости вызывать этот метод.

Для целей сериализации открытого ключа в кодировку PEM или DER формата X.509 SubjectPublicKeyInfo, обратитесь к PKey#public_to_pem и PKey#public_to_der.

Устанавливает pub_key и priv_key для экземпляра DSA. priv_key может быть nil.

Устанавливает p, q, g для экземпляра DSA.

# File ext/openssl/lib/openssl/pkey.rb, line 220
def syssign(string)
  q or raise OpenSSL::PKey::DSAError, "incomplete DSA"
  private? or raise OpenSSL::PKey::DSAError, "Private DSA key needed!"
  begin
    sign_raw(nil, string)
  rescue OpenSSL::PKey::PKeyError
    raise OpenSSL::PKey::DSAError, $!.message
  end
end

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

Устарело с версии 3.0. Вместо этого рассмотрите использование PKey::PKey#sign_raw и PKey::PKey#verify_raw.

string

Хэш-значение сообщения исходных входных данных, подлежащих подписанию.

Пример:

dsa = OpenSSL::PKey::DSA.new(2048)
doc = "Sign me"
digest = OpenSSL::Digest.digest('SHA1', doc)

# With legacy #syssign and #sysverify:
sig = dsa.syssign(digest)
p dsa.sysverify(digest, sig) #=> true

# With #sign_raw and #verify_raw:
sig = dsa.sign_raw(nil, digest)
p dsa.verify_raw(nil, sig, digest) #=> true

# File ext/openssl/lib/openssl/pkey.rb, line 243
def sysverify(digest, sig)
  verify_raw(nil, sig, digest)
rescue OpenSSL::PKey::PKeyError
  raise OpenSSL::PKey::DSAError, $!.message
end

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

Устарело с версии 3.0. Вместо этого рассмотрите использование PKey::PKey#sign_raw и PKey::PKey#verify_raw.

digest

Хэш-значение сообщения исходных входных данных, подлежащих подписанию.

sig

Значение цифровой подписи DSA.

static VALUE
ossl_dsa_to_der(VALUE self)
{
    OSSL_3_const DSA *dsa;

    GetDSA(self, dsa);
    if (DSA_HAS_PRIVATE(dsa))
        return ossl_pkey_export_traditional(0, NULL, self, 1);
    else
        return ossl_pkey_export_spki(self, 1);
}

Сериализует закрытый или открытый ключ в кодировке DER.

См. to_pem для подробностей.

Этот метод сохранён для совместимости. Его следует использовать только в том случае, если требуется традиционный, нестандартный формат OpenSSL.

Вместо этого рассмотрите использование public_to_der или private_to_der.