This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 19707 - Key generator descriptions are missing
Summary: Key generator descriptions are missing
Status: RESOLVED WONTFIX
Alias: None
Product: Web Cryptography
Classification: Unclassified
Component: Web Cryptography API Document (show other bugs)
Version: unspecified
Hardware: PC All
: P2 normal
Target Milestone: ---
Assignee: Ryan Sleevi
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2012-10-25 18:27 UTC by Mark Watson
Modified: 2013-11-09 05:49 UTC (History)
1 user (show)

See Also:


Attachments

Description Mark Watson 2012-10-25 18:27:18 UTC
Proposed text for missing sections:

18.1.6 The createKeyGenerator method

The createKeyGenerator method returns a new KeyGenerator object that will
generate new keys using the specified AlgorithmIdentifier. It must act as
follows:

  1. Let normalizedAlgorithm be the result of processing algorithm according to
     the algorithm normalizing rules.
  2. If normalizedAlgorithm does not describe a registered algorithm that
     supports the key generation operation, throw a NotSupportedError and
     terminate the operation.
  3. Return a new KeyGenerator object S with the following characteristics:
     1. S.result = null

Generated keys conform to the temporary, extractable, and keyUsages arguments.

Public keys are always extractable.

24.3.4 Operations

Generate Key
  When generating a key pair, the resulting KeyGenerator shall behave as
  follows:
  
    1. Upon invoking generate:
      1. Perform the RSA key generation.
      2. If the operation resulted in an error, raise an error and terminate the
         operation.
      3. Let result be a KeyPair with the generated public and private keys.

24.4.4. Operations

Generate Key
  When generating a key pair, the resulting KeyGenerator shall behave as
  follows:
  
    1. Upon invoking generate:
      1. Perform the RSA key generation.
      2. If the operation resulted in an error, raise an error and terminate the
         operation.
      3. Let result be a KeyPair with the generated public and private keys.

24.5.4. Operations

Generate Key
  When generating a key pair, the resulting KeyGenerator shall behave as
  follows:
  
    1. Upon invoking generate:
      1. Perform the RSA key generation.
      2. If the operation resulted in an error, raise an error and terminate the
         operation.
      3. Let result be a KeyPair with the generated public and private keys.

24.6.4. Operations

Generate Key
  When generating a key pair, the resulting KeyGenerator shall behave as
  follows:
  
    1. Upon invoking generate:
      1. Perform the RSA key generation.
      2. If the operation resulted in an error, raise an error and terminate the
         operation.
      3. Let result be a KeyPair with the generated public and private keys.

24.7.5. Operations

Generate Key
  When generating a key pair, the resulting KeyGenerator shall behave as
  follows:
  
    1. Upon invoking generate:
      1. Perform the ECC key generation.
      2. If the operation resulted in an error, raise an error and terminate the
         operation.
      3. Let result be a KeyPair with the generated public and private keys.

24.8.4. Operations

Generate Key
  When generating a key pair, the resulting KeyGenerator shall behave as
  follows:
  
    1. Upon invoking generate:
      1. Perform the ECC key generation.
      2. If the operation resulted in an error, raise an error and terminate the
         operation.
      3. Let result be a KeyPair with the generated public and private keys.

24.9.5. Operations

Generate Key
  When generating a key, the resulting KeyGenerator shall behave as follows:
  
    1. Upon invoking generate:
      1. Generate an AES key of the requested length.
      2. If the operation resulted in an error, raise an error and terminate the
         operation.
      3. Let result be a Key with generated secret key.

24.10.4. Operations

Generate Key
  When generating a key, the resulting KeyGenerator shall behave as follows:
  
    1. Upon invoking generate:
      1. Generate an AES key of the requested length.
      2. If the operation resulted in an error, raise an error and terminate the
         operation.
      3. Let result be a Key with generated secret key.


24.11.4. Operations

Generate Key
  When generating a key, the resulting KeyGenerator shall behave as follows:
  
    1. Upon invoking generate:
      1. Generate an AES key of the requested length.
      2. If the operation resulted in an error, raise an error and terminate the
         operation.
      3. Let result be a Key with generated secret key.

24.12.5. Operations

Generate Key
  When generating a key, the resulting KeyGenerator shall behave as follows:
  
    1. Upon invoking generate:
      1. Perform the HMAC key generation.
      2. If the operation resulted in an error, raise an error and terminate the
         operation.
      3. Let result be a Key with the generated secret key.

24.13.5. Operations

Generate Key
  When generating a key pair, the resulting KeyGenerator shall behave as
  follows:
  
    1. Upon invoking generate:
      1. Perform the Diffie-Hellman key generation.
      2. If the operation resulted in an error, raise an error and terminate the
         operation.
      3. Let result be a KeyPair with the generated public and private keys.
Comment 1 Ryan Sleevi 2013-11-09 05:47:16 UTC
Obviated by Promises.