NN all IE n/a HTML n/a

HTML End Tag: Forbidden

A keygen element allows a form to be submitted with key encryption, where the server expects a form to be packaged with an encrypted key. The client browser must have a digital certificate installed. The user sees two results of including the keygen element inside a form element. First, a select list of available encryption key sizes is rendered in the form where the keygen element appears. When the user submits the form, the user may see one or more security-related dialogs for confirmation. This element builds on the public-key encryption systems in Navigator and Netscape's Certificate Management System (CMS). Documentation is available at developer.netscape.com/docs/manuals/cms/41/dep-guide/contents.htm.

Example

<FORM ...>
...
<KEYGEN name="encryptedOrder" challenge="39457582201">
</FORM>

Element-Specific Attributes

challenge

keytype

name

pqg

Element-Specific Event Handler Attributes

None.

challenge	NN all IE n/a HTML n/a

challenge="challengeString"	Required
If the server is equipped to interpret a challenge string for verification of an encrypted package, the challenge attribute is the challenge string. If you assign an empty string to the attribute, the key is encoded as an IA5STRING.

Example

<KEYGEN name="encryptedOrder" challenge="39457582201">

Value
Any string.

Default
Empty string.

keytype	NN all IE n/a HTML n/a

keytype="keyType"	Optional/Required
Sets the type of key to be created by the CMS prior to submitting the form data. This attribute is required only for the secondary type, DSA.

Example

<KEYGEN name="encryptedOrder" challenge="39457582201" keytype="DSA">

Value
One of two constant values: RSA \| DSA.

Default
RSA

lang	NN 3 IE 4 HTML 4

lang="languageCode"	Optional
The language being used for the element's attribute values and content. A browser can use this information to assist in proper rendering of content with respect to details such as treatment of ligatures (when supported by a particular font or required by a written language), quotation marks, and hyphenation. Other applications and search engines might use this information to aid the selection of spell-checking dictionaries and the creation of indices.

Example

<SPAN lang="de">Deutsche Bundesbahn</SPAN>

Value
Case-insensitive language code.

Default
Browser default.

Object Model Reference

[window.]document.getElementById(elementID).lang

name	NN all IE n/a HTML n/a

name="identifier"	Required
Encrypting a form turns the entire form into a value that is part of a name/value pair. The name attribute assigns the "name" part of the name/value pair. If the server successfully decrypts the package, the individual form element name/value pairs are available to the server for further processing.

Example

<KEYGEN name="encryptedOrder" challenge="39457582201">

Value
Case-insensitive identifier.

Default
None.

pqg	NN all IE n/a HTML n/a

pqg="dssParams"	Optional/Required
If you specify the DSA key type for the keytype attribute, you must also assign associated parameter values to the pqg attribute. An explanation of the algorithms used to derive these values may be found at ftp://ftp.ietf.org/internet-drafts/draft-ietf-pkix-ipki-pkalgs-05.txt.