API Server Settings
Overview
This topic explains settings for this service.
For more information, see Services Overview.
API Server Web Portal Settings
- Name
- Allows you to assign a meaningful name to this instance of API Server. There is no default value.
- Server Host
- Specifies the hostname or IP address of the server hosting this API Server. The default value is 127.0.0.1.
- Type
- Specifies whether this API Server will be used for Call Control (performing recording functions such as CALLSTART), Management Control (performing management functions such as IMPORTAGENT), or both. The default values are selected for Call Control and cleared for Management Control.
- Allowed Subnets
- Specifies subnets from which client requests are accepted. The default value is 255.255.255.255/0.
- Export Directory
- Specifies the temporary location to which files are written when requested for export in the NICE Uptivity Web Portal. The default value is C:\Exports.
- Web Server Port
- Specifies the TCP port on which the API Server receives HTTP WebAPI requests. The default value is 2012.
- Require Authentication
- Allows you to require that all HTTP requests include the credentials of a user in the Uptivity system (not Active Directory credentials), in HTTP Basic Authentication format. If authentication is required, other Uptivity components will not be able to authenticate to this server. For security purposes, some organizations choose to dedicate one API Server to Desktop Analytics, On-Demand, or both. This server would have call control enabled and authentication would be disabled, and the server could not export. A second dedicated API Server would be used for exporting. This server would have management control and authentication enabled. The default value is No.
- Response Format
- Specifies the format in which the API Server sends responses. This setting accepts the values SOAP and XML. The default value is XML.
- SSL
- Allows you to require that API communications use SSL with a specified certificate. This setting should only be enabled if the entire environment uses SSL. Mixing SSL and non-SSL components in an environment can cause issues. The default value is No.
- SSL Certificate
- Specifies the local path for the SSL certificate. This certificate must be in P12 format. This field should be left blank in non-SSL systems.
- SSL Password
- Specifies the SSL certificate password. This field should be left blank in non-SSL systems.
- TCP Port
- Specifies the TCP port on which API Server receives socket-based requests. The default value is 5620.
- Event Port
- Specifies the TCP port on which API Server receives event service calls from CTI Core. The default value is 5621.
- Require Authentication
- Allows you to require that all socket-based requests include the credentials of a user in the Uptivity system (not Active Directory credentials).