RC4decrypt and RC4encrypt (String functions) - Revision history

JAL: remove old references

2016-05-31T21:28:27Z

remove old references

← Older revision		Revision as of 21:28, 31 May 2016
Line 33:		Line 33:
	<li>The <var class="term">key</var> value you provide is (internally) concatenated with itself until it reaches 256 bytes and becomes the "true" key that participates in the encryption algorithm. A consequence of this is that a key that consists of text that repeats will produce the same encryption result as the text alone (without its repetitions). For example, the eight-byte key <code>'AAAAAAAA'</code> is no stronger than the one-byte key <code>'A'</code>, so it is not very secure. Similarly, the ten-byte key <code>'ababababab'</code> is no stronger than the two-byte key <code>'ab'</code>. </li>		<li>The <var class="term">key</var> value you provide is (internally) concatenated with itself until it reaches 256 bytes and becomes the "true" key that participates in the encryption algorithm. A consequence of this is that a key that consists of text that repeats will produce the same encryption result as the text alone (without its repetitions). For example, the eight-byte key <code>'AAAAAAAA'</code> is no stronger than the one-byte key <code>'A'</code>, so it is not very secure. Similarly, the ten-byte key <code>'ababababab'</code> is no stronger than the two-byte key <code>'ab'</code>. </li>

	<li>RC4 is the default stream cipher used in <var class="product">[~~http://www.sirius-software.com/maint/download/jansslr.pdf~~ Janus Network Security~~]</var>, and it may be used by customers who license <var class="product">Janus Network Security</var> or <var class="product">[[Janus SOAP\|Janus SOAP~~]]</var>~~. </li>~~		<li>RC4 is the former default stream cipher used in <var class="product">[[Janus Network Security]]</var>. </li>

	~~<li>The <var>RC4encrypt</var> function is available as of <var class="product">Sirius Mods</var> version 7.3~~. </li>
	</ul>		</ul>

JAL: /* See also */ alphabetizing

2016-05-31T20:10:28Z

JAL: /* See also */ use template

2016-05-31T20:06:29Z

JAL: /* See also */ add templates

2016-03-16T20:59:36Z

JAL: typo

2016-03-11T22:46:17Z

typo

← Older revision		Revision as of 22:46, 11 March 2016
Line 7:		Line 7:
	</p>		</p>
	You can use <var>RC4decrypt</var> to "document" that you are decrypting, and		You can use <var>RC4decrypt</var> to "document" that you are decrypting, and
	use <var>RC4encrypt</var> to "document" that you are ~~enrypting~~. In the remainder of this article, you can use <var>RC4decrypt</var> and <var>RC4encrypt</var> interchangeably.		use <var>RC4encrypt</var> to "document" that you are encrypting. In the remainder of this article, you can use <var>RC4decrypt</var> and <var>RC4encrypt</var> interchangeably.

	==Syntax==		==Syntax==

JAL: add link

2016-03-11T20:30:15Z

add link

← Older revision		Revision as of 20:30, 11 March 2016
Line 3:		Line 3:
	<var>RC4decrypt</var> and <var>RC4encrypt</var> are synonyms for the [[Intrinsic classes\|intrinsic]] function to return a binary string that is the method object string encrypted or decrypted with the specified RC4 encryption key. The length of the returned string is the same as that of the object string.		<var>RC4decrypt</var> and <var>RC4encrypt</var> are synonyms for the [[Intrinsic classes\|intrinsic]] function to return a binary string that is the method object string encrypted or decrypted with the specified RC4 encryption key. The length of the returned string is the same as that of the object string.

	RC4 is a two-way, or symmetric, cipher (algorithm), so encrypting a string with a key and then decrypting the result of that encryption with the same key produces the original string. That is, the following assertion should <b><i>always</i></b> hold:		RC4 is a two-way, or symmetric, [https://en.wikipedia.org/wiki/Stream_cipher stream] cipher (algorithm), so encrypting a string with a key and then decrypting the result of that encryption with the same key produces the original string. That is, the following assertion should <b><i>always</i></b> hold:
	<p class="code">[[Assert statement\|assert]] %string:rc4encrypt(%key):rc4decrypt(%key) eq %string		<p class="code">[[Assert statement\|assert]] %string:rc4encrypt(%key):rc4decrypt(%key) eq %string
	</p>		</p>

JAL: minor formatting

2016-03-08T22:33:02Z

minor formatting

← Older revision		Revision as of 22:33, 8 March 2016
Line 7:		Line 7:
	</p>		</p>
	You can use <var>RC4decrypt</var> to "document" that you are decrypting, and		You can use <var>RC4decrypt</var> to "document" that you are decrypting, and
	use <var>RC4encrypt</var> to "document" that you are enrypting. In the remainder of this article, you can use <var>RC4decrypt</var> and <var>RC4encrypt</var> interchangeably.		use <var>RC4encrypt</var> to "document" that you are enrypting. In the remainder of this article, you can use <var>RC4decrypt</var> and <var>RC4encrypt</var> interchangeably.

	==Syntax==		==Syntax==
	{{Template:String:RC4decrypt syntax}}		{{Template:String:RC4decrypt syntax}}
	{{Template:String:RC4encrypt syntax}}		{{Template:String:RC4encrypt syntax}}

	===Syntax terms===		===Syntax terms===
	<table ~~class="syntaxTable"~~>		<table>
	<tr><th>%outString</th>		<tr><th>%outString</th>
	<td>A string variable to receive the encrypted or decrypted method object <var class="term">string</var>. Its length is the same as <var class="term">string</var>.</td></tr>		<td>A string variable to receive the encrypted or decrypted method object <var class="term">string</var>. Its length is the same as <var class="term">string</var>.</td></tr>

	<tr><th>string</th>		<tr><th>string</th>
	<td>The string to which the method is applied.</td></tr>		<td>The string to which the method is applied.</td></tr>

	<tr><th>key</th>		<tr><th>key</th>
	<td> A string variable whose value is used to encrypt or decrypt the method object <var class="term">string</var>. The key is transformed and then combined with the object string. This key value must not be null nor longer than 255 bytes. (RC4 keys are rarely longer than 64 bytes.)</td></tr>		<td> A string variable whose value is used to encrypt or decrypt the method object <var class="term">string</var>. The key is transformed and then combined with the object string. This key value must not be null nor longer than 255 bytes. (RC4 keys are rarely longer than 64 bytes.)</td></tr>
	</table>		</table>

	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>A complete explanation of RC4 encryption can easily be found on the Internet.		<li>A complete explanation of RC4 encryption can easily be found on the Internet. </li>
	<li>You are <b><i>not</i></b> prevented from creating confusion by encrypting with <var>RC4decrypt</var> and decrypting with <var>RC4encrypt</var>.
	<li>The <var class="term">key</var> value you provide is (internally) concatenated with itself until it reaches 256 bytes and becomes the "true" key that participates in the encryption algorithm. A consequence of this is that a key that consists of text that repeats will produce the same encryption result as the text alone (without its repetitions). For example, the eight-byte key <code>'AAAAAAAA'</code> is no stronger than the one-byte key <code>'A'</code>, so it is not very secure. Similarly, the ten-byte key <code>'ababababab'</code> is no stronger than the two-byte key <code>'ab'</code>.		<li>You are <b><i>not</i></b> prevented from creating confusion by encrypting with <var>RC4decrypt</var> and decrypting with <var>RC4encrypt</var>. </li>
	<li>RC4 is the default stream cipher used in <var class="product">[http://www.sirius-software.com/maint/download/jansslr.pdf Janus Network Security]</var>, and it may be used by customers who license <var class="product">Janus Network Security</var> or <var class="product">[[Janus SOAP\|Janus SOAP]]</var>.
	<li>The <var>RC4encrypt</var> function is available as of <var class="product">Sirius Mods</var> version 7.3.</ul>		<li>The <var class="term">key</var> value you provide is (internally) concatenated with itself until it reaches 256 bytes and becomes the "true" key that participates in the encryption algorithm. A consequence of this is that a key that consists of text that repeats will produce the same encryption result as the text alone (without its repetitions). For example, the eight-byte key <code>'AAAAAAAA'</code> is no stronger than the one-byte key <code>'A'</code>, so it is not very secure. Similarly, the ten-byte key <code>'ababababab'</code> is no stronger than the two-byte key <code>'ab'</code>. </li>

			<li>RC4 is the default stream cipher used in <var class="product">[http://www.sirius-software.com/maint/download/jansslr.pdf Janus Network Security]</var>, and it may be used by customers who license <var class="product">Janus Network Security</var> or <var class="product">[[Janus SOAP\|Janus SOAP]]</var>. </li>

			<li>The <var>RC4encrypt</var> function is available as of <var class="product">Sirius Mods</var> version 7.3. </li>
			</ul>

	==Examples==		==Examples==
	In the following example, the output string from the <var>RC4encrypt</var> method is assigned to a variable, converted to hex using the <var>[[StringToHex (String function)\|StringToHex]]</var> intrinsic function to reveal its non-displayable characters, then decrypted to return the original input string:		In the following example, the output string from the <var>RC4encrypt</var> method is assigned to a variable, converted to hex using the <var>[[StringToHex (String function)\|StringToHex]]</var> intrinsic function to reveal its non-displayable characters, then decrypted to return the original input string:
	<p class="~~output~~">%string = 'this is a test':rc4encrypt('key')
			<p class="code">%string = 'this is a test':rc4encrypt('key')
	[[PrintText statement\|printText]] {~} is {%string:stringTohex}		[[PrintText statement\|printText]] {~} is {%string:stringTohex}
	printText {~} is: {%string:rc4decrypt('key')}		printText {~} is: {%string:rc4decrypt('key')}
Line 43:		Line 52:
	==See also==		==See also==
	<ul>		<ul>
	<li>For one-way encryption, <var>[[MD5digest (String function)\|MD5digest]], <var>[[SHAdigest (String function)\|SHAdigest]]</var>, </var> and <var>[[SHA256digest (String function)\|SHA256digest]]</var> are cryptographic hash functions that also operate on the method object <var class="term">string</var>.		<li>For one-way encryption, <var>[[MD5digest (String function)\|MD5digest]], <var>[[SHAdigest (String function)\|SHAdigest]]</var>, </var> and <var>[[SHA256digest (String function)\|SHA256digest]]</var> are cryptographic hash functions that also operate on the method object <var class="term">string</var>. </li>
	</ul>		</ul>

	{{Template:String:RC4encrypt footer}}		{{Template:String:RC4encrypt footer}}

JAL: /* See also */ add link

2016-03-08T16:47:11Z

JALWiccan: 1 revision

2012-11-02T18:29:49Z

1 revision

← Older revision	Revision as of 18:29, 2 November 2012
(No difference)

JAL2 at 18:29, 2 November 2012

2012-11-02T18:29:47Z

← Older revision		Revision as of 18:29, 2 November 2012
Line 1:		Line 1:
	{{Template:String:RC4decrypt and RC4encrypt subtitle}}		{{Template:String:RC4decrypt and RC4encrypt subtitle}}

	<var>RC4decrypt</var> and <var>RC4encrypt</var> are synonyms for the ~~<var>~~[[Intrinsic classes\|intrinsic]]~~</var>~~ function to return a binary string that is the method object string encrypted or decrypted with the specified RC4 encryption key. The length of the returned string is the same as that of the object string.		<var>RC4decrypt</var> and <var>RC4encrypt</var> are synonyms for the [[Intrinsic classes\|intrinsic]] function to return a binary string that is the method object string encrypted or decrypted with the specified RC4 encryption key. The length of the returned string is the same as that of the object string.

	RC4 is a two-way, or symmetric, cipher (algorithm), so encrypting a string with a key and then decrypting the result of that encryption with the same key produces the original string. That is, the following assertion should <b><i>always</i></b> hold:		RC4 is a two-way, or symmetric, cipher (algorithm), so encrypting a string with a key and then decrypting the result of that encryption with the same key produces the original string. That is, the following assertion should <b><i>always</i></b> hold:

← Older revision		Revision as of 20:10, 31 May 2016
Line 54:		Line 54:
	<li>Additional two-way ciphers:		<li>Additional two-way ciphers:
	<ul>		<ul>
			{{Template:AES crypto methods}}
	{{Template:DEA crypto methods}}		{{Template:DEA crypto methods}}
	~~{{Template:AES crypto methods}}~~
	</ul></li>		</ul></li>

← Older revision		Revision as of 20:06, 31 May 2016
Line 58:		Line 58:
	</ul></li>		</ul></li>

	<li><var>String</var> ~~one-way ciphers~~:		<li><var>String</var> hashes:
	<ul>		<ul>
	~~<li><var>[[MD5digest (String function)\|MD5digest]]</var> </li>~~		{{Template:Digest methods}}

	~~<li><var>[[SHAdigest (String function)\|SHAdigest]]</var> </li>~~

	~~<li><var>[[SHA224digest (String function)\|SHA224digest]]</var> </li>~~

	~~<li><var>[[SHA256digest (String function)\|SHA256digest]]</var> </li>~~
	</ul></li>		</ul></li>
	</ul>		</ul>

	{{Template:String:RC4encrypt footer}}		{{Template:String:RC4encrypt footer}}

@@ Line 52: / Line 52: @@
 ==See also==
 <ul>
-<li>For one-way encryption, <var>[[MD5digest (String function)|MD5digest]], <var>[[SHAdigest (String function)|SHAdigest]]</var>, </var> and <var>[[SHA256digest (String function)|SHA256digest]]</var> are cryptographic hash functions that also operate on the method object <var class="term">string</var>. </li>
+<li>Additional two-way ciphers:
 </ul>
 {{Template:String:RC4encrypt footer}}

← Older revision		Revision as of 16:47, 8 March 2016
Line 43:		Line 43:
	==See also==		==See also==
	<ul>		<ul>
	<li>For one-way encryption, <var>[[MD5digest (String function)\|MD5digest]]</var> and <var>[[~~SHAdigest~~ (String function)\|~~SHAdigest~~]]</var> are cryptographic hash functions that also operate on the method object <var class="term">string</var>.		<li>For one-way encryption, <var>[[MD5digest (String function)\|MD5digest]], <var>[[SHAdigest (String function)\|SHAdigest]]</var>, </var> and <var>[[SHA256digest (String function)\|SHA256digest]]</var> are cryptographic hash functions that also operate on the method object <var class="term">string</var>.
	</ul>		</ul>
	{{Template:String:RC4encrypt footer}}		{{Template:String:RC4encrypt footer}}