class OpenSSL::ASN1::Primitive
Die Elternklasse für alle primitiven Kodierungen. Attribute sind die gleichen wie für ASN1Data, mit der Ergänzung von Tagging. Primitive-Werte können niemals mit indefinite Länge kodiert werden, daher ist es nicht möglich, das Attribut indefinite_length für Primitive und seine Unterklassen festzulegen.
Primitive Unterklassen und ihre Zuordnung zu Ruby-Klassen
-
OpenSSL::ASN1::EndOfContent <=> value ist immer
nil -
OpenSSL::ASN1::Boolean <=> value ist
trueoderfalse -
OpenSSL::ASN1::Integer<=> value ist einOpenSSL::BN -
OpenSSL::ASN1::BitString <=> value ist ein
String -
OpenSSL::ASN1::OctetString <=> value ist ein
String -
OpenSSL::ASN1::Null <=> value ist immer
nil -
OpenSSL::ASN1::Object<=> value ist einString -
OpenSSL::ASN1::Enumerated <=> value ist ein
OpenSSL::BN -
OpenSSL::ASN1::UTF8String <=> value ist ein
String -
OpenSSL::ASN1::NumericString <=> value ist ein
String -
OpenSSL::ASN1::PrintableString <=> value ist ein
String -
OpenSSL::ASN1::T61String <=> value ist ein
String -
OpenSSL::ASN1::VideotexString <=> value ist ein
String -
OpenSSL::ASN1::IA5String <=> value ist ein
String -
OpenSSL::ASN1::UTCTime <=> value ist eine
Time -
OpenSSL::ASN1::GeneralizedTime <=> value ist eine
Time -
OpenSSL::ASN1::GraphicString <=> value ist ein
String -
OpenSSL::ASN1::ISO64String <=> value ist ein
String -
OpenSSL::ASN1::GeneralString <=> value ist ein
String -
OpenSSL::ASN1::UniversalString <=> value ist ein
String -
OpenSSL::ASN1::BMPString <=> value ist ein
String
OpenSSL::ASN1::BitString
Zusätzliche Attribute
unused_bits: wenn die Länge des zugrunde liegenden BIT STRING ein Vielfaches von 8 ist, dann ist unused_bits 0. Andernfalls gibt unused_bits die Anzahl der Bits an, die im letzten Oktett des value des BitString ignoriert werden sollen.
OpenSSL::ASN1::ObjectId
HINWEIS: Während OpenSSL::ASN1::ObjectId.new ein neues ObjectId alloziiert, wird es typischerweise nicht auf diese Weise alloziiert, sondern aus geparsten ASN1-Kodierungen empfangen.
Zusätzliche Attribute
-
sn: der Kurzname wie in <openssl/objects.h> definiert.
-
ln: der Langname wie in <openssl/objects.h> definiert.
-
oid: die Objektkennung als
String, z.B. “1.2.3.4.5” -
short_name: Alias für sn.
-
long_name: Alias für ln.
Beispiele
Mit Ausnahme von OpenSSL::ASN1::EndOfContent nimmt jeder Konstruktor der Primitive-Klasse mindestens einen Parameter entgegen, den value.
Erstellung von EndOfContent
eoc = OpenSSL::ASN1::EndOfContent.new
Erstellung eines beliebigen anderen 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)
Attribute
Kann als Hinweis zur Kodierung eines Wertes entweder implizit oder explizit verwendet werden, indem es entweder auf :IMPLICIT oder :EXPLICIT gesetzt wird. tagging wird nicht gesetzt, wenn eine ASN.1-Struktur mit OpenSSL::ASN1.decode geparst wird.
Öffentliche Klassenmethoden
Source
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: ist obligatorisch.
tag: optional, kann für getaggte Werte angegeben werden. Wenn kein tag angegeben wird, wird standardmäßig der UNIVERSAL-Tag verwendet, der der Primitive-Unterklasse entspricht.
tagging: kann als Kodierungshinweis verwendet werden, um einen Wert explizit oder implizit zu kodieren. Mögliche Werte siehe ASN1.
tag_class: wenn tag und tagging nil sind, wird dies standardmäßig auf :UNIVERSAL gesetzt. Wenn entweder tag oder tagging gesetzt sind, wird standardmäßig :CONTEXT_SPECIFIC verwendet. Mögliche Werte siehe ASN1.
Beispiel
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)
Öffentliche Instanzmethoden
Source
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));
}
Details siehe ASN1Data#to_der.