Crypto - Revision history

Abarth at 16:48, 21 August 2012

2012-08-21T16:48:40Z

← Older revision		Revision as of 16:48, 21 August 2012
Line 1:		Line 1:
	This proposal has been subsumed by the <code>window.~~Crypto~~</code> API in the [http://www.w3.org/2012/webcrypto/WebCryptoAPI/ Web Cryptography API] being developed by the W3C Web Cryptography Working Group.		This proposal has been subsumed by the <code>window.crypto</code> API in the [http://www.w3.org/2012/webcrypto/WebCryptoAPI/ Web Cryptography API] being developed by the W3C Web Cryptography Working Group.

Abarth: Replaced content with 'This proposal has been subsumed by the `window.Crypto` API in the [http://www.w3.org/2012/webcrypto/WebCryptoAPI/ Web Cryptography API] being developed by the W3C ...'

2012-08-21T16:48:20Z

Replaced content with 'This proposal has been subsumed by the <code>window.Crypto</code> API in the [http://www.w3.org/2012/webcrypto/WebCryptoAPI/ Web Cryptography API] being developed by the W3C ...'

← Older revision		Revision as of 16:48, 21 August 2012
Line 1:		Line 1:
	~~'''The current specification for~~ the <code>window.Crypto</code> API ~~can now be found~~ in the [http://www.w3.org/2012/webcrypto/WebCryptoAPI/ Web Cryptography API] being developed by the W3C Web Cryptography Working Group.~~'''~~		This proposal has been subsumed by the <code>window.Crypto</code> API in the [http://www.w3.org/2012/webcrypto/WebCryptoAPI/ Web Cryptography API] being developed by the W3C Web Cryptography Working Group.

	~~==Overview==~~

	~~This document describes a proposal for the window.crypto API.~~

	~~==Definitions==~~

	~~===Cryptographically Random Values===~~

	A <b id=concept-cryptographically-random-values title=concept-cryptographically-random-values>cryptographically random value</b> is a value generated from a cryptographically strong pseudo-random number generator seeded with truly random values. In practice, implementations should generate cryptographically random values using well-established cryptographic pseudo-random number generators seeded with high-quality entropy, such as from an operating-system entropy source (e.g., ''/dev/urandom''). This document provides no lower-bound on the information theoretic entropy present in cryptographically random values, but implementations should make a best effort to provide as much entropy as practicable.

	~~==Interface <code title>Crypto</code>==~~

	~~<pre>interface Crypto {~~
	~~ArrayBufferView getRandomValues(in ArrayBufferView array);~~
	};

	~~partial interface Window {~~
	~~readonly attribute Crypto crypto;~~
	~~};</pre>~~

	~~The <b id=dom-Crypto-getRandomValues title=dom-Crypto-getRandomValues><code>getRandomValues(<var>array</var>)</code></b> must run the following steps:~~
	# <var>array</var> is an [http://www.khronos.org/registry/typedarray/specs/latest/#6 ArrayBufferView]. If <var>array</var> is not of an integer type (i.e., Int8Array, Uint8Array, Int16Array, Uint16Array, Int32Array, or Uint32Array), [http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-throw throw] a [http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#typemismatcherror TypeMismatchError] and abort these steps.
	# If <var>array</var>'s length is greater than 65536, [http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-throw throw] a [http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#quotaexceedederror QuotaExceededError] and abort these steps.
	~~# Overwrite all elements of <var>array</var> with [[#concept-cryptographically-random-values\|cryptographically random values]] of the appropriate type.~~
	~~# Return <var>array</var>.~~

	~~[[Category:Proposals]]~~

Abarth at 20:02, 13 August 2012

2012-08-13T20:02:14Z

← Older revision		Revision as of 20:02, 13 August 2012
Line 9:		Line 9:
	===Cryptographically Random Values===		===Cryptographically Random Values===

	A <b id=concept-cryptographically-random-values title=concept-cryptographically-random-values>cryptographically random value</b> is a value generated from a cryptographically strong pseudo-random number generator seeded with truly random values. In practice, implementations should generate cryptographically random values using well-established cryptographic pseudo-random number generators~~, such as RC4,~~ seeded with high-quality entropy, such as from an operating-system entropy source (e.g., ''/dev/urandom''). This document provides no lower-bound on the information theoretic entropy present in cryptographically random values, but implementations should make a best effort to provide as much entropy as practicable.		A <b id=concept-cryptographically-random-values title=concept-cryptographically-random-values>cryptographically random value</b> is a value generated from a cryptographically strong pseudo-random number generator seeded with truly random values. In practice, implementations should generate cryptographically random values using well-established cryptographic pseudo-random number generators seeded with high-quality entropy, such as from an operating-system entropy source (e.g., ''/dev/urandom''). This document provides no lower-bound on the information theoretic entropy present in cryptographically random values, but implementations should make a best effort to provide as much entropy as practicable.

	==Interface <code title>Crypto</code>==		==Interface <code title>Crypto</code>==

MikeSmith at 07:08, 26 July 2012

2012-07-26T07:08:44Z

← Older revision		Revision as of 07:08, 26 July 2012
Line 1:		Line 1:
	'''The specification for the <code>window.Crypto</code> API can now be found in the [http://www.w3.org/2012/webcrypto/WebCryptoAPI/ Web Cryptography API] being developed by the W3C Web Cryptography Working Group.'''		'''The current specification for the <code>window.Crypto</code> API can now be found in the [http://www.w3.org/2012/webcrypto/WebCryptoAPI/ Web Cryptography API] being developed by the W3C Web Cryptography Working Group.'''

	==Overview==		==Overview==

MikeSmith: point to latest Web Cryptography API draft from the Web Cryptography WG

2012-07-26T07:05:49Z

point to latest Web Cryptography API draft from the Web Cryptography WG

← Older revision		Revision as of 07:05, 26 July 2012
Line 1:		Line 1:
	'''The specification for the <code>window.~~crypto~~</code> API can now be found [~~https~~://~~dvcs~~.w3.org/hg/~~domcrypt~~/~~raw-file~~/~~tip/Overview.html at~~ the W3C].'''		'''The specification for the <code>window.Crypto</code> API can now be found in the [http://www.w3.org/2012/webcrypto/WebCryptoAPI/ Web Cryptography API] being developed by the W3C Web Cryptography Working Group.'''

	==Overview==		==Overview==

Ms2ger: Add link

2012-03-27T14:55:59Z

Add link

← Older revision		Revision as of 14:55, 27 March 2012
Line 1:		Line 1:
			'''The specification for the <code>window.crypto</code> API can now be found [https://dvcs.w3.org/hg/domcrypt/raw-file/tip/Overview.html at the W3C].'''

	==Overview==		==Overview==

Abarth: /* Interface Crypto */

2012-02-21T04:17:50Z

Interface Crypto

← Older revision		Revision as of 04:17, 21 February 2012
Line 12:		Line 12:

	<pre>interface Crypto {		<pre>interface Crypto {
	~~void~~ getRandomValues(in ArrayBufferView array);		ArrayBufferView getRandomValues(in ArrayBufferView array);
	};		};

Line 23:		Line 23:
	# If <var>array</var>'s length is greater than 65536, [http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-throw throw] a [http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#quotaexceedederror QuotaExceededError] and abort these steps.		# If <var>array</var>'s length is greater than 65536, [http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-throw throw] a [http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#quotaexceedederror QuotaExceededError] and abort these steps.
	# Overwrite all elements of <var>array</var> with [[#concept-cryptographically-random-values\|cryptographically random values]] of the appropriate type.		# Overwrite all elements of <var>array</var> with [[#concept-cryptographically-random-values\|cryptographically random values]] of the appropriate type.
			# Return <var>array</var>.

	[[Category:Proposals]]		[[Category:Proposals]]

Ms2ger: Throw an exception for overlarge arrays, as discussed in https://bugzilla.mozilla.org/show_bug.cgi?id=440046

2011-10-12T19:52:49Z

Throw an exception for overlarge arrays, as discussed in https://bugzilla.mozilla.org/show_bug.cgi?id=440046

← Older revision		Revision as of 19:52, 12 October 2011
Line 20:		Line 20:

	The <b id=dom-Crypto-getRandomValues title=dom-Crypto-getRandomValues><code>getRandomValues(<var>array</var>)</code></b> must run the following steps:		The <b id=dom-Crypto-getRandomValues title=dom-Crypto-getRandomValues><code>getRandomValues(<var>array</var>)</code></b> must run the following steps:
	# <var>array</var> is an [http://www.khronos.org/registry/typedarray/specs/latest/#6 ArrayBufferView]. If <var>array</var> is not of an integer type (i.e., Int8Array, Uint8Array, Int16Array, Uint16Array, Int32Array, or Uint32Array), throw a [http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#~~dom~~-~~domexception~~-~~type_mismatch_err TYPE_MISMATCH_ERR~~] and abort these steps.		# <var>array</var> is an [http://www.khronos.org/registry/typedarray/specs/latest/#6 ArrayBufferView]. If <var>array</var> is not of an integer type (i.e., Int8Array, Uint8Array, Int16Array, Uint16Array, Int32Array, or Uint32Array), [http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-throw throw] a [http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#typemismatcherror TypeMismatchError] and abort these steps.
			# If <var>array</var>'s length is greater than 65536, [http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-throw throw] a [http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#quotaexceedederror QuotaExceededError] and abort these steps.
	# Overwrite all elements of <var>array</var> with [[#concept-cryptographically-random-values\|cryptographically random values]] of the appropriate type.		# Overwrite all elements of <var>array</var> with [[#concept-cryptographically-random-values\|cryptographically random values]] of the appropriate type.

	[[Category:Proposals]]		[[Category:Proposals]]

Annevk: even more like a proper spec

2011-08-18T16:43:19Z

even more like a proper spec

← Older revision		Revision as of 16:43, 18 August 2011
Line 9:		Line 9:
	A <b id=concept-cryptographically-random-values title=concept-cryptographically-random-values>cryptographically random value</b> is a value generated from a cryptographically strong pseudo-random number generator seeded with truly random values. In practice, implementations should generate cryptographically random values using well-established cryptographic pseudo-random number generators, such as RC4, seeded with high-quality entropy, such as from an operating-system entropy source (e.g., ''/dev/urandom''). This document provides no lower-bound on the information theoretic entropy present in cryptographically random values, but implementations should make a best effort to provide as much entropy as practicable.		A <b id=concept-cryptographically-random-values title=concept-cryptographically-random-values>cryptographically random value</b> is a value generated from a cryptographically strong pseudo-random number generator seeded with truly random values. In practice, implementations should generate cryptographically random values using well-established cryptographic pseudo-random number generators, such as RC4, seeded with high-quality entropy, such as from an operating-system entropy source (e.g., ''/dev/urandom''). This document provides no lower-bound on the information theoretic entropy present in cryptographically random values, but implementations should make a best effort to provide as much entropy as practicable.

	==Interface==		==Interface <code title>Crypto</code>==

	<pre>		<pre>interface Crypto {
	interface Crypto {
	void getRandomValues(in ArrayBufferView array);		void getRandomValues(in ArrayBufferView array);
	};		};
Line 18:		Line 17:
	partial interface Window {		partial interface Window {
	readonly attribute Crypto crypto;		readonly attribute Crypto crypto;
	};		};</pre>
	</pre>

	~~==Methods==~~

	~~===getRandomValues===~~

	The <b id=dom-Crypto-getRandomValues title=dom-Crypto-getRandomValues><code>getRandomValues(<var>array</var>)</code></b> must run the following steps:		The <b id=dom-Crypto-getRandomValues title=dom-Crypto-getRandomValues><code>getRandomValues(<var>array</var>)</code></b> must run the following steps:

Ms2ger: Make this read like a spec, update to modern IDL syntax, and fix header levels

2011-08-18T12:14:15Z

Make this read like a spec, update to modern IDL syntax, and fix header levels

← Older revision		Revision as of 12:14, 18 August 2011
Line 1:		Line 1:
	=Overview=		==Overview==

	This document describes a proposal for the window.crypto API.		This document describes a proposal for the window.crypto API.

	=Definitions=		==Definitions==

	==Cryptographically Random Values==		===Cryptographically Random Values===

	A ''cryptographically random value'' is a value generated from a cryptographically strong pseudo-random number generator seeded with truly random values. In practice, implementations should generate cryptographically random values using well-established cryptographic pseudo-random number generators, such as RC4, seeded with high-quality entropy, such as from an operating-system entropy source (e.g., ''/dev/urandom''). This document provides no lower-bound on the information theoretic entropy present in cryptographically random values, but implementations should make a best effort to provide as much entropy as practicable.		A <b id=concept-cryptographically-random-values title=concept-cryptographically-random-values>cryptographically random value</b> is a value generated from a cryptographically strong pseudo-random number generator seeded with truly random values. In practice, implementations should generate cryptographically random values using well-established cryptographic pseudo-random number generators, such as RC4, seeded with high-quality entropy, such as from an operating-system entropy source (e.g., ''/dev/urandom''). This document provides no lower-bound on the information theoretic entropy present in cryptographically random values, but implementations should make a best effort to provide as much entropy as practicable.

	=Interface=		==Interface==

	<pre>		<pre>
	~~[NoInterfaceObject]~~
	interface Crypto {		interface Crypto {
	void getRandomValues(in ArrayBufferView array);		void getRandomValues(in ArrayBufferView array);
	};		};

	~~[Supplemental, NoInterfaceObject]~~		partial interface Window {
	interface Window {
	readonly attribute Crypto crypto;		readonly attribute Crypto crypto;
	};		};
	</pre>		</pre>

	=Methods=		==Methods==

	==getRandomValues==		===getRandomValues===

	The ''getRandomValues~~'' method fills ''~~array~~'' with random data. Specifically, if ''~~array'' is an [http://www.khronos.org/registry/typedarray/specs/latest/#6 ArrayBufferView] of an integer type (i.e., Int8Array, Uint8Array, Int16Array, Uint16Array, Int32Array, or Uint32Array), ~~then all the elements of ''array'' are overwritten with ''cryptographically random values'' of the appropriate type. If ''array'' is not of an integer type, ''getRandomValues'' throws~~ a [http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#dom-domexception-type_mismatch_err TYPE_MISMATCH_ERR].		The <b id=dom-Crypto-getRandomValues title=dom-Crypto-getRandomValues><code>getRandomValues(<var>array</var>)</code></b> must run the following steps:
			# <var>array</var> is an [http://www.khronos.org/registry/typedarray/specs/latest/#6 ArrayBufferView]. If <var>array</var> is not of an integer type (i.e., Int8Array, Uint8Array, Int16Array, Uint16Array, Int32Array, or Uint32Array), throw a [http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#dom-domexception-type_mismatch_err TYPE_MISMATCH_ERR] and abort these steps.
			# Overwrite all elements of <var>array</var> with [[#concept-cryptographically-random-values\|cryptographically random values]] of the appropriate type.

	[[Category:Proposals]]		[[Category:Proposals]]