Skip to main content

Preparation

Before adding the target system to Bravura Security Fabric :

  • Install required software

  • Write a script to configure events

  • Write a script to map PSLang funtions to SOAP schema

  • Configure target administrators

Installing required software

Before targeting an application that provides a SOAP web service, ensure that the following are installed on all Bravura Security Fabric servers:

  • Microsoft .NET Framework 2.0+

  • Web Service Enhancements (WSE) 2.0 SP3 for Microsoft .NET

Writing a script to configure event actions using pxsoap

Write a pxsoap.cfg script file, using the PSLang scripting language, to configure event actions triggered by the pxsoap program. Modify the sample script included in the samples directory, and copy it to the \<instance>\script\ directory. If you cannot find the sample file, try re-running setup to modify your installation. Sample files are automatically installed with complete (typical) installations. You can select them in custom installations.

When configuring an event, you enter the program name or the target ID you set up earlier. In both cases, the program looks for the default script with the matching name.

You can write an alternative .cfg file; for example when you have multiple targets of the same type. When you configure an event, you specify the file using the -cfg parameter; for example:

  • pxsoap.exe -cfg myfile.cfg

    or

  • MYSOAP -cfg myfile.cfg

Writing a SOAP schema file

pxsoap-schema.cfg is a KVGroup configuration file that maps built-in exit trap functions in PSLang to the SOAP messages on the Web service. For example; the ability to create, search or update tickets on a helpdesk system.

Each event action function (such as create, search, update) can be called in a pxsoap.cfg script and are mapped to the actions defined by the schema.

In the script that calls the function "initializeInterface", the configuration file is set as one of the parameters to the associative array (namely "cfg").

See SOAP Scripts for information about creating KVGroup that defines the SOAP message and interface with the SOAP interface. This also includes more details on how to pass parameters such as the schema cfg file to pxsoap

Configuring target system administrators

In most cases, Bravura Security Fabric uses a designated account (for example, psadmin) on the SOAP web service target system.

Ensure that the designated account can log into the application from the Bravura Security Fabric server.

If a sysid and syspwd is referenced in the pxsoap-schema.cfg script, an additional target system administrator that uses a system password is required.

Ensure that you set and note the accounts’ passwords. You will be required to enter the login ID and password when you add the target system to Bravura Security Fabric .

In this section: