класс OpenSSL::ASN1::Primitive
Базовый класс для всех примитивных кодировок. Атрибуты такие же, как у ASN1Data, с добавлением разметки. Значения Primitive никогда не могут быть закодированы с неопределенной длиной, поэтому установить атрибут indefinite_length для Primitive и его подклассов невозможно.
Primitive подклассы и их отображение в классы Ruby
-
OpenSSL::ASN1::EndOfContent<=> значение всегдаnil -
OpenSSL::ASN1::Boolean<=> значение этоtrueилиfalse -
OpenSSL::ASN1::Integer<=> значение этоOpenSSL::BN -
OpenSSL::ASN1::BitString<=> значение этоString -
OpenSSL::ASN1::OctetString <=> значение это
String -
OpenSSL::ASN1::Null <=> значение всегда
nil -
OpenSSL::ASN1::Object<=> значение этоString -
OpenSSL::ASN1::Enumerated<=> значение этоOpenSSL::BN -
OpenSSL::ASN1::UTF8String <=> значение это
String -
OpenSSL::ASN1::NumericString <=> значение это
String -
OpenSSL::ASN1::PrintableString <=> значение это
String -
OpenSSL::ASN1::T61String <=> значение это
String -
OpenSSL::ASN1::VideotexString <=> значение это
String -
OpenSSL::ASN1::IA5String <=> значение это
String -
OpenSSL::ASN1::UTCTime <=> значение это
Time -
OpenSSL::ASN1::GeneralizedTime <=> значение это
Time -
OpenSSL::ASN1::GraphicString <=> значение это
String -
OpenSSL::ASN1::ISO64String <=> значение это
String -
OpenSSL::ASN1::GeneralString <=> значение это
String -
OpenSSL::ASN1::UniversalString <=> значение это
String -
OpenSSL::ASN1::BMPString <=> значение это
String
OpenSSL::ASN1::BitString
Дополнительные атрибуты
unused_bits: если длина базовой строки BIT STRING кратна 8, то unused_bits равно 0. В противном случае unused_bits указывает количество бит, которые следует игнорировать в последнем байте значения value BitString.
OpenSSL::ASN1::ObjectId
ПРИМЕЧАНИЕ: Хотя OpenSSL::ASN1::ObjectId.new выделит новый ObjectId, он обычно не выделяется таким образом, а вместо этого принимается из распарсенных кодировок ASN1.
Дополнительные атрибуты
-
sn: короткое имя, определенное в <openssl/objects.h>.
-
ln: длинное имя, определенное в <openssl/objects.h>.
-
oid: идентификатор объекта в виде
String, например, “1.2.3.4.5” -
short_name: псевдоним для sn.
-
long_name: псевдоним для ln.
Примеры
С Exception 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)
Публичные методы экземпляров
Исходный код
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);
if (i2d_ASN1_TYPE(asn1, &p0) < 0) {
ASN1_TYPE_free(asn1);
ossl_raise(eASN1Error, "i2d_ASN1_TYPE");
}
ASN1_TYPE_free(asn1);
ossl_str_adjust(str, p0);
/* 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));
} См. ASN1Data#to_der для подробностей.
Ruby Core © 1993–2024 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.
