Crypt::Rainbow - Crypt::CBC-compliant block cipher


Crypt-Rainbow documentation Contained in the Crypt-Rainbow distribution.

Index


Code Index:

NAME

Top

Crypt::Rainbow - Crypt::CBC-compliant block cipher

ABSTRACT

Top

Rainbow is 128-bit block cipher that accepts a 128-bit key. Designed by Chang-Hyi Lee and Jeong-Soo Kim of Samsung Advanced Institute of Technology, Rainbow is similar to the block ciphers Square and Shark.

SYNOPSIS

Top

    use Crypt::Rainbow;

    $cipher = new Crypt::Rainbow $key;
    $ciphertext = $cipher->encrypt($plaintext);
    $plaintext  = $cipher->decrypt($ciphertext);

DESCRIPTION

Top

Rainbow is 128-bit block cipher that accepts a 128-bit key. Designed by Chang-Hyi Lee and Jeong-Soo Kim of Samsung Advanced Institute of Technology, Rainbow is similar to the block ciphers Square and Shark.

Rainbow was submitted as an AES candidate but was rejected because it was deemed not ``complete and proper'', based on the requirements specified by NIST in the Federal Register on September 12, 1997.

This module supports the Crypt::CBC interface, with the following functions.

Functions

blocksize

Returns the size (in bytes) of the block (16, in this case).

keysize

Returns the size (in bytes) of the key (16, in this case).

encrypt($data)

Encrypts 16 bytes of $data and returns the corresponding ciphertext.

decrypt($data)

Decrypts 16 bytes of $data and returns the corresponding plaintext.

EXAMPLE 1

Top

    #!/usr/local/bin/perl

    use diagnostics;
    use strict;
    use warnings;
    use Crypt::Rainbow;

    # key must be 16 bytes long
    my $key = "0123456789abcdef";

    my $cipher = new Crypt::Rainbow $key;

    print "blocksize = ", $cipher->blocksize, " bytes \n";
    print "keysize = ", $cipher->keysize, " bytes \n";

    # block must be 16 bytes long
    my $plaintext1 = "0123456789abcdef";

    my $ciphertext = $cipher->encrypt($plaintext1);
    my $plaintext2 = $cipher->decrypt($ciphertext);

    print "Decryption OK\n" if ($plaintext1 eq $plaintext2);

EXAMPLE 2

Top

    #!/usr/local/bin/perl

    use diagnostics;
    use strict;
    use warnings;
    use Crypt::CBC;  # CBC automatically loads Rainbow for us

    # when using Crypt::CBC, key may be of ANY length
    my $key = "0123456789abcdef";

    # IV must be exactly 16 bytes long
    my $IV = pack "H32", 0;

    my $cipher = Crypt::CBC->new({'key' => $key,
                                  'cipher' => 'Rainbow',
                                  'iv' => $IV,
                                  'regenerate_key' => 1,
                                  'padding' => 'standard',
                                  'prepend_iv' => 0
                                });

    # when using Crypt::CBC, plaintext may be of ANY length
    my $plaintext1 = "This is a test";

    my $ciphertext = $cipher->encrypt($plaintext1);
    my $plaintext2 = $cipher->decrypt($ciphertext);

    print "Decryption OK\n" if ($plaintext1 eq $plaintext2);

MORE EXAMPLES

Top

See Crypt::CBC for more examples using CBC mode. See also the "examples" and "t" directories for some more examples.

SEE ALSO

Top

Crypt::Khazad, Crypt::Misty1, Crypt::Anubis, Crypt::Noekeon, Crypt::Skipjack, Crypt::Camellia, and Crypt::Square.

COPYRIGHT AND LICENSE

Top


Crypt-Rainbow documentation Contained in the Crypt-Rainbow distribution.

package Crypt::Rainbow;

use strict;
use warnings;
require Exporter;

our @EXPORT_OK = qw(keysize blocksize new encrypt decrypt);
our $VERSION = '1.0.0';
our @ISA = qw(Exporter);

require XSLoader;
XSLoader::load('Crypt::Rainbow', $VERSION);

# Preloaded methods go here.

1;

__END__