класс OpenSSL::Timestamp::TokenInfo

Родитель:: Объект

Неизменяемое и только для чтения представление информации о токенах временных отметок из Response.

Публичные Классовые Методы

OpenSSL::Timestamp::TokenInfo.new(file) → token-info

OpenSSL::Timestamp::TokenInfo.new(string) → token-info

Исходный код

static VALUE
ossl_ts_token_info_initialize(VALUE self, VALUE der)
{
    TS_TST_INFO *info = DATA_PTR(self);
    BIO *in;

    der = ossl_to_der_if_possible(der);
    in  = ossl_obj2bio(&der);
    info = d2i_TS_TST_INFO_bio(in, &info);
    BIO_free(in);
    if (!info) {
        DATA_PTR(self) = NULL;
        ossl_raise(eTimestampError, "Error when decoding the timestamp token info");
    }
    DATA_PTR(self) = info;

    return self;
}

Создаёт TokenInfo из File или string параметра, соответствующий File или string должен быть закодирован в DER. Обратите внимание, что TokenInfo — неизменяемый класс только для чтения. Если вы хотите создать отметки времени, обратитесь к Factory вместо этого.

Публичные Методы Экземпляров

algorithm → строка или nil

Исходный код

static VALUE
ossl_ts_token_info_get_algorithm(VALUE self)
{
    TS_TST_INFO *info;
    TS_MSG_IMPRINT *mi;
    X509_ALGOR *algo;

    GetTSTokenInfo(self, info);
    mi = TS_TST_INFO_get_msg_imprint(info);
    algo = TS_MSG_IMPRINT_get_algo(mi);
    return get_asn1obj(algo->algorithm);
}

Возвращает «короткое имя» идентификатора объекта, представляющего алгоритм, который был использован для вывода хэш-значения сообщения. Для действительных временных отметок это то же значение, которое уже было указано в Request. Если статус GRANTED или GRANTED_WITH_MODS, это никогда не nil.

Пример:

algo = token_info.algorithm
puts algo                -> "SHA1"

gen_time → Время

Исходный код

static VALUE
ossl_ts_token_info_get_gen_time(VALUE self)
{
    TS_TST_INFO *info;

    GetTSTokenInfo(self, info);
    return asn1time_to_time(TS_TST_INFO_get_time(info));
}

Возвращает время создания этого токена временной метки. Если статус GRANTED или GRANTED_WITH_MODS, это никогда не nil.

msg_imprint → строка.

Исходный код

static VALUE
ossl_ts_token_info_get_msg_imprint(VALUE self)
{
    TS_TST_INFO *info;
    TS_MSG_IMPRINT *mi;
    ASN1_OCTET_STRING *hashed_msg;
    VALUE ret;

    GetTSTokenInfo(self, info);
    mi = TS_TST_INFO_get_msg_imprint(info);
    hashed_msg = TS_MSG_IMPRINT_get_msg(mi);
    ret = rb_str_new((const char *)hashed_msg->data, hashed_msg->length);

    return ret;
}

Возвращает хэш-значение сообщения. Для действительных временных отметок это то же значение, которое уже было указано в Request. Если статус GRANTED или GRANTED_WITH_MODS, это никогда не nil.

Пример:

mi = token_info.msg_imprint
puts mi                -> "DEADBEEF"

nonce → BN или nil

Исходный код

static VALUE
ossl_ts_token_info_get_nonce(VALUE self)
{
    TS_TST_INFO *info;
    const ASN1_INTEGER *nonce;

    GetTSTokenInfo(self, info);
    if (!(nonce = TS_TST_INFO_get_nonce(info)))
        return Qnil;

    return asn1integer_to_num(nonce);
}

Если токен временной метки действителен, это поле содержит тот же nonce, который был передан серверу временных отметок в исходном Request.

ordering → true, false или nil

Исходный код

static VALUE
ossl_ts_token_info_get_ordering(VALUE self)
{
    TS_TST_INFO *info;

    GetTSTokenInfo(self, info);
    return TS_TST_INFO_get_ordering(info) ? Qtrue : Qfalse;
}

Если поле ordering отсутствует или если поле ordering присутствует и установлено в false, то поле genTime указывает только время, в которое токен временной метки был создан службой времени. В таком случае, порядок токенов временных отметок, выпущенных той же службой времени или разными службами времени, возможен только тогда, когда разность между genTime первой временной метки и genTime второй временной метки больше суммы погрешностей genTime для каждой временной метки.

Если поле ordering присутствует и установлено в true, каждый токен временной метки от одной и той же службы времени всегда может быть упорядочен по полю genTime, независимо от точности genTime.

policy_id → строка или nil

Исходный код

static VALUE
ossl_ts_token_info_get_policy_id(VALUE self)
{
    TS_TST_INFO *info;

    GetTSTokenInfo(self, info);
    return get_asn1obj(TS_TST_INFO_get_policy_id(info));
}

Возвращает идентификатор объекта политики времени, в соответствии с которым была создана эта временная отметка. Если статус GRANTED или GRANTED_WITH_MODS, это никогда не nil.

Пример:

id = token_info.policy_id
puts id                 -> "1.2.3.4.5"

serial_number → BN или nil

Исходный код

static VALUE
ossl_ts_token_info_get_serial_number(VALUE self)
{
    TS_TST_INFO *info;

    GetTSTokenInfo(self, info);
    return asn1integer_to_num(TS_TST_INFO_get_serial(info));
}

Возвращает порядковый номер токена временной метки. Это значение никогда не должно быть одинаковым для двух токенов временных отметок, выпущенных одной и той же службой временных отметок. Если статус GRANTED или GRANTED_WITH_MODS, это никогда не nil.

to_der → строка

Исходный код

static VALUE
ossl_ts_token_info_to_der(VALUE self)
{
    TS_TST_INFO *info;

    GetTSTokenInfo(self, info);
    return asn1_to_der((void *)info, (int (*)(void *, unsigned char **))i2d_TS_TST_INFO);
}

Возвращает TokenInfo в формате DER.

to_text ()

Исходный код

static VALUE
ossl_ts_token_info_to_text(VALUE self)
{
    TS_TST_INFO *info;
    BIO *out;

    GetTSTokenInfo(self, info);

    out = BIO_new(BIO_s_mem());
    if (!out) ossl_raise(eTimestampError, NULL);

    if (!TS_TST_INFO_print_bio(out, info)) {
        BIO_free(out);
        ossl_raise(eTimestampError, NULL);
    }

    return ossl_membio2str(out);
}

version → Целое число или nil

Исходный код

static VALUE
ossl_ts_token_info_get_version(VALUE self)
{
    TS_TST_INFO *info;

    GetTSTokenInfo(self, info);
    return LONG2NUM(TS_TST_INFO_get_version(info));
}

Возвращает номер версии информации о токенах. На серверах, соответствующих спецификации, это значение должно быть 1 если присутствует. Если статус GRANTED или GRANTED_WITH_MODS.

Ruby Core © 1993–2024 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.