Siebel CRM Desktop for IBM Notes Administration Guide > Customizing Authentication > CRM Desktop SSO Objects You Can Customize >

Interactive State Object

The interactive state object contains information about the state of the interactive authentication. The create_ia_state function of the sso_client object creates the interactive state object so that the interactive function of the sso_client object can use it when it calls the SSO script. CRM Desktop SSO uses the same interactive state object to do a callback from the code that handles the interactive authentication to the SSO script. For an example that uses a callback, see Interactive Function.

The ia_state object includes the following properties:

• url. A string that identifies the URL of the page that Internet Explorer displays when Siebel CRM SSO runs the following function:

  interactive()

  CRM Desktop SSO provides the current URL that the Web browser object processes. It does this during the callback. CRM Desktop SSO uses ia_state later as a callback to JavaScript, and the URL contains the current URL of the page that the browser control processes. For an example of this usage, see Example Code That Customizes CRM Desktop SSO.

• Åcookies. A string that identifies the cookies that are associated with the HTML page that CRM Desktop SSO loads into the control Internet Explorer.
• headers. A string that identifies any other HTTP headers that the Browser sends.
• post_data. A string that identifies the data that CRM Desktop SSO sends through an HTTP POST function to the Siebel Server. This property exists on form submission. CRM Desktop SSO uses HTML forms to get user information on the Web page and to send this information to the Siebel Server for processing. For example, to get the login name and password that the user enters during login.
• html_body. A string that identifies the HTML body of the document that CRM Desktop loads in Internet Explorer.
• status. A string that indicates the type of callback that the interactive authentication handler uses. It can include one of the following values:
  • before. CRM Desktop SSO sends the callback before it navigates the Web browser to a URL.
  • finished. CRM Desktop SSO sends the callback after the page download finishes.
  • cancelled. CRM Desktop SSO sends the callback if the user cancels the login and closes the dialog box.

    JavaScript requires that you enclose each string in double quotes.

• title. A string that contains the title of the dialog box. CRM Desktop SSO displays this title in the dialog box during interactive authentication. The default configuration that the SSO Connector uses adds the following prefix to any page title that the Siebel Server renders:

  SSO:

• dialog. A string that identifies the dialog object. For more information, see Dialog Object.