URL commands for processing SSL certificates

The following commands automate the request and receipt of Secure Sockets Layer (SSL) certificates stored in a database.

Note: The URLs shown are for example only. They do not point to existing Web sites.

OpenForm with SpecialAction argument

Syntax

http://Host/Database/FormName?OpenForm&SpecialAction=specialActionField

Where:

specialActionField is the name of an editable text field on the form whose value contains a predefined command. To use the field with SSL certificates, use one of the following certificate request commands:

"SubmitCert"

"ServerRequest"

"ServerPickup"

Examples

http://www.lotus-10.com/certs.nsf/UserCertificateRequest?OpenForm&SpecialAction=SubmitCert

http://www.lotus-10.com/certs.nsf/ServerCertificateRequest?OpenForm&SpecialAction=ServerRequest

http://www.lotus-10.com/certs.nsf/Certificate?OpenForm&SpecialAction=ServerPickup

Creating an SSL User Certificate

The SubmitCert command creates a User Certificate document in the specified database, using the form specified in the TranslateForm argument.

Syntax

http://Host/Database/ResultForm?RequestCert&Command=SubmitCert&TranslateForm=TranslationFormName

Where:

  • ResultForm is a form in the specified database that displays information about the processed request.
  • TranslationFormName represents a form in the database that contains fields to hold certificate information.

Example

http://www.lotus-10.com/certs.nsf/CertificateProcessed?RequestCert&Command=SubmitCert&TranslateForm=Certificate

Optional and required fields

The SubmitCert command requires a translation form with a field named Certificate. Domino® saves information about the certificate subject and issuer in the document if the form contains fields with these names:

  • CommonName
  • Org
  • OrgUnit
  • Locality
  • State
  • Country
  • IssuerCommonName
  • IssuerOrg
  • IssuerOrgUnit
  • IssuerLocality
  • IssuerState
  • IssuerCountry

Creating an SSL Server Certificate Request

The ServerRequest command creates a Server Certificate Request document in the specified database, using the form specified in the TranslateForm argument.

Syntax

http://Host/Database/MessageForm?RequestCert&Command=ServerRequest&TranslateForm=TranslationFormName

Where:

  • ResultForm is a form in the specified database that displays information about the processed request in the user's browser after a successful submission.
  • TranslationFormName represents a form in the database that contains fields to hold certificate information.

Example

http://www.lotus-10.com/certs.nsf/CertificateProcessed?RequestCert&Command=ServerRequest&TranslateForm=Certificate

Optional and required fields

The ServerRequest command requires a translation form with a field named Certificate. Domino saves information about the server request in the document if the form contains fields with these names:

  • CommonName
  • Org
  • OrgUnit
  • Locality
  • State
  • Country