Skip to main content

Provide HTML to the password status page

You can use a CGI plugin to supply HTML code to the Password reset results (password status) page of the Change passwords (PSS) module.

The plugin is set by the S STATUS EXT plugin point on the Modules > Change passwords (PSS) configuration page.

You cannot use the S STATUS EXT plugin to add interactive form elements.

The shipped cgilocalr plugin program allows you to enable and configure the Local Reset Extension.

Write a custom plugin to provide HTML to the password status page

Requirements

The CGI plugin is a console executable, which accepts information on standard input and writes results to standard output. See Writing plugins for general requirements.

Execution points

The Change passwords (PSS) module invokes a plugin to add HTML content to the main menu. Each time the page is requested, the plugin executes. See CGI plugin sequence of events for the general sequence of events.

Input

Input to the plugin includes:

"" "" = {
  "action" = "PRINT-FORM" # The action of the CGI
  "user" = "<profile ID>" # The user requesting the page
   
  "requester" = "<profile ID>" # The user requesting the page
   
  "cginame" = "pss" # The CGI running the plugin
  "host" "" = { #1 or more sets, each representing a target system
    "id" = "<target system ID>"
    "name" = "<target system name>"
    "type" = "<target system type>"
    "address" = "<target system address>"
    "adminid" = "<target system administrator ID>"
    "adminpass" = "<target system administrator password>"
    "userid" = "<user's account on the target system>"
     }

  "tags" "" = {#Data to be remembered through the current login session
    "<tag ID>" = "<tag value>" # 0 or more
    "LANG" = "en-us"
    "PS_LOCK_DIR" = "F:\\Locks\\"
  "html" = "" # unused
  }
}

The following is an example of the input received by the plugin:

 "" "" = {
     "action" = "PRINT-FORM"
     "user" = "user1id"
     "requester" = "user1id"
     "cginame" = "pss"
     "host" "" = {
       "id" = "AD"
       "name" = "ad"
       "type" = "WIN2K"
       "address" = "10.10.77.20/basedn=ou=wfou"
       "adminid" = "administrator"
       "adminpass" = "letmein!"
       "userid" = "user1id"
     }
     "tags" "" = {
       "LANG" = "en-us"
       "PS_LOCK_DIR" = "C:\\Program Files\\Bravura Security\\Bravura Security Fabric\\Locks\\"
     }
     "html" = ""
   }

Output

The following is an example of the output produced by the plugin:

"" "" = {
  "action" = "PRINT-FORM"
  "cginame" = "ida"
  "html" = ""
     <TABLE width=100% border=0 cellpadding=0 cellspacing=0>
     <TR>
     <TH COLSPAN=2 class=HEADTEXT>
     <nobr>Information for user manage1 on target AD</nobr>
     </TH>
     </TR>
     <TR>
     <TD valign=top COLSPAN=2 class=CELLTEXT>
     &nbsp;
     </TD>
     </TR>
     <TR>
     <TD valign=top COLSPAN=2 class=CELLTEXT>
     <strong>General</strong>
     </TD>
     </TR>
     <TR>
     <TD valign=top class=CELLTEXT>
     Distinguished name:
     </TD>
     <TD valign=top class=CELLTEXT>
     CN=Manage 1,OU=Users,OU=North America,DC=spacey-2k3,DC=local
     </TD>
     </TR>
     <TR>
     <TD valign=top class=CELLTEXT>
     Full name:
     </TD>
     <TD valign=top class=CELLTEXT>
     Manage 1
     </TD>
     </TR>
     <TR>
     <TD valign=top COLSPAN=2 class=CELLTEXT>
     &nbsp;
     </TD>
     </TR>
     </TABLE>
     <P>
  "requester" = "user1id"
  "user" = "manage1"
  "host" "" = {
    "address" = "10.10.77.20/basedn=ou=wfou"
    "adminid" = "administrator"
    "adminpass" = "Letmein1"
    "id" = "AD"
    "name" = "ad"
    "type" = "WIN2K"
    "userid" = "manage1"
  }
  "submit-buttons" "" = {
    "" = ""
  }
  "tags" "" = {
    "LANG" = "en-us"
    "PS_LOCK_DIR" = "C:\\Program Files\\Bravura Security\\Bravura Security Fabric\\Locks\\"
  }
}
In this section: