Class: OpenSSL::X509::Name
Relationships & Source Files | |
Namespace Children | |
Modules:
| |
Super Chains via Extension / Inclusion / Inheritance | |
Instance Chain:
self,
Comparable
|
|
Inherits: | Object |
Defined in: | ext/openssl/ossl_x509name.c, ext/openssl/ossl_x509name.c, ext/openssl/lib/openssl/x509.rb |
Overview
An X.509 name represents a hostname, email address or other entity associated with a public key.
You can create a Name
by parsing a distinguished name String or by supplying the distinguished name as an Array.
name = OpenSSL::X509::Name.parse 'CN=nobody/DC=example'
name = OpenSSL::X509::Name.new [['CN', 'nobody'], ['DC', 'example']]
Constant Summary
-
COMPAT =
A flag for #to_s.
Breaks the name returned into multiple lines if longer than 80 characters.
ULONG2NUM(XN_FLAG_COMPAT)
-
DEFAULT_OBJECT_TYPE =
The default object type for name entries.
utf8str
-
MULTILINE =
A flag for #to_s.
Returns a multiline format.
ULONG2NUM(XN_FLAG_MULTILINE)
-
OBJECT_TYPE_TEMPLATE =
The default object type template for name entries.
hash
-
ONELINE =
# File 'ext/openssl/ossl_x509name.c', line 578
ULONG2NUM(XN_FLAG_ONELINE)
-
RFC2253 =
A flag for #to_s.
Returns an
RFC2253
format name.ULONG2NUM(XN_FLAG_RFC2253)
Class Method Summary
-
X509::Name.new ⇒ Name
constructor
Creates a new
Name
. -
.parse(str, template = OBJECT_TYPE_TEMPLATE)
Alias for .parse_openssl.
- .parse_openssl(str, template = OBJECT_TYPE_TEMPLATE) (also: .parse)
- .parse_rfc2253(str, template = OBJECT_TYPE_TEMPLATE)
Instance Method Summary
-
#<=>(other) ⇒ 1
(also: #cmp)
Compares this
Name
with other and returns0
if they are the same and-1
or+1
if they are greater or less than each other respectively. -
#add_entry(oid, value [, type], loc: -1, set: 0) ⇒ self
Adds a new entry with the given oid and value to this name.
-
#cmp(other) ⇒ 1
Alias for #<=>.
-
#eql?(other) ⇒ Boolean
Returns true if name and other refer to the same hash key.
-
#hash ⇒ Integer
The hash value returned is suitable for use as a certificate’s filename in a CA path.
-
#hash_old ⇒ Integer
Returns an MD5 based hash used in
::OpenSSL
0.9.X. - #initialize_copy(other)
- #pretty_print(q)
-
#to_a ⇒ Name, ...
Returns an Array representation of the distinguished name suitable for passing to .new
-
#to_der ⇒ String
Converts the name to DER encoding.
-
#to_s ⇒ String
Returns a String representation of the Distinguished Name.
-
#to_utf8 ⇒ String
Returns an UTF-8 representation of the distinguished name, as specified in RFC 2253.
- #inspect Internal use only
Constructor Details
X509::Name.new ⇒ Name
X509::Name.new(der) ⇒ Name
X509::Name.new(distinguished_name) ⇒ Name
X509::Name.new(distinguished_name, template) ⇒ Name
Name
X509::Name.new(der) ⇒ Name
X509::Name.new(distinguished_name) ⇒ Name
X509::Name.new(distinguished_name, template) ⇒ Name
Creates a new Name
.
A name may be created from a DER encoded string der, an Array representing a distinguished_name or a distinguished_name along with a template.
name = OpenSSL::X509::Name.new [['CN', 'nobody'], ['DC', 'example']]
name = OpenSSL::X509::Name.new name.to_der
See add_entry for a description of the distinguished_name Array’s contents
# File 'ext/openssl/ossl_x509name.c', line 145
static VALUE ossl_x509name_initialize(int argc, VALUE *argv, VALUE self) { X509_NAME *name; VALUE arg, template; GetX509Name(self, name); if (rb_scan_args(argc, argv, "02", &arg, &template) == 0) { return self; } else { VALUE tmp = rb_check_array_type(arg); if (!NIL_P(tmp)) { VALUE args; if(NIL_P(template)) template = OBJECT_TYPE_TEMPLATE; args = rb_ary_new3(2, self, template); rb_block_call(tmp, rb_intern("each"), 0, 0, ossl_x509name_init_i, args); } else{ const unsigned char *p; VALUE str = ossl_to_der_if_possible(arg); X509_NAME *x; StringValue(str); p = (unsigned char *)RSTRING_PTR(str); x = d2i_X509_NAME(&name, &p, RSTRING_LEN(str)); DATA_PTR(self) = name; if(!x){ ossl_raise(eX509NameError, NULL); } } } return self; }
Class Method Details
.parse(str, template = OBJECT_TYPE_TEMPLATE)
Alias for .parse_openssl.
# File 'ext/openssl/lib/openssl/x509.rb', line 157
alias parse parse_openssl
.parse_openssl(str, template = OBJECT_TYPE_TEMPLATE) Also known as: .parse
[ GitHub ]# File 'ext/openssl/lib/openssl/x509.rb', line 146
def parse_openssl(str, template=OBJECT_TYPE_TEMPLATE) if str.start_with?("/") # /A=B/C=D format ary = str[1..-1].split("/").map { |i| i.split("=", 2) } else # Comma-separated ary = str.split(",").map { |i| i.strip.split("=", 2) } end self.new(ary, template) end
.parse_rfc2253(str, template = OBJECT_TYPE_TEMPLATE)
[ GitHub ]Instance Method Details
#cmp(other) ⇒ 1
#<=>(other) ⇒ 1
Also known as: #cmp
1
#<=>(other) ⇒ 1
Compares this Name
with other and returns 0
if they are the same and -1
or +1
if they are greater or less than each other respectively.
# File 'ext/openssl/ossl_x509name.c', line 396
static VALUE ossl_x509name_cmp(VALUE self, VALUE other) { int result; result = ossl_x509name_cmp0(self, other); if (result < 0) return INT2FIX(-1); if (result > 0) return INT2FIX(1); return INT2FIX(0); }
#add_entry(oid, value [, type], loc: -1, set: 0) ⇒ self
Adds a new entry with the given oid and value to this name. The oid is an object identifier defined in ASN.1
. Some common OIDs are:
- C
-
Country Name
- CN
-
Common Name
- DC
-
Domain Component
- O
-
Organization Name
- OU
-
Organizational Unit
Name
- ST
-
State or Province Name
The optional keyword parameters loc and set specify where to insert the new attribute. Refer to the manpage of X509_NAME_add_entry(3) for details. loc defaults to -1 and set defaults to 0. This appends a single-valued RDN to the end.
# File 'ext/openssl/ossl_x509name.c', line 219
VALUE ossl_x509name_add_entry(int argc, VALUE *argv, VALUE self) { X509_NAME *name; VALUE oid, value, type, opts, kwargs[2]; static ID kwargs_ids[2]; const char *oid_name; int loc = -1, set = 0; if (!kwargs_ids[0]) { kwargs_ids[0] = rb_intern_const("loc"); kwargs_ids[1] = rb_intern_const("set"); } rb_scan_args(argc, argv, "21:", &oid, &value, &type, &opts); rb_get_kwargs(opts, kwargs_ids, 0, 2, kwargs); oid_name = StringValueCStr(oid); StringValue(value); if(NIL_P(type)) type = rb_aref(OBJECT_TYPE_TEMPLATE, oid); if (kwargs[0] != Qundef) loc = NUM2INT(kwargs[0]); if (kwargs[1] != Qundef) set = NUM2INT(kwargs[1]); GetX509Name(self, name); if (!X509_NAME_add_entry_by_txt(name, oid_name, NUM2INT(type), (unsigned char *)RSTRING_PTR(value), RSTRING_LENINT(value), loc, set)) ossl_raise(eX509NameError, "X509_NAME_add_entry_by_txt"); return self; }
#cmp(other) ⇒ 1
#<=>(other) ⇒ 1
1
#<=>(other) ⇒ 1
Alias for #<=>.
#eql?(other) ⇒ Boolean
Returns true if name and other refer to the same hash key.
# File 'ext/openssl/ossl_x509name.c', line 414
static VALUE ossl_x509name_eql(VALUE self, VALUE other) { if (!rb_obj_is_kind_of(other, cX509Name)) return Qfalse; return ossl_x509name_cmp0(self, other) == 0 ? Qtrue : Qfalse; }
#hash ⇒ Integer
The hash value returned is suitable for use as a certificate’s filename in a CA path.
# File 'ext/openssl/ossl_x509name.c', line 430
static VALUE ossl_x509name_hash(VALUE self) { X509_NAME *name; unsigned long hash; GetX509Name(self, name); hash = X509_NAME_hash(name); return ULONG2NUM(hash); }
#hash_old ⇒ Integer
Returns an MD5 based hash used in ::OpenSSL
0.9.X.
# File 'ext/openssl/ossl_x509name.c', line 449
static VALUE ossl_x509name_hash_old(VALUE self) { X509_NAME *name; unsigned long hash; GetX509Name(self, name); hash = X509_NAME_hash_old(name); return ULONG2NUM(hash); }
#initialize_copy(other)
[ GitHub ]# File 'ext/openssl/ossl_x509name.c', line 180
static VALUE ossl_x509name_initialize_copy(VALUE self, VALUE other) { X509_NAME *name, *name_other, *name_new; rb_check_frozen(self); GetX509Name(self, name); GetX509Name(other, name_other); name_new = X509_NAME_dup(name_other); if (!name_new) ossl_raise(eX509NameError, "X509_NAME_dup"); SetX509Name(self, name_new); X509_NAME_free(name); return self; }
#inspect
# File 'ext/openssl/ossl_x509name.c', line 323
static VALUE ossl_x509name_inspect(VALUE self) { return rb_enc_sprintf(rb_utf8_encoding(), "#<%"PRIsVALUE" %"PRIsVALUE">", rb_obj_class(self), ossl_x509name_to_utf8(self)); }
#pretty_print(q)
[ GitHub ]
#to_a ⇒ Name
, ...
Returns an Array representation of the distinguished name suitable for passing to .new
# File 'ext/openssl/ossl_x509name.c', line 337
static VALUE ossl_x509name_to_a(VALUE self) { X509_NAME *name; X509_NAME_ENTRY *entry; int i,entries,nid; char long_name[512]; const char *short_name; VALUE ary, vname, ret; ASN1_STRING *value; GetX509Name(self, name); entries = X509_NAME_entry_count(name); if (entries < 0) { OSSL_Debug("name entries < 0!"); return rb_ary_new(); } ret = rb_ary_new2(entries); for (i=0; i<entries; i++) { if (!(entry = X509_NAME_get_entry(name, i))) { ossl_raise(eX509NameError, NULL); } if (!i2t_ASN1_OBJECT(long_name, sizeof(long_name), X509_NAME_ENTRY_get_object(entry))) { ossl_raise(eX509NameError, NULL); } nid = OBJ_ln2nid(long_name); if (nid == NID_undef) { vname = rb_str_new2((const char *) &long_name); } else { short_name = OBJ_nid2sn(nid); vname = rb_str_new2(short_name); /*do not free*/ } value = X509_NAME_ENTRY_get_data(entry); ary = rb_ary_new3(3, vname, asn1str_to_str(value), INT2NUM(value->type)); rb_ary_push(ret, ary); } return ret; }
#to_der ⇒ String
Converts the name to DER encoding
# File 'ext/openssl/ossl_x509name.c', line 468
static VALUE ossl_x509name_to_der(VALUE self) { X509_NAME *name; VALUE str; long len; unsigned char *p; GetX509Name(self, name); if((len = i2d_X509_NAME(name, NULL)) <= 0) ossl_raise(eX509NameError, NULL); str = rb_str_new(0, len); p = (unsigned char *)RSTRING_PTR(str); if(i2d_X509_NAME(name, &p) <= 0) ossl_raise(eX509NameError, NULL); ossl_str_adjust(str, p); return str; }
#to_s ⇒ String
#to_s(format) ⇒ String
String
#to_s(format) ⇒ String
# File 'ext/openssl/ossl_x509name.c', line 296
static VALUE ossl_x509name_to_s(int argc, VALUE *argv, VALUE self) { rb_check_arity(argc, 0, 1); /* name.to_s(nil) was allowed */ if (!argc || NIL_P(argv[0])) return ossl_x509name_to_s_old(self); else return x509name_print(self, NUM2ULONG(argv[0])); }
#to_utf8 ⇒ String
Returns an UTF-8 representation of the distinguished name, as specified in RFC 2253.
# File 'ext/openssl/ossl_x509name.c', line 314
static VALUE ossl_x509name_to_utf8(VALUE self) { VALUE str = x509name_print(self, XN_FLAG_RFC2253 & ~ASN1_STRFLGS_ESC_MSB); rb_enc_associate_index(str, rb_utf8_encindex()); return str; }