модуль SecureRandom

Интерфейс генератора случайных чисел.

Эта библиотека — интерфейс для генераторов случайных чисел, подходящих для генерации ключей сеансов в HTTP-куках и т. п.

Вы можете использовать эту библиотеку в своем приложении, импортировав её:

require 'securerandom'

Она поддерживает следующие генераторы случайных чисел:

openssl
/dev/urandom
Win32

SecureRandom расширяется модулем Random::Formatter, который определяет следующие методы:

alphanumeric
base64
choose
gen_random
hex
rand
random_bytes
random_number
urlsafe_base64
uuid

Эти методы можно использовать как методы класса SecureRandom, например, `SecureRandom.hex`.

Примеры

Генерация случайных шестнадцатеричных строк:

require 'securerandom'

SecureRandom.hex(10) #=> "52750b30ffbc7de3b362"
SecureRandom.hex(10) #=> "92b15d6c8dc4beb5f559"
SecureRandom.hex(13) #=> "39b290146bea6ce975c37cfc23"

Генерация случайных строк в формате base64:

SecureRandom.base64(10) #=> "EcmTPZwWRAozdA=="
SecureRandom.base64(10) #=> "KO1nIU+p9DKxGg=="
SecureRandom.base64(12) #=> "7kJSM/MzBJI+75j8"

Генерация случайных двоичных строк:

SecureRandom.random_bytes(10) #=> "\016\t{\370g\310pbr\301"
SecureRandom.random_bytes(10) #=> "\323U\030TO\234\357\020\a\337"

Генерация случайных буквенно-цифровых строк:

SecureRandom.alphanumeric(10) #=> "S8baxMJnPl"
SecureRandom.alphanumeric(10) #=> "aOxAg8BAJe"

Генерация UUID:

SecureRandom.uuid #=> "2d931510-d99f-494a-8c67-87feb05e1594"
SecureRandom.uuid #=> "bad85eb9-0713-4da7-8d36-07a8e4b00eab"

Публичные методы класса

bytes(n) Показать исходный код

# File lib/securerandom.rb, line 69
def bytes(n)
  return gen_random(n)
end

gen_random(n)

Псевдоним для: gen_random_openssl

Приватные методы класса

gen_random_openssl(n) Показать исходный код

# File lib/securerandom.rb, line 75
def gen_random_openssl(n)
  @pid = 0 unless defined?(@pid)
  pid = $$
  unless @pid == pid
    now = Process.clock_gettime(Process::CLOCK_REALTIME, :nanosecond)
    OpenSSL::Random.random_add([now, @pid, pid].join(""), 0.0)
    seed = Random.urandom(16)
    if (seed)
      OpenSSL::Random.random_add(seed, 16)
    end
    @pid = pid
  end
  return OpenSSL::Random.random_bytes(n)
end

Также псевдоним для: gen_random

gen_random_urandom(n) Показать исходный код

# File lib/securerandom.rb, line 90
def gen_random_urandom(n)
  ret = Random.urandom(n)
  unless ret
    raise NotImplementedError, "No random device"
  end
  unless ret.length == n
    raise NotImplementedError, "Unexpected partial read from random device: only #{ret.length} for #{n} bytes"
  end
  ret
end

Также псевдоним для: gen_random

Ruby Core © 1993–2020 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.