UTF-8 encoding of tokens for cross domain single signon

The use of UTF-8 encoding for strings within tokens used for cross domain single signon is specified in the WebSEAL configuration file.

[cdsso]
use-utf8 = {true|false}

Default is true.

When use-utf8 is set to false, strings are encoded using the local code page. Use this value when you implement cross domain single signon with versions of WebSEAL before version 5.1. WebSEAL versions before 5.1 do not use UTF-8 encoding for tokens. When you deploy an environment that includes these older servers, configure WebSEAL to not use UTF-8 encoding. This setting is necessary for compatibility with an earlier version. When this value is set to false, data loss can occur during conversion from UTF-8 to a non-UTF-8 local code page.

Parent topic: Web server configuration

Related concepts

• Content caching
• Communication protocol configuration
• IPv4 and IPv6 overview
• IPv6: Compatibility support
• IP levels for credential attributes
• LDAP directory server configuration
• WebSEAL worker thread configuration
• WebSEAL worker threads
• Global allocation of worker threads for junctions
• Per-junction allocation of worker threads for junctions
• HTTP data compression
• WebSEAL data handling by using UTF-8
• UTF-8 dependency on user registry configuration
• UTF-8 data conversion issues
• UTF-8 impact on authentication
• UTF-8 impact on authorization (dynamic URL)
• Encoding type usage
• UTF-8 support for uniform resource locators
• UTF-8 support in POST body information (forms)
• UTF-8 support in query strings
• UTF-8 encoding of tokens for e-community single signon
• UTF-8 encoding of cookies for failover authentication
• UTF-8 encoding of cookies for LTPA authentication
• UTF-8 encoding in junction requests
• Validation of character encoding in request data
• Set system environment variables
• Cross-Origin Resource Sharing (CORS) Support

Related tasks

• Specify the WebSEAL host name
• Modify the configuration file settings
• Configure WebSEAL for IPv6 and IPv4 requests

Related reference

• IPv6: Upgrade notes
• Allocation view of worker threads for junctions
• Supported wildcard pattern matching characters