类 OpenSSL::ASN1::Primitive

所有原始编码的父类。属性与 ASN1Data 相同，另外还添加了标记。 Primitive 值永远不能以不定长形式编码，因此无法为 Primitive 及其子类设置indefinite_length 属性。

Primitive 子类及其与 Ruby 类的映射 ↑

  • OpenSSL::ASN1::EndOfContent <=> value 始终为 nil

  • OpenSSL::ASN1::Boolean <=> value 为 true 或 false

  • OpenSSL::ASN1::Integer <=> value 为一个 OpenSSL::BN

  • OpenSSL::ASN1::BitString <=> value 为一个字符串

  • OpenSSL::ASN1::OctetString <=> value 为一个字符串

  • OpenSSL::ASN1::Null <=> value 始终为 nil

  • OpenSSL::ASN1::Object <=> value 为一个字符串

  • OpenSSL::ASN1::Enumerated <=> value 为一个 OpenSSL::BN

  • OpenSSL::ASN1::UTF8String <=> value 为一个字符串

  • OpenSSL::ASN1::NumericString <=> value 为一个字符串

  • OpenSSL::ASN1::PrintableString <=> value 为一个字符串

  • OpenSSL::ASN1::T61String <=> value 为一个字符串

  • OpenSSL::ASN1::VideotexString <=> value 为一个字符串

  • OpenSSL::ASN1::IA5String <=> value 为一个字符串

  • OpenSSL::ASN1::UTCTime <=> value 为一个时间

  • OpenSSL::ASN1::GeneralizedTime <=> value 为一个时间

  • OpenSSL::ASN1::GraphicString <=> value 为一个字符串

  • OpenSSL::ASN1::ISO64String <=> value 为一个字符串

  • OpenSSL::ASN1::GeneralString <=> value 为一个字符串

  • OpenSSL::ASN1::UniversalString <=> value 为一个字符串

  • OpenSSL::ASN1::BMPString <=> value 是一个字符串

OpenSSL::ASN1::BitString ↑

附加属性 ↑

unused_bits: 如果底层 BIT STRING 的长度是 8 的倍数，则 unused_bits 为 0。否则，unused_bits 表示在 BitString 的 value 的最后一个八位字节中要忽略的位数。

OpenSSL::ASN1::ObjectId ↑

注意：虽然 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 类构造函数至少接受一个参数，即 value。

创建 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 来暗示以隐式或显式方式编码值。当使用 OpenSSL::ASN1.decode 解析 ASN.1 结构时，不会设置 tagging。

公共类方法

OpenSSL::ASN1::Primitive.new(value [, tag, tagging, tag_class ]) → Primitive click to toggle source

value: 是必需的。

tag: 可选，可为带标签的值指定。如果未指定 tag，则默认情况下使用与 Primitive 子类对应的 UNIVERSAL 标签。

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)

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;
}

公共实例方法

to_der → DER 编码的字符串 点击切换源代码

有关详细信息，请参阅 ASN1Data#to_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));
}