home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / wvwar062.zip / doc / D_README < prev    next >
Text File  |  2000-09-03  |  4KB  |  125 lines

  1. WORD97 DECRYPTION
  2. =================
  3. The document test97.doc is encrypted with the password 
  4. password1.
  5.  
  6. To compile this download version 0.5.31 of wv 
  7. (later version should have this code integrated into 
  8. wv itself) from
  9. http://www.csn.ul.ie/~caolan/publink/mswordview/development/wv-0.5.31.tar.gz
  10. ./configure 
  11. make &
  12. make install that first.
  13.  
  14. now run make in this wvDecrypt dir
  15.  
  16. ./wvDecrypt97Test password1 test97.doc
  17.  
  18. will verify that password1 is the correct password for
  19. test97.doc and will start decrypting the file.
  20.  
  21. Some quick background on word files.
  22. Each word 97 file consists of a bundle of streams,
  23. the Table stream, the WordDocument stream, and others
  24. such as the SummaryInformation stream, the 
  25. DocumentSummaryStream and sometimes a Data stream.
  26.  
  27. en.01 is the extracted table stream from test97.doc
  28. en.02 is the extracted WordDocument stream from test97.doc
  29.  
  30. tablefd (when wvDecrypt is run) is the decrypted tablefd
  31. mainfd (when wvDecrypt is run) is the decrypt mainfd, where
  32. the main text is.
  33.  
  34. The table stream contains the salt that is used by
  35. the decryption process, and is itself encrypted.
  36. So the wvDecrypt97Test program validates the password
  37. and outputs the decrypted table stream to the file 
  38. named "tablefd". The main document stream is decrypted
  39. to the file "mainfd"
  40.  
  41. Most of the code you see here was not written by me,
  42. what was, got rewritten by Fauzan Mirza. I basically 
  43. just put the right people together, and provided
  44. the wv api into the word document. The CREDITS file
  45. lists those involved, and what they did.
  46.  
  47. As promised in previous versions of this document, 
  48. the wvDecrypt is now released under the BSD licence,
  49. so anyone can use this whether for commercial use
  50. or not.
  51.  
  52. Word97 decryption is now an open book. Thanks all !!
  53. its a little shocking that its been so long since 
  54. word97 was released and a publically available
  55. compatible decryption engine, but that gap has
  56. been filled now.
  57.  
  58. The one small thing missing is to use cole to put
  59. the streams back together into a decrypted word
  60. document, rather than the seperated streams, as it
  61. stands it does exactly what I want for the wv
  62. library, but i'll get around to that unless someone
  63. else wants to do it, its pretty trivial to wrap
  64. it back into a word doc, only you will just have to
  65. set the fEncrypted bit in the fib to 0, to show that
  66. the doc is decrypted.
  67.  
  68. WORD95 DECRYPTION
  69. =================
  70. The document test95.doc is encrypted with the password 
  71. password1.
  72.  
  73. To compile this download version 0.5.31 of wv 
  74. (later version should have this code integrated into 
  75. wv itself) from
  76. http://www.csn.ul.ie/~caolan/publink/mswordview/development/wv-0.5.31.tar.gz
  77. ./configure 
  78. make &
  79. make install that first.
  80.  
  81. now run make in this wvDecrypt dir
  82.  
  83. ./wvDecrypt95Test password1 test95.doc
  84.  
  85. will verify that password1 is the correct password for
  86. test95.doc and will start decrypting the file.
  87.  
  88. Some quick background on word files.
  89. Each word 95 files consists  of a number of streams
  90. but unlike word97 only one is of importance, i.e. 
  91. the WordDocument stream.
  92.  
  93. encrypt95.01 is the extracted WordDocument stream from test95.doc
  94.  
  95. mainfd (when wvDecrypt is run) is the decrypt mainfd
  96.  
  97. The word95 code was written by me and is also released under the
  98. BSD licence unlike the rest of wv, coz I want to see the
  99. password stuff as widely distributed as possible.
  100.  
  101. The word95 decryption is simpler than the word97 one, but might
  102. not be 100% complete as it is freshly added in here. It also
  103. might be the exact same as word 6 encryption, though someone
  104. has to test that for me.
  105.  
  106.  
  107. The one small thing missing is to use cole to put
  108. the streams back together into a decrypted word
  109. document, rather than the seperated streams, as it
  110. stands it does exactly what I want for the wv
  111. library, but i'll get around to that unless someone
  112. else wants to do it, its pretty trivial to wrap
  113. it back into a word doc, only you will just have to
  114. set the fEncrypted bit in the fib to 0, to show that
  115. the doc is decrypted.
  116.  
  117. C.
  118.  
  119. If you want something to investigate ole2 streams
  120. try the perl laola at
  121. http://wwwwbs.cs.tu-berlin.de/~schwartz/pmh/laola.html
  122.  
  123. More information on the wv library can be got at
  124. http://www.csn.ul.ie/~caolan/docs/MSWordView.html
  125.