To install the SOAP Web Service, you must provide a server on which the following software is already installed:
Following versions are supported:
Windows Server 2016
Windows Server 2012 R2
Windows Server 2012
Windows Server 2008 R2 (non-Itanium based 64-bit) Service Pack 1 or later
Microsoft .NET Framework Version 4.7.2 or later
|
IMPORTANT: Start the SOAP Web Service installation locally on the server. |
To install the SOAP Web Service
Setting | Description | ||
---|---|---|---|
Application name | Name used as application name, as in the title bar of the browser, for example. | ||
Target in IIS | Internet Information Services web page on which to install the application. | ||
Enforce SSL | Specifies whether insecure websites are available for installation. If the option is set, only sites secured by SSL can be used for installing. This setting is the default value. If this option is not set, insecure websites can be used for installing. | ||
URL |
The application's Uniform Resource Locator (URL). | ||
Install dedicated application pool |
Specifies whether an application pool is installed for each application. This allows applications to be set up independently of one another. If this option is set, each application is installed in its own application pool. | ||
Application pool |
The application pool to use. This can only be entered if the option Install dedicated application pool is deactivated. If you use the DefaultAppPool default value, the application pool is defined using the following syntax: <application name>_POOL | ||
Identity |
Permissions for executing an application pool. A default identity or a user defined user account can be used. If you use the DefaultAppPool default value, the user account is defined using the following syntax: IIS APPPOOL\<application name>_POOL If you want to authorize another user, click ... next to the text box, activate the option Custom account, and enter the username and password. | ||
Web Authentication |
Specifies the type for authentication against the web application. You have the following options:
| ||
Database authentication |
Specifies the type for authentication against the One Identity Manager database. You have the following options:
|
The user account is used to add or replace files in the application directory.
The Web Installer generates the web application and the corresponding configuration files (web.config) for each directory.
Click Finish on the last page to end the program.
The SOAP Web Service configuration is found in Web.config in the installation directory. You can use any text editor to edit this file.
Section | Option | Permitted values | Description | ||||||
---|---|---|---|---|---|---|---|---|---|
connectionString | Database connection parameter. | ||||||||
runtimedirs | key="Cache" | value = "<path>" |
Directory for storing the cache directory. Default: value="C:\inetpub\wwwroot\<web service name>\App_Data\Cache\DB" | ||||||
key="AssemblyCache" | value = "<path>" |
Directory for storing the cache directory. Default: value="C:\inetpub\wwwroot\<web service name>\App_Data\Cache\Assemblies" | |||||||
settings | key="timeout" | value="<time>" |
Timeout for connections in the application pool. Default: value="00:05:00" | ||||||
key="maxconnectionlifetime" | value="<time>" |
Maximum length of time to maintain the connections. After this time limit has expired, all the connections are closed even if the timeout has not expired yet. Default: value="00:05:00" | |||||||
key="usepropertybag" | value = "True"
value = "False" |
Specifies whether a property bag is used. A property bag is used when object properties are populated in order to maintain the particular fill order that is required because of side effects or templates.
Default: value=”True" | |||||||
key="ignoreinvisiblevalues" | value = "True"
value = "False" |
Specifies whether values that the user is not permitted to see are not returned.
Default: value=”True" | |||||||
key = "logdirectory" | value = "<path>" |
Log directory. Default: value = "C:\inetpub\wwwroot\<web service name>\App_Data\Logs | |||||||
|
key = "allowwebservicemethods" |
value = "List of methods" |
Semicolon-delimited list of permitted web service methods. | ||||||
|
key = "allowfunctions" |
value = "List of functions" |
List of the permitted functions for each CallFunction method. If no other function is given, all functions are permitted. |
The SOAP Web Service can be reached over a browser under:
http://<server>/<application name>
https://<server>/<application name>
|
TIP: You can open the web server's status display in Job Queue Info. In Job Queue Info, select View | Server state in the menu and, on the Web servers tab, open the web server status display from the Open in browser context menu. |
In addition, API documentation is available here.
© 2021 One Identity LLC. ALL RIGHTS RESERVED. Feedback Terms of Use Privacy