класс OpenSSL::ASN1::Constructive

Родитель:: OpenSSL::ASN1::ASN1Data
Включенные модули:: Enumerable

Базовый класс для всех составных кодировок. Атрибут value объекта Constructive всегда является массивом Array. Атрибуты такие же, как у ASN1Data, с добавлением tagging.

SET и SEQUENCE

Большинство составных кодировок представляют собой SET или SEQUENCE. Эти кодировки представлены одним из двух подклассов Constructive:

OpenSSL::ASN1::Set
OpenSSL::ASN1::Sequence

Обратите внимание, что помеченные последовательности и множества все равно анализируются как экземпляры ASN1Data. Find содержит дополнительные сведения о помеченных значениях.

Пример - создание SEQUENCE

int = OpenSSL::ASN1::Integer.new(1)
str = OpenSSL::ASN1::PrintableString.new('abc')
sequence = OpenSSL::ASN1::Sequence.new( [ int, str ] )

Пример - создание SET

int = OpenSSL::ASN1::Integer.new(1)
str = OpenSSL::ASN1::PrintableString.new('abc')
set = OpenSSL::ASN1::Set.new( [ int, str ] )

Атрибуты

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)

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

each { |asn1| block } → asn1_ary Показать исходный код

static VALUE
ossl_asn1cons_each(VALUE self)
{
    rb_block_call(ossl_asn1_get_value(self), id_each, 0, 0, 0, 0);

    return self;
}

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

Пример

asn1_ary.each do |asn1|
  puts asn1
end

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

static VALUE
ossl_asn1cons_to_der(VALUE self)
{
    VALUE ary, str;
    long i;
    int indef_len;

    indef_len = RTEST(ossl_asn1_get_indefinite_length(self));
    ary = rb_convert_type(ossl_asn1_get_value(self), T_ARRAY, "Array", "to_a");
    str = rb_str_new(NULL, 0);
    for (i = 0; i < RARRAY_LEN(ary); i++) {
        VALUE item = RARRAY_AREF(ary, i);

        if (indef_len && rb_obj_is_kind_of(item, cASN1EndOfContent)) {
            if (i != RARRAY_LEN(ary) - 1)
                ossl_raise(eASN1Error, "illegal EOC octets in value");

            /*
             * EOC is not really part of the content, but we required to add one
             * at the end in the past.
             */
            break;
        }

        item = ossl_to_der_if_possible(item);
        StringValue(item);
        rb_str_append(str, item);
    }

    return to_der_internal(self, 1, indef_len, str);
}

См. ASN1Data#to_der для получения подробной информации.

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