SOAP Web Service (Ticket)
Connector name |
|
Connector type | Executable with script |
Type (UI field value) | SOAP Web Service (Ticket) |
Target system versions supported / tested | Bravura Security Fabric uses the |
Connector status / support | Customer-Verified Clients may contact Bravura Security support for assistance with this connector. Troubleshooting and testing must be completed in the client's test environment as Bravura Security does not maintain internal test environments for the associated target system. |
Installation / setup | Interface programs are installed in the interface directory. Modify the sample |
See also
SCRIPT SYSTEMS > Soap Web Service shows you how to use the agtsoap agent to perform operations on applications that provide a SOAP web service interface for setting passwords and creating accounts.
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.cfgor
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 .
Targeting an application
Bravura Security Fabric provides the option of using the ticket target system name in event action fields in the Manage the system (PSA) module or Configure event (ITSM) module, rather than the program name. The security benefit is that all sensitive information (server address, admin credentials) is automatically passed to the program, rather than stored in the .cfg file in plain text.
For each application that uses a SOAP web service, add a target system in Bravura Security Fabric (Manage the System > Resources > Target systems).
Type is SOAP Web Service (Ticket) , listed under IT Service Management Systems .
Address is the name of the PSLang script file you created in the SOAP schema file. Ensure that the script is located in the \<instance>\script\ directory. For example:
{script=pxsoap-schema.cfg;}Administrator ID and Password are the login ID and password for the target system administrator you configured earlier.
If you are using a additional target system administrator, referenced in pxsoap-schema.cfg , add these credentials too and enable the System password option.