| 1 | package Crypt::PRNG::Fortuna; | ||||||||||||||||||||||||||||
| 2 | |||||||||||||||||||||||||||||
| 3 | 3 | ▶ | use strict; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 4 | 3 | ▶ | use warnings; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 5 | 3 | our $VERSION = '0.091'; | |||||||||||||||||||||||||||
| 6 | |||||||||||||||||||||||||||||
| 7 | 3 | ▶ | use base qw(Crypt::PRNG Exporter); | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 8 | 3 | our %EXPORT_TAGS = ( all => [qw(random_bytes random_bytes_hex random_bytes_b64 random_bytes_b64u random_string random_string_from rand irand)] ); | |||||||||||||||||||||||||||
| 9 | 3 | our @EXPORT_OK = ( @{ $EXPORT_TAGS{'all'} } ); | |||||||||||||||||||||||||||
| 10 | 3 | our @EXPORT = qw(); | |||||||||||||||||||||||||||
| 11 | |||||||||||||||||||||||||||||
| 12 | 3 | ▶ | use CryptX; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 13 | |||||||||||||||||||||||||||||
| 14 | 5 | ▶ | sub new { | ||||||||||||||||||||||||||
|
Subroutine
new: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||||||||||||||||||
| 15 | 5 | my ($class, @args) = @_; | |||||||||||||||||||||||||||
| 16 | 5 | my $obj = Crypt::PRNG->new('Fortuna', @args); | |||||||||||||||||||||||||||
| 17 | 5 | return bless $obj, $class; | |||||||||||||||||||||||||||
| 18 | } | ||||||||||||||||||||||||||||
| 19 | |||||||||||||||||||||||||||||
| 20 | { | ||||||||||||||||||||||||||||
| 21 | ### stolen from Bytes::Random::Secure | ||||||||||||||||||||||||||||
| 22 | 3 | my $RNG_object = undef; | |||||||||||||||||||||||||||
| 23 | 3006 | ▶ | my $fetch_RNG = sub { # Lazily, instantiate the RNG object, but only once. | ||||||||||||||||||||||||||
|
Subroutine
__ANON__: called CC=3 SCAR=11.1
| |||||||||||||||||||||||||||||
| 24 | 3006 | ▶ | $RNG_object = Crypt::PRNG::Fortuna->new unless defined $RNG_object && ref($RNG_object) ne 'SCALAR'; | ||||||||||||||||||||||||||
|
Branch: 1 branch
Condition66%2/3
defined $RNG_object and ref $RNG_object ne "SCALAR"
MC/DC50%1/2
defined $RNG_object and ref $RNG_object ne "SCALAR"
defined $RNG_object
ref $RNG_object ne "SCALAR"
Truth table66%2/3
A and B
A= defined $RNG_objectB= ref $RNG_object ne "SCALAR"
| |||||||||||||||||||||||||||||
| 25 | 3006 | return $RNG_object; | |||||||||||||||||||||||||||
| 26 | 3 | }; | |||||||||||||||||||||||||||
| 27 | 2000 | ▶ | sub rand { return $fetch_RNG->()->double(@_) } | ||||||||||||||||||||||||||
|
Subroutine
rand: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||||||||||||||||||
| 28 | 1000 | ▶ | sub irand { return $fetch_RNG->()->int32(@_) } | ||||||||||||||||||||||||||
|
Subroutine
irand: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||||||||||||||||||
| 29 | 1 | ▶ | sub random_bytes { return $fetch_RNG->()->bytes(@_) } | ||||||||||||||||||||||||||
|
Subroutine
random_bytes: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||||||||||||||||||
| 30 | 1 | ▶ | sub random_bytes_hex { return $fetch_RNG->()->bytes_hex(@_) } | ||||||||||||||||||||||||||
|
Subroutine
random_bytes_hex: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||||||||||||||||||
| 31 | 1 | ▶ | sub random_bytes_b64 { return $fetch_RNG->()->bytes_b64(@_) } | ||||||||||||||||||||||||||
|
Subroutine
random_bytes_b64: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||||||||||||||||||
| 32 | 1 | ▶ | sub random_bytes_b64u { return $fetch_RNG->()->bytes_b64u(@_) } | ||||||||||||||||||||||||||
|
Subroutine
random_bytes_b64u: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||||||||||||||||||
| 33 | 1 | ▶ | sub random_string_from { return $fetch_RNG->()->string_from(@_) } | ||||||||||||||||||||||||||
|
Subroutine
random_string_from: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||||||||||||||||||
| 34 | 1 | ▶ | sub random_string { return $fetch_RNG->()->string(@_) } | ||||||||||||||||||||||||||
|
Subroutine
random_string: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||||||||||||||||||
| 35 | } | ||||||||||||||||||||||||||||
| 36 | |||||||||||||||||||||||||||||
| 37 | |||||||||||||||||||||||||||||
| 38 | 3 | 1; | |||||||||||||||||||||||||||
| 39 | |||||||||||||||||||||||||||||
| 40 | =pod | ||||||||||||||||||||||||||||
| 41 | |||||||||||||||||||||||||||||
| 42 | =head1 NAME | ||||||||||||||||||||||||||||
| 43 | |||||||||||||||||||||||||||||
| 44 | Crypt::PRNG::Fortuna - Cryptographically secure PRNG based on Fortuna algorithm | ||||||||||||||||||||||||||||
| 45 | |||||||||||||||||||||||||||||
| 46 | =head1 SYNOPSIS | ||||||||||||||||||||||||||||
| 47 | |||||||||||||||||||||||||||||
| 48 | ### Functional interface: | ||||||||||||||||||||||||||||
| 49 | use Crypt::PRNG::Fortuna qw(random_bytes random_bytes_hex random_bytes_b64 random_bytes_b64u | ||||||||||||||||||||||||||||
| 50 | random_string random_string_from rand irand); | ||||||||||||||||||||||||||||
| 51 | |||||||||||||||||||||||||||||
| 52 | my $octets = random_bytes(45); | ||||||||||||||||||||||||||||
| 53 | my $hex_string = random_bytes_hex(45); | ||||||||||||||||||||||||||||
| 54 | my $base64_string = random_bytes_b64(45); | ||||||||||||||||||||||||||||
| 55 | my $base64url_string = random_bytes_b64u(45); | ||||||||||||||||||||||||||||
| 56 | my $alphanumeric_string = random_string(30); | ||||||||||||||||||||||||||||
| 57 | my $string = random_string_from('ACGT', 64); | ||||||||||||||||||||||||||||
| 58 | my $floating_point_number_0_to_1 = rand; | ||||||||||||||||||||||||||||
| 59 | my $floating_point_number_0_to_88 = rand(88); | ||||||||||||||||||||||||||||
| 60 | my $unsigned_32bit_int = irand; | ||||||||||||||||||||||||||||
| 61 | |||||||||||||||||||||||||||||
| 62 | ### OO interface: | ||||||||||||||||||||||||||||
| 63 | use Crypt::PRNG::Fortuna; | ||||||||||||||||||||||||||||
| 64 | |||||||||||||||||||||||||||||
| 65 | my $prng = Crypt::PRNG::Fortuna->new; | ||||||||||||||||||||||||||||
| 66 | my $seeded_prng = Crypt::PRNG::Fortuna->new("some data used for seeding PRNG"); | ||||||||||||||||||||||||||||
| 67 | |||||||||||||||||||||||||||||
| 68 | my $octets = $prng->bytes(45); | ||||||||||||||||||||||||||||
| 69 | my $hex_string = $prng->bytes_hex(45); | ||||||||||||||||||||||||||||
| 70 | my $base64_string = $prng->bytes_b64(45); | ||||||||||||||||||||||||||||
| 71 | my $base64url_string = $prng->bytes_b64u(45); | ||||||||||||||||||||||||||||
| 72 | my $alphanumeric_string = $prng->string(30); | ||||||||||||||||||||||||||||
| 73 | my $string = $prng->string_from('ACGT', 64); | ||||||||||||||||||||||||||||
| 74 | my $floating_point_number_0_to_1 = $prng->double; | ||||||||||||||||||||||||||||
| 75 | my $floating_point_number_0_to_88 = $prng->double(88); | ||||||||||||||||||||||||||||
| 76 | my $unsigned_32bit_int = $prng->int32; | ||||||||||||||||||||||||||||
| 77 | |||||||||||||||||||||||||||||
| 78 | =head1 DESCRIPTION | ||||||||||||||||||||||||||||
| 79 | |||||||||||||||||||||||||||||
| 80 | Provides an interface to the Fortuna-based pseudo-random number generator. | ||||||||||||||||||||||||||||
| 81 | |||||||||||||||||||||||||||||
| 82 | This is a thin wrapper around L<Crypt::PRNG> with the algorithm fixed to | ||||||||||||||||||||||||||||
| 83 | Fortuna. All functions and methods accept the same arguments and return the | ||||||||||||||||||||||||||||
| 84 | same values as the corresponding L<Crypt::PRNG> entries. | ||||||||||||||||||||||||||||
| 85 | |||||||||||||||||||||||||||||
| 86 | =head1 EXPORT | ||||||||||||||||||||||||||||
| 87 | |||||||||||||||||||||||||||||
| 88 | Nothing is exported by default. | ||||||||||||||||||||||||||||
| 89 | |||||||||||||||||||||||||||||
| 90 | You can export selected functions: | ||||||||||||||||||||||||||||
| 91 | |||||||||||||||||||||||||||||
| 92 | use Crypt::PRNG::Fortuna qw(random_bytes random_string); | ||||||||||||||||||||||||||||
| 93 | |||||||||||||||||||||||||||||
| 94 | Or all of them at once: | ||||||||||||||||||||||||||||
| 95 | |||||||||||||||||||||||||||||
| 96 | use Crypt::PRNG::Fortuna ':all'; | ||||||||||||||||||||||||||||
| 97 | |||||||||||||||||||||||||||||
| 98 | =head1 FUNCTIONS | ||||||||||||||||||||||||||||
| 99 | |||||||||||||||||||||||||||||
| 100 | All functions below behave exactly like the corresponding L<Crypt::PRNG> | ||||||||||||||||||||||||||||
| 101 | functions, but use a hidden C<Crypt::PRNG::Fortuna> object internally. | ||||||||||||||||||||||||||||
| 102 | |||||||||||||||||||||||||||||
| 103 | =head2 random_bytes | ||||||||||||||||||||||||||||
| 104 | |||||||||||||||||||||||||||||
| 105 | See L<Crypt::PRNG/random_bytes>. | ||||||||||||||||||||||||||||
| 106 | |||||||||||||||||||||||||||||
| 107 | =head2 random_bytes_hex | ||||||||||||||||||||||||||||
| 108 | |||||||||||||||||||||||||||||
| 109 | See L<Crypt::PRNG/random_bytes_hex>. | ||||||||||||||||||||||||||||
| 110 | |||||||||||||||||||||||||||||
| 111 | =head2 random_bytes_b64 | ||||||||||||||||||||||||||||
| 112 | |||||||||||||||||||||||||||||
| 113 | See L<Crypt::PRNG/random_bytes_b64>. | ||||||||||||||||||||||||||||
| 114 | |||||||||||||||||||||||||||||
| 115 | =head2 random_bytes_b64u | ||||||||||||||||||||||||||||
| 116 | |||||||||||||||||||||||||||||
| 117 | See L<Crypt::PRNG/random_bytes_b64u>. | ||||||||||||||||||||||||||||
| 118 | |||||||||||||||||||||||||||||
| 119 | =head2 random_string | ||||||||||||||||||||||||||||
| 120 | |||||||||||||||||||||||||||||
| 121 | See L<Crypt::PRNG/random_string>. | ||||||||||||||||||||||||||||
| 122 | |||||||||||||||||||||||||||||
| 123 | =head2 random_string_from | ||||||||||||||||||||||||||||
| 124 | |||||||||||||||||||||||||||||
| 125 | See L<Crypt::PRNG/random_string_from>. | ||||||||||||||||||||||||||||
| 126 | |||||||||||||||||||||||||||||
| 127 | =head2 rand | ||||||||||||||||||||||||||||
| 128 | |||||||||||||||||||||||||||||
| 129 | See L<Crypt::PRNG/rand>. | ||||||||||||||||||||||||||||
| 130 | |||||||||||||||||||||||||||||
| 131 | =head2 irand | ||||||||||||||||||||||||||||
| 132 | |||||||||||||||||||||||||||||
| 133 | See L<Crypt::PRNG/irand>. | ||||||||||||||||||||||||||||
| 134 | |||||||||||||||||||||||||||||
| 135 | =head1 METHODS | ||||||||||||||||||||||||||||
| 136 | |||||||||||||||||||||||||||||
| 137 | Unless noted otherwise, assume C<$prng> is an existing | ||||||||||||||||||||||||||||
| 138 | C<Crypt::PRNG::Fortuna> object created via C<new>. | ||||||||||||||||||||||||||||
| 139 | |||||||||||||||||||||||||||||
| 140 | =head2 new | ||||||||||||||||||||||||||||
| 141 | |||||||||||||||||||||||||||||
| 142 | my $prng = Crypt::PRNG::Fortuna->new; | ||||||||||||||||||||||||||||
| 143 | my $seeded_prng = Crypt::PRNG::Fortuna->new($seed); | ||||||||||||||||||||||||||||
| 144 | |||||||||||||||||||||||||||||
| 145 | Creates a PRNG object using the Fortuna algorithm. If C<$seed> is omitted, the | ||||||||||||||||||||||||||||
| 146 | object is automatically seeded by the underlying L<Crypt::PRNG> logic. | ||||||||||||||||||||||||||||
| 147 | |||||||||||||||||||||||||||||
| 148 | =head2 bytes | ||||||||||||||||||||||||||||
| 149 | |||||||||||||||||||||||||||||
| 150 | See L<Crypt::PRNG/bytes>. | ||||||||||||||||||||||||||||
| 151 | |||||||||||||||||||||||||||||
| 152 | =head2 bytes_hex | ||||||||||||||||||||||||||||
| 153 | |||||||||||||||||||||||||||||
| 154 | See L<Crypt::PRNG/bytes_hex>. | ||||||||||||||||||||||||||||
| 155 | |||||||||||||||||||||||||||||
| 156 | =head2 bytes_b64 | ||||||||||||||||||||||||||||
| 157 | |||||||||||||||||||||||||||||
| 158 | See L<Crypt::PRNG/bytes_b64>. | ||||||||||||||||||||||||||||
| 159 | |||||||||||||||||||||||||||||
| 160 | =head2 bytes_b64u | ||||||||||||||||||||||||||||
| 161 | |||||||||||||||||||||||||||||
| 162 | See L<Crypt::PRNG/bytes_b64u>. | ||||||||||||||||||||||||||||
| 163 | |||||||||||||||||||||||||||||
| 164 | =head2 string | ||||||||||||||||||||||||||||
| 165 | |||||||||||||||||||||||||||||
| 166 | See L<Crypt::PRNG/string>. | ||||||||||||||||||||||||||||
| 167 | |||||||||||||||||||||||||||||
| 168 | =head2 string_from | ||||||||||||||||||||||||||||
| 169 | |||||||||||||||||||||||||||||
| 170 | See L<Crypt::PRNG/string_from>. | ||||||||||||||||||||||||||||
| 171 | |||||||||||||||||||||||||||||
| 172 | =head2 double | ||||||||||||||||||||||||||||
| 173 | |||||||||||||||||||||||||||||
| 174 | See L<Crypt::PRNG/double>. | ||||||||||||||||||||||||||||
| 175 | |||||||||||||||||||||||||||||
| 176 | =head2 int32 | ||||||||||||||||||||||||||||
| 177 | |||||||||||||||||||||||||||||
| 178 | See L<Crypt::PRNG/int32>. | ||||||||||||||||||||||||||||
| 179 | |||||||||||||||||||||||||||||
| 180 | =head1 SEE ALSO | ||||||||||||||||||||||||||||
| 181 | |||||||||||||||||||||||||||||
| 182 | =over | ||||||||||||||||||||||||||||
| 183 | |||||||||||||||||||||||||||||
| 184 | =item * L<Crypt::PRNG> | ||||||||||||||||||||||||||||
| 185 | |||||||||||||||||||||||||||||
| 186 | =item * L<https://en.wikipedia.org/wiki/Fortuna_%28PRNG%29> | ||||||||||||||||||||||||||||
| 187 | |||||||||||||||||||||||||||||
| 188 | =back | ||||||||||||||||||||||||||||
| 189 | |||||||||||||||||||||||||||||
| 190 | =cut | ||||||||||||||||||||||||||||