min
/
boring2
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

AES Module level docs and example

This commit is contained in:
Andy Gauge 2017-09-26 16:34:06 -07:00
parent b07b0e7fb7
commit afde5a84b1
1 changed files with 20 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
openssl/src/aes.rs
View File

@ -6,6 +6,10 @@
//! create a new key with [`new_encrypt`] and perform an encryption/decryption //! create a new key with [`new_encrypt`] and perform an encryption/decryption
//! using that key with [`aes_ige`]. //! using that key with [`aes_ige`].
//! //!
//! AES is a 128-bit (16 byte) block cipher. The rust implmentation will panic
//! if the input or output does not meet this 16-byte boundry. Attention must
//! be made in this low level implementation to pad the value to the 128-bit boundry.
//!
//! [`new_encrypt`]: struct.AesKey.html#method.new_encrypt //! [`new_encrypt`]: struct.AesKey.html#method.new_encrypt
//! [`aes_ige`]: fn.aes_ige.html //! [`aes_ige`]: fn.aes_ige.html
//! //!
@ -18,17 +22,26 @@
//! ```rust //! ```rust
//! # extern crate openssl; //! # extern crate openssl;
//! extern crate hex; //! extern crate hex;
//! use openssl::aes::{AesKey, KeyError}; //! use openssl::aes::{AesKey, KeyError, aes_ige};
//! use hex::FromHex; //! use openssl::symm::Mode;
//! use hex::{FromHex, ToHex};
//! //!
//! fn decrypt() -> Result<(), KeyError> { //! fn decrypt() -> Result<(), KeyError> {
//! let raw_key = "000102030405060708090A0B0C0D0E0F"; //! let raw_key = "000102030405060708090A0B0C0D0E0F";
//! let key = AesKey::new_encrypt(&Vec::from_hex(raw_key).unwrap())?; //! let hex_cipher = "12345678901234561234567890123456";
//! Ok(()) //! let randomness = "000102030405060708090A0B0C0D0E0F101112131415161718191A1B1C1D1E1F";
//! if let (Ok(key_as_u8), Ok(cipher_as_u8), Ok(mut iv_as_u8)) =
//! (Vec::from_hex(raw_key), Vec::from_hex(hex_cipher), Vec::from_hex(randomness)) {
//! let key = AesKey::new_encrypt(&key_as_u8)?;
//! let mut output = vec![0u8; cipher_as_u8.len()];
//! aes_ige(&cipher_as_u8, &mut output, &key, &mut iv_as_u8, Mode::Encrypt);
//! assert_eq!(output.to_hex(), "a6ad974d5cea1d36d2f367980907ed32");
//! }
//! Ok(())
//! } //! }
//! //!
//! # fn main() { //! # fn main() {
//! # decrypt(); //! # decrypt();
//! # } //! # }
use ffi; use ffi;
use std::mem; use std::mem;