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.