Extracts information from the Certified Public Key in the Domino Directory.

Syntax

@Certificate( [ dataToRetrieve ] ; Certificate )

Parameters

[ dataToRetrieve ]

Keyword. Must be enclosed in brackets as shown. Use one of the following keywords:

[SUBJECT]

The name of the certified user ID or server ID.

[ISSUER]

The name of the ID used to issue the certificate.

[EXPIRATION]

The date and time that the North American certificate expires.

[INTLEXPIRATION]

The date and time that the International certificate expires.

Required. This specifies the name of the field where the Certified Public Key information is stored.

dataRetrieved

Text for the Subject and Issuer names, and time-date values for the Expiration and IntlExpiration dates.

@Certificate is useful within a macro or view selection formula for selecting a list of users whose certificates are about to expire; it is used by several Domino Directory tools.

@Certificate only retrieves data; you cannot use it to change certificate information (use the appropriate Administration menus to update certificates). Certified Public Key information is stored only for users and servers with hierarchical IDs; @Certificate returns a null string for nonhierarchical IDs.

If you use incorrect syntax, @Certificate returns a null string and does not generate an error message.

@Certificate returns a null string (""), instead of the name of the server ID, when used in a Scheduled agent running on the server.

You cannot use this function in Web applications.

Language cross-reference

Signer property of LotusScript NotesDocument class

Signer property of Java Document class

Example
See Also

"Taking your Domino applications to the Web" on the Lotus Developer Domain

Glossary