class OpenSSL::X509::StoreContext
Ein StoreContext wird während der Validierung eines einzelnen Zertifikats verwendet und speichert den Status, der daran beteiligt ist.
Öffentliche Klassenmethoden
Source
static VALUE
ossl_x509stctx_initialize(int argc, VALUE *argv, VALUE self)
{
VALUE store, cert, chain;
X509_STORE_CTX *ctx;
X509_STORE *x509st;
X509 *x509 = NULL;
STACK_OF(X509) *x509s = NULL;
int state;
rb_scan_args(argc, argv, "12", &store, &cert, &chain);
GetX509StCtx(self, ctx);
GetX509Store(store, x509st);
if (!NIL_P(cert))
x509 = DupX509CertPtr(cert); /* NEED TO DUP */
if (!NIL_P(chain)) {
x509s = ossl_protect_x509_ary2sk(chain, &state);
if (state) {
X509_free(x509);
rb_jump_tag(state);
}
}
if (X509_STORE_CTX_init(ctx, x509st, x509, x509s) != 1){
X509_free(x509);
sk_X509_pop_free(x509s, X509_free);
ossl_raise(eX509StoreError, "X509_STORE_CTX_init");
}
rb_iv_set(self, "@verify_callback", rb_iv_get(store, "@verify_callback"));
rb_iv_set(self, "@cert", cert);
return self;
}
Richtet einen StoreContext für die Überprüfung des X.509-Zertifikats cert ein.
Öffentliche Instanzmethoden
Source
static VALUE
ossl_x509stctx_get_chain(VALUE self)
{
X509_STORE_CTX *ctx;
const STACK_OF(X509) *chain;
GetX509StCtx(self, ctx);
chain = X509_STORE_CTX_get0_chain(ctx);
if (!chain)
return Qnil; /* Could be an empty array instead? */
return ossl_x509_sk2ary(chain);
}
Gibt die verifizierte Kette zurück.
Siehe auch die Manpage X509_STORE_CTX_set0_verified_chain(3).
Source
# File ext/openssl/lib/openssl/x509.rb, line 337 def cleanup warn "(#{caller.first}) OpenSSL::X509::StoreContext#cleanup is deprecated with no replacement" if $VERBOSE end
Source
static VALUE
ossl_x509stctx_get_curr_cert(VALUE self)
{
X509_STORE_CTX *ctx;
X509 *x509;
GetX509StCtx(self, ctx);
x509 = X509_STORE_CTX_get_current_cert(ctx);
if (!x509)
return Qnil;
return ossl_x509_new(x509);
}
Gibt das Zertifikat zurück, das den Fehler verursacht hat.
Siehe auch die Manpage X509_STORE_CTX_get_current_cert(3).
Source
static VALUE
ossl_x509stctx_get_curr_crl(VALUE self)
{
X509_STORE_CTX *ctx;
X509_CRL *crl;
GetX509StCtx(self, ctx);
crl = X509_STORE_CTX_get0_current_crl(ctx);
if (!crl)
return Qnil;
return ossl_x509crl_new(crl);
}
Gibt die CRL zurück, die den Fehler verursacht hat.
Siehe auch die Manpage X509_STORE_CTX_get_current_crl(3).
Source
static VALUE
ossl_x509stctx_get_err(VALUE self)
{
X509_STORE_CTX *ctx;
GetX509StCtx(self, ctx);
return INT2NUM(X509_STORE_CTX_get_error(ctx));
}
Gibt den Fehlercode von stctx zurück. Dies wird typischerweise nach Abschluss von verify oder aus dem an OpenSSL::X509::Store#verify_callback= übergebenen Verifikations-Callback aufgerufen.
Siehe auch die Manpage X509_STORE_CTX_get_error(3).
Source
static VALUE
ossl_x509stctx_set_error(VALUE self, VALUE err)
{
X509_STORE_CTX *ctx;
GetX509StCtx(self, ctx);
X509_STORE_CTX_set_error(ctx, NUM2INT(err));
return err;
}
Setzt den Fehlercode von stctx. Dies wird vom Verifikations-Callback verwendet, der an OpenSSL::X509::Store#verify_callback= übergeben wurde.
Siehe auch die Manpage X509_STORE_CTX_set_error(3).
Source
static VALUE
ossl_x509stctx_get_err_depth(VALUE self)
{
X509_STORE_CTX *ctx;
GetX509StCtx(self, ctx);
return INT2NUM(X509_STORE_CTX_get_error_depth(ctx));
}
Gibt die Tiefe der Kette zurück. Dies wird in Kombination mit error verwendet.
Siehe auch die Manpage X509_STORE_CTX_get_error_depth(3).
Source
static VALUE
ossl_x509stctx_get_err_string(VALUE self)
{
X509_STORE_CTX *ctx;
long err;
GetX509StCtx(self, ctx);
err = X509_STORE_CTX_get_error(ctx);
return rb_str_new2(X509_verify_cert_error_string(err));
}
Gibt die menschenlesbare Fehlermeldung zurück, die dem Fehlercode entspricht, der von error abgerufen wurde.
Siehe auch die Manpage X509_verify_cert_error_string(3).
Source
static VALUE
ossl_x509stctx_set_flags(VALUE self, VALUE flags)
{
X509_STORE_CTX *store;
long f = NUM2LONG(flags);
GetX509StCtx(self, store);
X509_STORE_CTX_set_flags(store, f);
return flags;
}
Setzt die Verifizierungsflags für den Kontext. Dies überschreibt den Standardwert, der von Store#flags= gesetzt wurde.
Siehe auch die Manpage X509_VERIFY_PARAM_set_flags(3).
Source
static VALUE
ossl_x509stctx_set_purpose(VALUE self, VALUE purpose)
{
X509_STORE_CTX *store;
int p = NUM2INT(purpose);
GetX509StCtx(self, store);
X509_STORE_CTX_set_purpose(store, p);
return purpose;
}
Setzt den Zweck des Kontexts. Dies überschreibt den Standardwert, der von Store#purpose= gesetzt wurde.
Siehe auch die Manpage X509_VERIFY_PARAM_set_purpose(3).
Source
static VALUE
ossl_x509stctx_set_time(VALUE self, VALUE time)
{
X509_STORE_CTX *store;
long t;
t = NUM2LONG(rb_Integer(time));
GetX509StCtx(self, store);
X509_STORE_CTX_set_time(store, 0, t);
return time;
}
Setzt die für die Verifizierung verwendete Zeit. Wenn nicht gesetzt, wird die aktuelle Zeit verwendet.
Siehe auch die Manpage X509_VERIFY_PARAM_set_time(3).
Source
static VALUE
ossl_x509stctx_set_trust(VALUE self, VALUE trust)
{
X509_STORE_CTX *store;
int t = NUM2INT(trust);
GetX509StCtx(self, store);
X509_STORE_CTX_set_trust(store, t);
return trust;
}
Setzt die Vertrauenskonfiguration des Kontexts. Dies überschreibt den Standardwert, der von Store#trust= gesetzt wurde.
Siehe auch die Manpage X509_VERIFY_PARAM_set_trust(3).
Source
static VALUE
ossl_x509stctx_verify(VALUE self)
{
X509_STORE_CTX *ctx;
GetX509StCtx(self, ctx);
VALUE cb = rb_iv_get(self, "@verify_callback");
X509_STORE_CTX_set_ex_data(ctx, stctx_ex_verify_cb_idx, (void *)cb);
RB_OBJ_WRITTEN(self, Qundef, cb);
switch (X509_verify_cert(ctx)) {
case 1:
return Qtrue;
case 0:
ossl_clear_error();
return Qfalse;
default:
ossl_raise(eX509StoreError, "X509_verify_cert");
}
}
Führt die Zertifikatsverifizierung unter Verwendung der für stctx gesetzten Parameter durch.
Siehe auch die Manpage X509_verify_cert(3).