класс OpenSSL::ASN1::ASN1Data

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

Базовый класс, представляющий любое ASN.1-объект. При разборе с помощью ASN1.decode, помеченные значения всегда представляются экземпляром ASN1Data.

Роль `ASN1Data` при разборе помеченных значений

При кодировании типа ASN.1, тип исходного значения (например, INTEGER, OCTET STRING и т.д.) очевиден, независимо от его маркировки. Однако при разборе типов ASN.1 нельзя вывести «реальный тип» помеченных значений. Поэтому помеченные значения обычно разбираются в экземпляры ASN1Data, но с различными результатами для неявной и явной маркировки.

Пример разбора неявного помеченного значения

Неявное значение INTEGER с меткой 1 будет разобрано как ASN1Data со следующими характеристиками:

метка равна 1
класс метки равен :CONTEXT_SPECIFIC
значение равно String, содержащему исходное кодирование INTEGER.

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

Пример разбора явного помеченного значения

Явное значение INTEGER с меткой 1 будет разобрано как ASN1Data со следующими характеристиками:

метка равна 1
класс метки равен :CONTEXT_SPECIFIC
значение равно Array с одним элементом, экземпляром OpenSSL::ASN1::Integer, т.е. внутренний элемент представляет собой непомеченное примитивное значение, а маркировка представлена во внешнем ASN1Data

Пример — Декодирование неявного помеченного INTEGER

int = OpenSSL::ASN1::Integer.new(1, 0, :IMPLICIT) # implicit 0-tagged
seq = OpenSSL::ASN1::Sequence.new( [int] )
der = seq.to_der
asn1 = OpenSSL::ASN1.decode(der)
# pp asn1 => #<OpenSSL::ASN1::Sequence:0x87326e0
#              @indefinite_length=false,
#              @tag=16,
#              @tag_class=:UNIVERSAL,
#              @tagging=nil,
#              @value=
#                [#<OpenSSL::ASN1::ASN1Data:0x87326f4
#                   @indefinite_length=false,
#                   @tag=0,
#                   @tag_class=:CONTEXT_SPECIFIC,
#                   @value="\x01">]>
raw_int = asn1.value[0]
# manually rewrite tag and tag class to make it an UNIVERSAL value
raw_int.tag = OpenSSL::ASN1::INTEGER
raw_int.tag_class = :UNIVERSAL
int2 = OpenSSL::ASN1.decode(raw_int)
puts int2.value # => 1

Пример — Декодирование явного помеченного INTEGER

int = OpenSSL::ASN1::Integer.new(1, 0, :EXPLICIT) # explicit 0-tagged
seq = OpenSSL::ASN1::Sequence.new( [int] )
der = seq.to_der
asn1 = OpenSSL::ASN1.decode(der)
# pp asn1 => #<OpenSSL::ASN1::Sequence:0x87326e0
#              @indefinite_length=false,
#              @tag=16,
#              @tag_class=:UNIVERSAL,
#              @tagging=nil,
#              @value=
#                [#<OpenSSL::ASN1::ASN1Data:0x87326f4
#                   @indefinite_length=false,
#                   @tag=0,
#                   @tag_class=:CONTEXT_SPECIFIC,
#                   @value=
#                     [#<OpenSSL::ASN1::Integer:0x85bf308
#                        @indefinite_length=false,
#                        @tag=2,
#                        @tag_class=:UNIVERSAL
#                        @tagging=nil,
#                        @value=1>]>]>
int2 = asn1.value[0].value[0]
puts int2.value # => 1

Атрибуты

indefinite_length [RW]

Никогда nil. Логическое значение, указывающее, использует ли кодирование неопределённую длину (в случае разбора) или необходимо использовать форму неопределённой длины (в случае кодирования). В DER каждое значение использует форму определённой длины. Но в сценариях, когда необходимо передавать большие объёмы данных, может потребоваться поддержка потоковой передачи. Например, огромные OCTET STRING предпочтительнее передавать частями. Это возможно в BER, устанавливая байты длины кодирования в ноль, что указывает на то, что последующее значение будет передаваться частями. Кодирования неопределённой длины всегда являются составными. Конец такого потока частей обозначается передачей тега EOC (End of Content). SET и SEQUENCE могут использовать кодирование неопределённой длины, но и такие примитивные типы как, например, OCTET STRINGS или BIT STRINGS могут использовать эту возможность (см. ITU-T X.690).

infinite_length [RW]

infinite_length= [RW]

tag [RW]

Целое число, представляющее номер метки этого ASN1Data. Никогда nil.

tag_class [RW]

Symbol, представляющий класс метки этого ASN1Data. Никогда nil. Возможные значения см. в ASN1Data.

value [RW]

Содержит значение типа ASN.1. См. Constructive и Primitive для сопоставления между типами данных ASN.1 и классами Ruby.

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

OpenSSL::ASN1::ASN1Data.new(value, tag, tag_class) → ASN1Data

Исходный код

# File ext/openssl/lib/openssl/asn1.rb, line 66
def initialize(value, tag, tag_class)
  raise ASN1Error, "invalid tag class" unless tag_class.is_a?(Symbol)

  @tag = tag
  @value = value
  @tag_class = tag_class
  @indefinite_length = false
end

value: Посмотрите в Constructive и Primitive для отображения соответствия типов Ruby с типами ASN.1 и наоборот.

tag: Целое число, указывающее номер метки.

tag_class: Symbol, указывающий класс метки. См. ASN1 для возможных значений.

Пример

asn1_int = OpenSSL::ASN1Data.new(42, 2, :UNIVERSAL) # => Same as OpenSSL::ASN1::Integer.new(42)
tagged_int = OpenSSL::ASN1Data.new(42, 0, :CONTEXT_SPECIFIC) # implicitly 0-tagged INTEGER

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

to_der → DER-encoded String