Single sign on with Agent Workspace
How to configure Genesys Softphone for single sign-on with Agent Workspace.
Genesys Softphone includes an HTTP/HTTPS connector to simplify using Genesys Softphone with Agent Workspace:
- Single sign-on—Agent Workspace controls the SIP settings for Softphone based on explicit Agent Workspace centralized options and agent login credentials (Place and DN).
- Simplified deployment—each agent workstation runs the same application and configuration files, avoiding workstation specific configuration.
- Password authentication—Agent Workspace passes the DN password as one of the parameters through the Genesys Softphone connector to allow the Softphone to securely login to SIP Server and avoid the need for MPLS.
Configuring Softphone for Agent Workspace
Softphone.config configuration file contains a connector section in the policy domain:
<Container name ="Genesys">
...
<domain name="policy">
...
<section name="connector">
<!-- Activates HTTP or HTTPS communication.
Requires a port defined in the port option. -->
<setting name="protocol" value="https"/>
<!-- Specifies the port used when communicating in HTTP or HTTPS -->
<setting name="port" value="8000"/>
<!-- Activates the SESSIONID in cookies -->
<setting name="enable_sessionid" value="1"/>
<!-- Gives a thumbprint string value Workspace
uses to select a certificate if the 'protocol' option
is set to HTTPS. -->
<setting name="certificate_search_value" value="55 20 C3 64 79 ED 13 87 FB C3 6C 99 54 D2 6C AC 11 61 BE CE"/>
<!-- Specifies if the Softphone application is auto started
or started by the client application.-->
<setting name="standalone" value="1"/>
</section>
...
</domain>
...
</Container>Codec priority
Use the enabled section of the codecs domain in the Softphone.config configuration file to specify the order in which audio codecs are given priority.
For example:
<domain name="codecs">
<section name="enabled">
<setting name="audio" value="opus,pcmu,pcma,G722,iSAC/16000,G729"/>
</section>
<section name="PCMU/8000"/>
<section name="PCMA/8000"/>
<section name="G722/16000"/>Any codec that is not explicitly included in the enabled section will not be used, even if the section for that codec is present in the configuration file.
To use the Genesys SIP Endpoint SDK 9.0 enabled section of the codecs domain, follow these guidelines:
- Codec names are case-insensitive. You can omit the clock rate portion of the section name unless needed to discriminate between two sections with the same name. The clock rate portion must be provided for iSAC.
- Specify codec parameters as a comma-separated list in parenthesis after an equals sign. You can use abbreviations such as "pt" for "payload_type".
- If there are codec conflicts, the value in the enabled section takes precedence over value in corresponding codec section, regardless of whether those values come from the configuration file. For example:
<setting name="audio" value="g729=(fmtp='annexb=no'),opus=(pt=125),pcmu,pcma"/>
<setting name="video" value="h264=(pt=120,fmtp='profile-level-id=420028')"/>- If codec parameters are specified in-line (or a particular codec does not require any parameters, such as the PCMU and PCMA codecs), then a separate codec section is not necessary. In any case, codecs specified in the "enabled" section do not require presence of corresponding section to take effect.
Signing on with Agent Workspace
Before starting Agent Workspace, agents need to have Softphone running. Administrators can specify that Softphone starts automatically when the Windows user logs in or agents can startup Softphone.
