belkast/soapClient
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Added description of new functionality

Browse Source
This commit is contained in:
Keith Armstrong 2025-01-07 15:43:49 -05:00
parent 075e527511
commit 2d12d9fe02
1 changed files with 34 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
README.md
View File

@ -8,12 +8,13 @@ soapClient.jar allows you to send data to a SOAP service using an XML template f
<li>SOAP Service URL</li> <li>SOAP Service URL</li>
<li>SOAP Service Username</li> <li>SOAP Service Username</li>
<li>SOAP Service Password</li> <li>SOAP Service Password</li>
<li>XML Template file</li> <li>Does SOAP Service require authentication</li>
<li>CSV Input File</li>
<li>Whether to use SSL</li> <li>Whether to use SSL</li>
<li>Java Keystore</li> <li>Java Keystore</li>
<li>Java Keystore Password</li> <li>Java Keystore Password</li>
<li>Whether to allow empty values</li> <li>XML Template file</li>
<li>CSV Input File</li>
<li>Are empty CSV values allowed</li>
</ul> </ul>
## Command line parameters ## Command line parameters
@ -28,7 +29,7 @@ This is the value to encrypt using the encryption key. You need to pass both <i>
This is the location of the properties file to be consumed by the program. This is the location of the properties file to be consumed by the program.
### --debug ### --debug
This is a true/false flag which specifies if the debug information is displayed on the screen. The debug information is <b>always</b> written to the <i>debug.log</i> file. This parameter takes no value and, if present, displays debug information on the screen. The debug information is <b>always</b> written to the debug.log file.
## Helper scripts ## Helper scripts
@ -69,14 +70,34 @@ This is the main file containing the settings used by the program, and one with
```toml ```toml
SHIM_URL = https://test.mycompany.com:8443/IDMProv/role/service SHIM_URL = https://test.mycompany.com:8443/IDMProv/role/service
PASSWORD = PT9TKHwFgJCxATJtAAMtMwtIF0UjFal6fo5riBN+ExY=
USERNAME = cn=keitha,ou=active,ou=users,o=belkast USERNAME = cn=keitha,ou=active,ou=users,o=belkast
XML_FILE = USER_TO_ROLE.xml PASSWORD = PT9TKHwFgJCxATJtAAMtMwtIF0UjFal6fo5riBN+ExY=
CSV_FILE = msalah.csv AUTH_REQUIRED = true
CSV_ALLOW_EMPTY_COLUMN_VALUES = true
SSL = true SSL = true
JAVA_KS_LOCATION = ldap.keystore JAVA_KS_LOCATION = ldap.keystore
JAVA_KS_PASSWORD = changeit JAVA_KS_PASSWORD = changeit
XML_FILE = USER_TO_ROLE.xml
CSV_FILE = msalah.csv
CSV_ALLOW_EMPTY_COLUMN_VALUES = true
```
### Default values
The settings listed below are not required to be included in the configuration file. If not present, they will be assigned the default values shown below.
<ul>
<li>AUTH_REQUIRED : true</li>
<li>SSL : true</li>
<li>CSV_ALLOW_EMPTY_COLUMN_VALUES : false</li>
</ul>
### Username and Password
If the configuration file specifies that authentication to the SOAP Service is required, and either the USERNAME or PASSWORD is not specified, you will be asked to enter the missing values.
```zsh
Please enter your username : jimbo
Please enter your password : Password123
``` ```
### XML template file ### XML template file
@ -207,13 +228,15 @@ If you run the <i>linux_runner.sh</i> bash script with no command line parameter
Usage: <main class> [options] Usage: <main class> [options]
Options: Options:
--debug --debug
Display debug information on the screen (true/false) Display debug information on the screen (no value required)
Default: false
--encrypt --encrypt
Value to encrypt using the Encryption Key Value to encrypt using the encryption key
* --key * --key
Encryption Key (must be 16 characters in length) Encryption key (must be 16 characters)
--props --props
Location of the properties file Location of the properties file
Default: props.conf
``` ```
### With command line parameters ### With command line parameters