NAME

Crypt::AppleTwoFish -- two Apple iTMS/iTunes key descrambling algorithms

DESCRIPTION

The first algorithm appears to have only cursory resemblance to Bruce Schneier's blowfish and twofish algorithms in that it too has a table-based decoder.

The second algorithm is more standard encryption using S-box type permutations and lookup tables, and might have started out something like Twofish or Blowfish.

SYNOPSIS

for iTMS usages:

use Crypt::AppleTwoFish;

my $scrambled_key = '=sixteen uchars=';

my $apple_twofish = new Crypt::AppleTwoFish(key => $scrambled_key);

my $descrambled_key = $apple_twofish->decrypted_for_iTMS;

my $descrambled_another_way = $apple_twofish->decrypted_for_DRMS;


..and for iTunes 7 compatible usages:

Functions cloned from lower level compiled code which was likely intended
to be difficult to reconstruct cannot easily be given sensible names. Ada 
Pro is good, but dull.  We chose to be amused during the tedium by coming 
up with function names from a vegetable farm. 

For actual usage, see also:

iTunes::Sid.

METHODS

new

Call with the key as a scalar argument. When passed (LWP simulating iTunes) over iTMS, encrypted M4P keys for your purchased music are currently 16 unsigned chars in length.

decrypted_for_iTMS

Returns the unscrambled key for use with the Apple Music Store.

decrypted_for_DRMS

Returns the unscrambled key for use with iTunes/iPod DRM.

key
Get/set initial key.
int_table
Get/set veggie integer table.
byte_table
Get/set veggie byte table.
veggie
Get/set veggie.
hwID
Get/set hardware ID (MAC address or other machine based data). 6 bytes.
keyID
Get/set key ID.  4 bytes.
userID
Get/set user ID.  4 bytes.
plant_veggies
Key munging, spring season
harvest_veggies
Key munging, harvest season

AUTHOR

iTMS decrambler adapted from FairKeys 0.5, by Jon Lech Johansen, and from 
the alterate scramble table found by FutureProof. 

Veggie Tales algorithm courtesy of Ada and other anonymous pros :-).

SUPPORT

Questions, feature requests and bug reports should go to <wherrera@skylightview.com>.

COPYRIGHT

      Copyright (c) 2005, 2008 William Herrera. All rights reserved.  
    
      Licensing Terms
    
      a) The terms of Perl itself, plus the following:
    
      b) UNDER NO CIRCUMSTANCES CAN THIS CODE BE USED FOR CIRCUMVENTION OF ANY 
      TECHNOLOGICAL MEASURE WHICH EFFECTIVELY CONTROLS A PROTECTED MEDIA WORK 
      UNDER THE DCMA (USA, 1998) OR EU COPYRIGHT DIRECTIVE (EUCD, ARTICLE 6, 
      OF 2001), UNDER ANY OPERATING SYSTEM PLATFORM SUPPORTED BY APPLE COMPUTER 
      CORPORATION FOR ITS ITUNES OR IPOD PLAYER SOFTWARE IN ANY APPLE CORPORATION 
      DISTRIBUTED BINARY FORMAT OF ITUNES FOR THE PLATFORM UNDER WHICH THAT MEDIA 
      IS TO BE PLAYED. AS OF 2008, PROHIBITED PLATFORMS INCLUDE THE IPOD, IPHONE, 
      APPLE OS X, AND MICROSOFT WINDOWS, BUT NOT LINUX, BSD, OR SOLARIS.  UNDER NO 
      CIRCUMSTANCES CAN THE AUTHOR(S) OF THIS CODE BE HELD LIABLE FOR ANY 
      INFRINGEMENT INVOLVING THE PROHIBITED PLATFORMS ABOVE.
    
      c) Use, storage, or distribution of this code implies that you accept that 
      its intended purpose is legal and legitimate under any applicable US or EU 
      law, as above, and agree that any and all risk as to the quality, 
      performance, and legality of this code lies with you.