класс OpenSSL::ASN1::Primitive

Родитель:: OpenSSL::ASN1::ASN1Data

Базовый класс для всех примитивных кодировок. Атрибуты такие же, как для ASN1Data, с добавлением меток. Значения Primitive никогда не могут быть закодированы с неопределенной длиной, поэтому атрибут indefinite_length для Primitive и его подклассов установить нельзя.

Подклассы Primitive и их соответствие классам Ruby

OpenSSL::ASN1::EndOfContent <=> значение всегда nil
OpenSSL::ASN1::Boolean <=> значение равно true или false
OpenSSL::ASN1::Integer <=> значение — это OpenSSL::BN
OpenSSL::ASN1::BitString <=> значение — это строка
OpenSSL::ASN1::OctetString <=> значение — это строка
OpenSSL::ASN1::Null <=> значение всегда nil
OpenSSL::ASN1::Object <=> значение — это строка
OpenSSL::ASN1::Enumerated <=> значение — это OpenSSL::BN
OpenSSL::ASN1::UTF8String <=> значение — это строка
OpenSSL::ASN1::NumericString <=> значение — это строка
OpenSSL::ASN1::PrintableString <=> значение — это строка
OpenSSL::ASN1::T61String <=> значение — это строка
OpenSSL::ASN1::VideotexString <=> значение — это строка
OpenSSL::ASN1::IA5String <=> значение — это строка
OpenSSL::ASN1::UTCTime <=> значение — это Time
OpenSSL::ASN1::GeneralizedTime <=> значение — это Time
OpenSSL::ASN1::GraphicString <=> значение — это строка
OpenSSL::ASN1::ISO64String <=> значение — это строка
OpenSSL::ASN1::GeneralString <=> значение — это строка
OpenSSL::ASN1::UniversalString <=> значение — это строка
OpenSSL::ASN1::BMPString <=> значение — это строка

OpenSSL::ASN1::BitString

Дополнительные атрибуты

unused_bits: если длина базового BIT STRING кратна 8, то unused_bits равно 0. В противном случае unused_bits указывает количество битов, которые необходимо игнорировать в последнем байте значения BitString.

OpenSSL::ASN1::ObjectId

ПРИМЕЧАНИЕ: Хотя ::new выделит новый ObjectId, обычно он не выделяется таким образом, а поступает из парсированных кодировок ASN1.

Дополнительные атрибуты

sn: короткое имя, определенное в <openssl/objects.h>.
ln: полное имя, определенное в <openssl/objects.h>.
oid: идентификатор объекта в виде строки, например, “1.2.3.4.5”
short_name: псевдоним для sn.
long_name: псевдоним для ln.

Примеры

За исключением OpenSSL::ASN1::EndOfContent, каждый конструктор класса Primitive принимает как минимум один параметр — значение.

Создание EndOfContent

eoc = OpenSSL::ASN1::EndOfContent.new

Создание любого другого Primitive

prim = <class>.new(value) # <class> being one of the sub-classes except EndOfContent
prim_zero_tagged_implicit = <class>.new(value, 0, :IMPLICIT)
prim_zero_tagged_explicit = <class>.new(value, 0, :EXPLICIT)

Атрибуты

tagging[RW]

Может использоваться как подсказка для кодирования значения неявно или явно, установив его либо в :IMPLICIT, либо в :EXPLICIT. tagging не устанавливается, когда структура ASN.1 парсится с помощью OpenSSL::ASN1.decode.

Открытые методы класса

OpenSSL::ASN1::Primitive.new(value [, tag, tagging, tag_class ]) → Primitive Показать исходный код

static VALUE
ossl_asn1_initialize(int argc, VALUE *argv, VALUE self)
{
    VALUE value, tag, tagging, tag_class;
    int default_tag;

    rb_scan_args(argc, argv, "13", &value, &tag, &tagging, &tag_class);
    default_tag = ossl_asn1_default_tag(self);

    if (default_tag == -1 || argc > 1) {
        if(NIL_P(tag))
            ossl_raise(eASN1Error, "must specify tag number");
        if(!NIL_P(tagging) && !SYMBOL_P(tagging))
            ossl_raise(eASN1Error, "invalid tagging method");
        if(NIL_P(tag_class)) {
            if (NIL_P(tagging))
                tag_class = sym_UNIVERSAL;
            else
                tag_class = sym_CONTEXT_SPECIFIC;
        }
        if(!SYMBOL_P(tag_class))
            ossl_raise(eASN1Error, "invalid tag class");
    }
    else{
        tag = INT2NUM(default_tag);
        tagging = Qnil;
        tag_class = sym_UNIVERSAL;
    }
    ossl_asn1_set_tag(self, tag);
    ossl_asn1_set_value(self, value);
    ossl_asn1_set_tagging(self, tagging);
    ossl_asn1_set_tag_class(self, tag_class);
    ossl_asn1_set_indefinite_length(self, Qfalse);
    if (default_tag == V_ASN1_BIT_STRING)
        rb_ivar_set(self, sivUNUSED_BITS, INT2FIX(0));

    return self;
}

value: обязательно.

tag: необязательно, может быть указано для меченых значений. Если tag не указан, по умолчанию используется универсальная метка, соответствующая подклассу Primitive.

tagging: может использоваться как подсказка для кодирования значения явно или неявно, см. ASN1 для возможных значений.

tag_class: если tag и tagging nil, то по умолчанию устанавливается :UNIVERSAL. Если установлен либо tag, либо tagging, то по умолчанию используется :CONTEXT_SPECIFIC. Для возможных значений см. ASN1.

Пример

int = OpenSSL::ASN1::Integer.new(42)
zero_tagged_int = OpenSSL::ASN1::Integer.new(42, 0, :IMPLICIT)
private_explicit_zero_tagged_int = OpenSSL::ASN1::Integer.new(42, 0, :EXPLICIT, :PRIVATE)

Открытые методы экземпляра

to_der → DER-кодированная строка Показать исходный код

static VALUE
ossl_asn1prim_to_der(VALUE self)
{
    ASN1_TYPE *asn1;
    long alllen, bodylen;
    unsigned char *p0, *p1;
    int j, tag, tc, state;
    VALUE str;

    if (ossl_asn1_default_tag(self) == -1) {
        str = ossl_asn1_get_value(self);
        return to_der_internal(self, 0, 0, StringValue(str));
    }

    asn1 = ossl_asn1_get_asn1type(self);
    alllen = i2d_ASN1_TYPE(asn1, NULL);
    if (alllen < 0) {
        ASN1_TYPE_free(asn1);
        ossl_raise(eASN1Error, "i2d_ASN1_TYPE");
    }
    str = ossl_str_new(NULL, alllen, &state);
    if (state) {
        ASN1_TYPE_free(asn1);
        rb_jump_tag(state);
    }
    p0 = p1 = (unsigned char *)RSTRING_PTR(str);
    i2d_ASN1_TYPE(asn1, &p0);
    ASN1_TYPE_free(asn1);
    assert(p0 - p1 == alllen);

    /* Strip header since to_der_internal() wants only the payload */
    j = ASN1_get_object((const unsigned char **)&p1, &bodylen, &tag, &tc, alllen);
    if (j & 0x80)
        ossl_raise(eASN1Error, "ASN1_get_object"); /* should not happen */

    return to_der_internal(self, 0, 0, rb_str_drop_bytes(str, alllen - bodylen));
}

См. OpenSSL::ASN1::ASN1Data#to_der для подробностей.

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