module OpenSSL::Random
Öffentliche Klassenmethoden
Source
static VALUE
ossl_rand_egd(VALUE self, VALUE filename)
{
if (RAND_egd(StringValueCStr(filename)) == -1) {
ossl_raise(eRandomError, NULL);
}
return Qtrue;
}
Das Gleiche wie ::egd_bytes, aber fragt standardmäßig 255 Bytes ab.
Source
static VALUE
ossl_rand_egd_bytes(VALUE self, VALUE filename, VALUE len)
{
int n = NUM2INT(len);
if (RAND_egd_bytes(StringValueCStr(filename), n) == -1) {
ossl_raise(eRandomError, NULL);
}
return Qtrue;
}
Fragt den Entropy Gathering Daemon EGD auf dem Socket-Pfad, der durch filename gegeben ist, ab.
Holt length Bytes und verwendet ::add, um den eingebauten PRNG von OpenSSL zu seeden.
Source
static VALUE
ossl_rand_load_file(VALUE self, VALUE filename)
{
if(!RAND_load_file(StringValueCStr(filename), -1)) {
ossl_raise(eRandomError, NULL);
}
return Qtrue;
}
Liest Bytes aus filename und fügt sie dem PRNG hinzu.
Source
static VALUE
ossl_rand_add(VALUE self, VALUE str, VALUE entropy)
{
StringValue(str);
RAND_add(RSTRING_PTR(str), RSTRING_LENINT(str), NUM2DBL(entropy));
return self;
}
Mischt die Bytes aus str in den Zustand des Pseudo-Zufallszahlengenerators (PRNG) ein.
Wenn die Daten aus str für einen Angreifer unvorhersehbar sind, erhöht dies die Unsicherheit über den Zustand und macht die PRNG-Ausgabe weniger vorhersagbar.
Das Argument entropy ist die (untere Grenze) einer Schätzung, wie viel Zufälligkeit in str enthalten ist, gemessen in Bytes.
Beispiel
pid = $$ now = Time.now ary = [now.to_i, now.nsec, 1000, pid] OpenSSL::Random.add(ary.join, 0.0) OpenSSL::Random.seed(ary.join)
Source
static VALUE
ossl_rand_bytes(VALUE self, VALUE len)
{
VALUE str;
int n = NUM2INT(len);
int ret;
str = rb_str_new(0, n);
ret = RAND_bytes((unsigned char *)RSTRING_PTR(str), n);
if (ret == 0) {
ossl_raise(eRandomError, "RAND_bytes");
} else if (ret == -1) {
ossl_raise(eRandomError, "RAND_bytes is not supported");
}
return str;
}
Source
static VALUE
ossl_rand_seed(VALUE self, VALUE str)
{
StringValue(str);
RAND_seed(RSTRING_PTR(str), RSTRING_LENINT(str));
return str;
}
::seed ist äquivalent zu ::add, wobei entropy die Länge von str ist.
Source
static VALUE
ossl_rand_status(VALUE self)
{
return RAND_status() ? Qtrue : Qfalse;
}
Gibt true zurück, wenn der PRNG mit genügend Daten geseedet wurde, andernfalls false.
Source
static VALUE
ossl_rand_write_file(VALUE self, VALUE filename)
{
if (RAND_write_file(StringValueCStr(filename)) == -1) {
ossl_raise(eRandomError, NULL);
}
return Qtrue;
}
Schreibt eine Anzahl von zufällig generierten Bytes (derzeit 1024) in filename, die verwendet werden können, um den PRNG durch Aufrufen von ::load_random_file in einer späteren Sitzung zu initialisieren.