Programming Guides › Programming Guide for Perl › CLI Agent API Methods › User Methods › CertificateFile Method—Sets or Retrieves User's X.509 Certificate Using File

CertificateFile Method—Sets or Retrieves User's X.509 Certificate Using File

The CertificateFile method sets or retrieves the user's X.509 certificate using the specified certificate file.

Syntax

The CertificateFile method has the following format:

Netegrity::AgentUser‑>CertificateFile([certFile[, format]])

Parameters

The CertificateFile method accepts the following parameters:

certFile (string)

(Optional) Specifies the full path and file name of the certificate file.

format (string)

(Optional) Specifies the format of the certificate file.

Default: base64 encoded X.509 (value = 1)

Note: The default is the only supported file format.

Return Value

The CertificateFile method returns the following value:

• ($String, $Length)

  Specifies the new or existing certificate's data and length.