123456789_123456789_123456789_123456789_123456789_

Class: OpenSSL::Timestamp::Request

Relationships & Source Files
Inherits: Object
Defined in: ext/openssl/ossl_ts.c

Overview

Allows to create timestamp requests or parse existing ones. A Request is also needed for creating timestamps from scratch with Factory. When created from scratch, some default values are set:

  • version is set to 1

  • cert_requested is set to true

  • algorithm, message_imprint, policy_id, and nonce are set to false

Class Method Summary

  • .new(file) ⇒ Request constructor

    When creating a Request with the File or string parameter, the corresponding File or string must be DER-encoded.

Instance Attribute Summary

Instance Method Summary

Constructor Details

.new(file) ⇒ Request .new(string) ⇒ Request .newRequest

When creating a Request with the File or string parameter, the corresponding File or string must be DER-encoded.

[ GitHub ]

  
# File 'ext/openssl/ossl_ts.c', line 193

static VALUE
ossl_ts_req_initialize(int argc, VALUE *argv, VALUE self)
{
    TS_REQ *ts_req = DATA_PTR(self);
    BIO *in;
    VALUE arg;

    if(rb_scan_args(argc, argv, "01", &arg) == 0) {
        return self;
    }

    arg = ossl_to_der_if_possible(arg);
    in = ossl_obj2bio(&arg);
    ts_req = d2i_TS_REQ_bio(in, &ts_req);
    BIO_free(in);
    if (!ts_req) {
        DATA_PTR(self) = NULL;
        ossl_raise(eTimestampError, "Error when decoding the timestamp request");
    }
    DATA_PTR(self) = ts_req;

    return self;
}

Instance Attribute Details

#algorithmString (rw)

Returns the ‘short name’ of the object identifier that represents the algorithm that was used to create the message imprint digest.

[ GitHub ]

  
# File 'ext/openssl/ossl_ts.c', line 224

static VALUE
ossl_ts_req_get_algorithm(VALUE self)
{
    TS_REQ *req;
    TS_MSG_IMPRINT *mi;
    X509_ALGOR *algor;

    GetTSRequest(self, req);
    mi = TS_REQ_get_msg_imprint(req);
    algor = TS_MSG_IMPRINT_get_algo(mi);
    return get_asn1obj(algor->algorithm);
}

#algorithm=("string") ⇒ String (rw)

Allows to set the object identifier or the ‘short name’ of the algorithm that was used to create the message imprint digest.

Example:

request.algorithm = "SHA1"
[ GitHub ]

  
# File 'ext/openssl/ossl_ts.c', line 247

static VALUE
ossl_ts_req_set_algorithm(VALUE self, VALUE algo)
{
    TS_REQ *req;
    TS_MSG_IMPRINT *mi;
    ASN1_OBJECT *obj;
    X509_ALGOR *algor;

    GetTSRequest(self, req);
    obj = obj_to_asn1obj(algo);
    mi = TS_REQ_get_msg_imprint(req);
    algor = TS_MSG_IMPRINT_get_algo(mi);
    if (!X509_ALGOR_set0(algor, obj, V_ASN1_NULL, NULL)) {
        ASN1_OBJECT_free(obj);
        ossl_raise(eTimestampError, "X509_ALGOR_set0");
    }

    return algo;
}

#cert_requested=(boolean) ⇒ Boolean (rw)

Specify whether the response shall contain the timestamp authority’s certificate or not. The default value is true.

[ GitHub ]

  
# File 'ext/openssl/ossl_ts.c', line 461

static VALUE
ossl_ts_req_set_cert_requested(VALUE self, VALUE requested)
{
    TS_REQ *req;

    GetTSRequest(self, req);
    TS_REQ_set_cert_req(req, RTEST(requested));

    return requested;
}

#cert_requested?Boolean (rw)

Indicates whether the response shall contain the timestamp authority’s certificate or not.

[ GitHub ]

  
# File 'ext/openssl/ossl_ts.c', line 445

static VALUE
ossl_ts_req_get_cert_requested(VALUE self)
{
    TS_REQ *req;

    GetTSRequest(self, req);
    return TS_REQ_get_cert_req(req) ? Qtrue: Qfalse;
}

#message_imprintString? (rw)

Returns the message imprint (digest) of the data to be timestamped.

[ GitHub ]

  
# File 'ext/openssl/ossl_ts.c', line 273

static VALUE
ossl_ts_req_get_msg_imprint(VALUE self)
{
    TS_REQ *req;
    TS_MSG_IMPRINT *mi;
    ASN1_OCTET_STRING *hashed_msg;
    VALUE ret;

    GetTSRequest(self, req);
    mi = TS_REQ_get_msg_imprint(req);
    hashed_msg = TS_MSG_IMPRINT_get_msg(mi);

    ret = rb_str_new((const char *)hashed_msg->data, hashed_msg->length);

    return ret;
}

#message_imprint=("string") ⇒ String (rw)

Set the message imprint digest.

[ GitHub ]

  
# File 'ext/openssl/ossl_ts.c', line 296

static VALUE
ossl_ts_req_set_msg_imprint(VALUE self, VALUE hash)
{
    TS_REQ *req;
    TS_MSG_IMPRINT *mi;
    StringValue(hash);

    GetTSRequest(self, req);
    mi = TS_REQ_get_msg_imprint(req);
    if (!TS_MSG_IMPRINT_set_msg(mi, (unsigned char *)RSTRING_PTR(hash), RSTRING_LENINT(hash)))
        ossl_raise(eTimestampError, "TS_MSG_IMPRINT_set_msg");

    return hash;
}

#nonceBN? (rw)

Returns the nonce (number used once) that the server shall include in its response.

[ GitHub ]

  
# File 'ext/openssl/ossl_ts.c', line 402

static VALUE
ossl_ts_req_get_nonce(VALUE self)
{
    TS_REQ *req;
    const ASN1_INTEGER * nonce;

    GetTSRequest(self, req);
    if (!(nonce = TS_REQ_get_nonce(req)))
        return Qnil;
    return asn1integer_to_num(nonce);
}

#nonce=(number) ⇒ BN (rw)

Sets the nonce (number used once) that the server shall include in its response. If the nonce is set, the server must return the same nonce value in a valid Response.

[ GitHub ]

  
# File 'ext/openssl/ossl_ts.c', line 422

static VALUE
ossl_ts_req_set_nonce(VALUE self, VALUE num)
{
    TS_REQ *req;
    ASN1_INTEGER *nonce;
    int ok;

    GetTSRequest(self, req);
    nonce = num_to_asn1integer(num, NULL);
    ok = TS_REQ_set_nonce(req, nonce);
    ASN1_INTEGER_free(nonce);
    if (!ok)
        ossl_raise(eTimestampError, NULL);
    return num;
}

#policy_idString? (rw)

Returns the ‘short name’ of the object identifier that represents the timestamp policy under which the server shall create the timestamp.

[ GitHub ]

  
# File 'ext/openssl/ossl_ts.c', line 355

static VALUE
ossl_ts_req_get_policy_id(VALUE self)
{
    TS_REQ *req;

    GetTSRequest(self, req);
    if (!TS_REQ_get_policy_id(req))
        return Qnil;
    return get_asn1obj(TS_REQ_get_policy_id(req));
}

#policy_id=("string") ⇒ String (rw)

Allows to set the object identifier that represents the timestamp policy under which the server shall create the timestamp. This may be left nil, implying that the timestamp server will issue the timestamp using some default policy.

Example:

request.policy_id = "1.2.3.4.5"
[ GitHub ]

  
# File 'ext/openssl/ossl_ts.c', line 378

static VALUE
ossl_ts_req_set_policy_id(VALUE self, VALUE oid)
{
    TS_REQ *req;
    ASN1_OBJECT *obj;
    int ok;

    GetTSRequest(self, req);
    obj = obj_to_asn1obj(oid);
    ok = TS_REQ_set_policy_id(req, obj);
    ASN1_OBJECT_free(obj);
    if (!ok)
        ossl_raise(eTimestampError, "TS_REQ_set_policy_id");

    return oid;
}

#versionInteger (rw)

Returns the version of this request. 1 is the default value.

[ GitHub ]

  
# File 'ext/openssl/ossl_ts.c', line 317

static VALUE
ossl_ts_req_get_version(VALUE self)
{
    TS_REQ *req;

    GetTSRequest(self, req);
    return LONG2NUM(TS_REQ_get_version(req));
}

#version=(number) ⇒ Integer (rw)

Sets the version number for this Request. This should be 1 for compliant servers.

[ GitHub ]

  
# File 'ext/openssl/ossl_ts.c', line 333

static VALUE
ossl_ts_req_set_version(VALUE self, VALUE version)
{
    TS_REQ *req;
    long ver;

    if ((ver = NUM2LONG(version)) < 0)
        ossl_raise(eTimestampError, "version must be >= 0!");
    GetTSRequest(self, req);
    if (!TS_REQ_set_version(req, ver))
        ossl_raise(eTimestampError, "TS_REQ_set_version");

    return version;
}

Instance Method Details

#to_derDER-encoded string

DER-encodes this Request.

[ GitHub ]

  
# File 'ext/openssl/ossl_ts.c', line 478

static VALUE
ossl_ts_req_to_der(VALUE self)
{
    TS_REQ *req;
    TS_MSG_IMPRINT *mi;
    X509_ALGOR *algo;
    ASN1_OCTET_STRING *hashed_msg;

    GetTSRequest(self, req);
    mi = TS_REQ_get_msg_imprint(req);

    algo = TS_MSG_IMPRINT_get_algo(mi);
    if (OBJ_obj2nid(algo->algorithm) == NID_undef)
        ossl_raise(eTimestampError, "Message imprint missing algorithm");

    hashed_msg = TS_MSG_IMPRINT_get_msg(mi);
    if (!hashed_msg->length)
        ossl_raise(eTimestampError, "Message imprint missing hashed message");

    return asn1_to_der((void *)req, (int (*)(void *, unsigned char **))i2d_TS_REQ);
}