Programming Guides › Programming Guide for Perl › CLI Policy Management Methods › Trusted Host Methods › SetSecret Method—Sets Shared Secret of Trusted Host

SetSecret Method—Sets Shared Secret of Trusted Host

The SetSecret method sets the shared secret of the trusted host.

Syntax

The SetSecret method has the following format:

Netegrity::PolicyMgtTrustedHost‑>SetSecret([sharedSecret])

Parameters

The SetSecret method accepts the following parameter:

sharedSecret (string)

(Optional) Specifies the shared secret to set for the trusted host.

Note: If no shared secret is specified, SiteMinder generates a random 128-byte ASCII shared secret for the trusted host.

Return Value

The SetSecret method returns one of the following values:

• shared_secret (string)

  Specifies the new shared secret for the trusted host.

• "" (empty string)

  Specifies that the call is unsuccessful.

Remarks

When you use this method to set the shared secret, you must also run the SiteMinder tool smreghost to define the new shared secret in the host configuration file. (The host configuration file is named SmHost.conf by default.) Run smreghost with the -sh option. For more information, see the method PolicyMgtSession‑>AddTrustedHost.

Note: You can schedule shared secret rollovers, so that they happen automatically. For more information about this feature, see the Policy Server Configuration Guide.