Difference between revisions of "Simple Encryption"

From Second Life Wiki
Jump to navigation Jump to search
(→‎Encryptor: accidentally over-wrote Strife Onizuka's fix in hex conversion. Fixed.)
m (included with encryption category)
Line 190: Line 190:


{{LSLC|Examples|Simple Encryption}}
{{LSLC|Examples|Simple Encryption}}
[[Category: LSL Encryption]]

Revision as of 12:39, 1 January 2008

Here's a function to pass a secret message from one object to another. Using XOR, this is perhaps the weakest form of encryption. I have taken steps to make it harder to break using random nonce values with the password. If someone is able to decrypt one message, it will be easy for them to decrypt any other message. I've also added version support so that you can upgrade the script later and still have compatibility with older scripts using the same protocol.

Encryptor

<lsl> string ProtocolSignature = "ENC"; // your own signature float ProtocolVersion = 0.3; // can range from 0.0 to 255.255 string Password = "P@ssw0rd"; // change this to your own password integer communicationsChannel = PUBLIC_CHANNEL;

string hex(integer value) {

   string hex = "0123456789ABCDEF";
   integer digit = value & 0xF;
   string text = llGetSubString(hex, digit, digit);
   value = (value >> 4) & 0x3FFFFFFF;
   integer odd = 1;
   while(value)
   {
       digit = value & 0xF;
       text = llGetSubString(hex, digit, digit) + text;
       odd++;
       value = value >> 4;
   } 
   if(odd % 2)
       text = "0" + text;
   return text;

} string encrypt(string password, string message) {

   // get a random value
   integer nonce = llFloor(llFrand(0x7FFFFFFF));
   // generate digest
   string digest = llMD5String(message, nonce);
   
   // prepend message with digest
   message = digest + message;
   
   // generate one time pad
   string oneTimePad = llMD5String(password, nonce);
   
   // append pad until length matches or exceeds message
   while(llStringLength(oneTimePad) < llStringLength(message))
       oneTimePad += llMD5String(oneTimePad, nonce);
       
   // encrypt message
   oneTimePad = llStringToBase64(oneTimePad);
   message = llStringToBase64(message);
   message = llXorBase64StringsCorrect(message, oneTimePad);
   
   // build header
   string header = ProtocolSignature;
   
   // append major version
   list versions = llParseString2List((string)ProtocolVersion, ["."], []);
   header += hex(llList2Integer(versions, 0));
   
   // append minor version
   string minor;
   for(minor = llList2String(versions, 1);
       llGetSubString(minor, -1, -1) == "0";
       minor = llGetSubString(minor, 0, -2))
       ;
   header += hex((integer)minor);
   
   // append nonce to header
   string nonceH = hex(nonce);
   while(llStringLength(nonceH) < 8)
       nonceH = "0" + nonceH;
   header += nonceH;
   
   // return the header and encrypted message
   return header + message;

} default {

   state_entry()
   {
       llSay(communicationsChannel, encrypt(Password, "Hello, Avatar!"));
       llSay(communicationsChannel, encrypt(Password, "This is a very long text that I hope to be able to create a long one time pad to decrypt for it."));
   }
   touch_start(integer total_number)
   {
       llSay(communicationsChannel, encrypt(Password, "Touched."));
   }

} </lsl>

Decryptor

<lsl> string ProtocolSignature = "ENC"; // your own signature float ProtocolVersion = 0.3; // can range from 0.0 to 255.255 string Password = "P@ssw0rd"; // change this to your own password integer communicationsChannel = PUBLIC_CHANNEL; integer Debug = TRUE; // Set this to false for production integer listener;

init() {

   if(listener != 0)
   {
       llListenRemove(listener);
       listener = 0;
   }
   listener = llListen(communicationsChannel, "", NULL_KEY, "");

} string error(string message) {

   if(Debug) llSay(DEBUG_CHANNEL, message);
   return "";

} string decrypt(string password, string message) {

   integer signatureLength = llStringLength(ProtocolSignature);
   integer headerLength = signatureLength + 12; // version = 4, nonce = 8
   
   // verify length of encrypted message
   if(llStringLength(message) < signatureLength + 44) // digest = 32 (base64 = 44) + at least one character
       return error("Too small for secret message.");
       
   // look for protocol signature in message header
   if(llSubStringIndex(message, ProtocolSignature) != 0)
       return error("Unknown protocol.");
   
   // Parse version information from header
   integer index = signatureLength; // determine where to start parsing
   string major = "0x" + llGetSubString(message, index, ++index);
   string minor = "0x" + llGetSubString(message, ++index, ++index);
   float version = (float)((string)((integer)major) + "." + (string)((integer)minor));
   
   // verify version is supported
   if(version != ProtocolVersion)
       return error("Unknown version.");
   
   // parse nonce from header
   integer nonce = (integer)("0x" + llGetSubString(message, ++index, index + 7));
   
   // remove header from message
   message = llGetSubString(message, headerLength, -1);
   
   // create one time pad from password and nonce
   string oneTimePad = llMD5String(password, nonce);
   // append pad until length matches or exceeds message
   while(llStringLength(oneTimePad) < (llStringLength(message) * .666))
       oneTimePad += llMD5String(oneTimePad, nonce);
   
   // decrypt message
   oneTimePad = llStringToBase64(oneTimePad);
   message = llXorBase64StringsCorrect(message, oneTimePad);
   
   // decode message
   message = llBase64ToString(message);
   
   // get digest
   string digest = llGetSubString(message, 0, 31);
   
   // remove digest from message
   message = llGetSubString(message, 32, -1);
   
   // verify digest is valid
   if(llMD5String(message, nonce) != digest)
       return error("Message digest was not valid.");
   
   // return decrypted message
   return message;

} default {

   state_entry()
   {
       init();
   }
   on_rez(integer start_param)
   {
       init();
   }
   listen(integer channel, string name, key id, string message)
   {
       string message = decrypt(Password, message);
       if(message != "")
           llSay(0, message);
   }

} </lsl>

Note: The Hex and Efficient Hex examples were used to create the hex method.