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

Certificate Method—Sets or Retrieves User's X.509 Cerficate

The Certificate method sets or retrieves the user's X.509 certificate. This method only affects the certificate data associated with the current instance of the user object.

Syntax

The Certificate method has the following format:

Netegrity::AgentUser‑>Certificate([cert, certBinaryLen])

Parameters

The Certificate method accepts the following parameters:

cert (string)

(Optional) Specifies the certificate data to set.

certBinaryLen (int)

(Optional) Specifies the length of the certificate.

Return Value

The Certificate method returns one of the following values:

• ($String, $Length)

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

• undef

  Specifies that the method failed.