|
The Sun OpenSSO Enterprise 8.0 Update 1 Release Notes contain information about Update 1, including new features, hardware and software requirements, and known issues with workarounds, if available. OpenSSO Enterprise 8.0 Update 1 is available as patch 141655-01 on http://sunsolve.sun.com/. This patch includes a WAR file (opensso.war) that you can deploy on Solaris (SPARCĀ® and x86 platforms), Linux, and Windows systems. OpenSSO Enterprise 8.0 Update 1 PatchesSun periodically releases patches for OpenSSO Enterprise 8.0 Update 1 on SunSolve. The following table shows the patch IDs for Update 1 and subsequent patch releases:
To download the latest patch for Update 1, click Download Latest Patch 141655. To determine if you should install a patch, check the README file available with the patch. Changes in OpenSSO Enterprise 8.0 Update 1 Patch 2 (141655-03)Additional OpenSSO Enterprise Web Container and Platform SupportPatch 141655-03 includes support for:
Known Issues and Limitations
OpenSSO Enterprise cannot create URLStreamHandler for WebLogic Server (CR 6867442)The OpenSSO Enterprise AMURLStreamHandlerFactory cannot create the URLStreamHandler for WebLogic Server, because WebLogic Server has preset the value for the java.protocol.handler.pkgs system property to The fix for CR 6867442 adds the new opensso.protocol.handler.pkgs property. Although this problem occurred on WebLogic Server, the fix affects all web containers. If you have java.protocol.handler.pkg in your setup or if you are planning to use java.protocol.handler.pkg, add this new property as follows:
Deploying the console.war file in patch 141655-03 generates a malformed goto URL (CR 6881715)If you deploy and configure the console.war file in patch 141655-03, when you access the login page, the goto URL page is malformed. Sun periodically releases patches to OpenSSO Enterprise 8.0 Update 1 on http://sunsolve.sun.com/. To find the latest patch for Update 1, search for patch ID 141655. To determine if you should install a patch, check the README file available with the patch. Each patch release includes an opensso.war file that you can deploy as follows:
For more information see Installing OpenSSO Enterprise 8.0 Update 1. What's New in OpenSSO Enterprise 8.0 Update 1
OpenSSO Enterprise 8.0 Update 1 also fixes a number of problems, as listed in the README file included with patch 141655-01. OpenDS as a User Data StoreYou can configure an external OpenDS server as the OpenSSO Enterprise 8.0 Update 1 user data store. See Using OpenDS as a User Data Store. Simplified OpenSSO WAR File CreationThe ability to create a specialized WAR file was present in OpenSSO Enterprise 8.0. In OpenSSO Enterprise 8.0 Update 1, the process has been simplified using the createwar.sh or createwar.bat script. See Creating a Specialized OpenSSO WAR File. Centralized SAMLv2 Error Conditions PageOpenSSO Enterprise 8.0 Update 1 provides a single page where you can view all SAMLv2 error conditions. This page is useful when you are troubleshooting a SAMLv2 configuration. See Centralized SAMLv2 Error Processing. Secure Attribute Exchange (SAE) Data EncryptionOpenSSO Enterprise 8.0 Update 1 supports Secure Attributes Exchange (SAE) data encryption. (SAE is also known as Virtual Federation.) See Encrypting Data in a Secure Attribute Exchange. FIPS Compliance ModeOpenSSO Enterprise 8.0 Update 1 supports Federal Information Processing Standards (FIPS) mode. See Configuring OpenSSO Enterprise 8.0 Update 1 in FIPS Mode. Support for New Web ContainersOpenSSO Enterprise 8.0 Update 1 supports the web containers described in the OpenSSO Enterprise 8.0 Release Notes and the following new web containers:
.NET FedletOpenSSO Enterprise 8.0 Update 1 includes the Fedlet.dll, template metadata files, and a sample application for implementing the Fedlet with .NET applications. See Using the .NET Fedlet with OpenSSO Enterprise 8.0 Update 1. Other Enhancements in OpenSSO Enterprise 8.0 Update 1
CR 6244578: New Property Warns Users if Browser Cookie Support is Disabled or Not AvailableThe new com.sun.identity.am.cookie.check property indicates whether OpenSSO server should check if cookie support is disabled or not available in the user's browser. A value of true causes OpenSSO server to display an error message if the browser does not support cookies or has not enabled cookies. Previously, if cookie support was disabled or not available on the user's browser and OpenSSO server was not in cookieless mode, authentication for a user failed without any errors. (Actually, authentication was done successfully, but OpenSSO server could not redirect the user to the OpenSSO protected web site.) To Set the com.sun.identity.am.cookie.check Property
Note – If OpenSSO server is expected to support cookieless mode for authentication, set this property to false (which is the default). CR 6770231: OpenSSO Enterprise 8.0 Update 1 Validates goto URLsOpenSSO Enterprise 8.0 Update 1 can validate a goto URL after a user logs in to prevent a hacker from sending the user to an imposter site in order to steal the user's personal information. To Set Valid goto URLs:
Additional Information – If a goto URL is found to be invalid, the user will be redirected to the default success login URL (/opensso/console). CR 6696910: New Property makes Event Notification Cache ConfigurableThe new com.sun.am.event.notification.expire.time property allows you to configure or disable the event notification cache in order to improve performance. After you set this property, restart the OpenSSO Enterprise 8.0 web container for the new value to take effect. CR 6740071: New Property Controls Session Cookie for Zero Page AuthenticationThe new com.sun.identity.appendSessionCookieInURL property determines whether OpenSSO Enterprise 8.0 Update 1 appends the session cookie to the URL for zero page authentication. To set the new com.sun.identity.appendSessionCookieInURL property:
The com.sun.identity.appendSessionCookieInURL property is hotswappable, which means that you don't have to restart the OpenSSO Enterprise 8.0 web container for a new value to take effect. CR 6691106: New Properties Prevent Multiple Site Monitor ThreadsThe amNaming log sometimes indicates multiple Site Monitor threads running for checking the same site. To prevent this problem, OpenSSO Enterprise 8.0 Update 1 provides improved synchronization to prevent the creation of the multiple Site Monitor threads for the same site. OpenSSO Enterprise 8.0 also includes these new properties:
After you set these properties, restart the OpenSSO Enterprise 8.0 web container for the new values to take effect. The fix for this problem also uses the following property:
CR 6797423: New property configures OpenSSO Enterprise server policy decision cacheThe new com.sun.identity.policy.resultsCacheMaxSize property allows you to configure the policy decision cache for OpenSSO Enterprise 8.0 Update 1 server. For example, a value of 1000 causes policy decisions to be cached for maximum of 1000 sessions, irrespective of the actual number of concurrent sessions on the server. CR 6785321: CRL and OSCP checking support JSS-based logicCertificate Revocation List (CRL) and Online Certificate Status Protocol (OCSP) checking now support the Network Security Services for Java (JSS) library, enabling FIPS mode when OpenSSO Enterprise 8.0 Update 1 is deployed on the Sun Java Web Server 7.0 Update 3 or later web container. CR 6657112: Redirect callback support is added for Distributed Authentication Server UIRedirect callback support (RedirectCallback), which is used to redirect users to an external website as part of the authentication process, now works when the login is through a Distributed Authentication Server UI. CR 6657367: CDCServlet removes the JavaScript enabled dependency for user's browserIf cross-domain single sign-on (CDSSO) is enabled for a policy agent, the CDCServlet can now redirect assertions (CDCRedirectServlet) for the agent, even if JavaScript is disabled for the user's browser. CR 6496155: Policy agents send token other than the IP address in cookie hijacking modePreviously, in cookie hijacking mode, policy agents sent the IP address of the server where they were installed to the OpenSSO Enterprise server. Now, the policy agent first sends the application SSO token. If the agent cannot obtain the application SSO token, the agent then sends the IP address to the OpenSSO Enterprise server. If strict DN checking is required for a deployment, OpenSSO Enterprise server includes the new The default value is false. If this property is set to true, the OpenSSO Enterprise server performs strict DN checking. If the agent sends an IP address, the OpenSSO Enterprise server considers the IP address to be an error. To set iplanet-am-session-dnrestrictiononly for strict DN checking:
CR 6697260: New property allows policy agent sessions to time outThe new com.iplanet.am.session.agentsessionidletime property sets the maximum idle timeout in minutes for policy agent sessions. The minimum value is 30 minutes. A value greater than 0 and less than 30 will be reset to 30. To set com.iplanet.am.session.agentsessionidletime:
CR 6811036: After upgrading from JES4, in co-existence mode, amadmin authenticates to configuration data storeDue to the fix for security issue 3924 in OpenSSO 8.0 Enterprise 8.0, the amadmin user was prevented from logging in to any authentication module other than the DataStore and Application authentication modules.
CR 6827616: SMS cache is disabled by default for the Client SDKAfter a Client SDK installation, the service management service (SMS) cache is disabled by default, which can cause performance issues. com.iplanet.am.sdk.caching.enabled=true com.sun.identity.idm.cache.enabled=true com.sun.identity.sm.cache.enabled=true Installing OpenSSO Enterprise 8.0 Update 1First, download patch 141655-01 from http://sunsolve.sun.com/. Then, install OpenSSO Enterprise 8.0 Update 1, as described in Installing OpenSSO Enterprise 8.0 Update 1. Hardware and Software Requirements For OpenSSO Enterprise 8.0 Update 1
Note - The hardware and software requirements for OpenSSO Enterprise 8.0 Update 1 represent the only environments in which it can be deployed with full support from Sun Microsystems. No support is provided for environments that do not meet the stated requirements. Policy Agent Support in OpenSSO Enterprise 8.0 Update 1
OpenSSO Enterprise 8.0 Update 1 Issues and Workarounds
CR 6830298: OpenSSO Enterprise Admin Tools Must be Re-installedIf you patch OpenSSO Enterprise 8.0 with Update 1, you must re-install the admin tools in Update 1 before you run the updateschema.sh or updateschema.bat script, because the script requires the Update 1 version of the ssoadm command-line utility. Workaround. Before you run the updateschema.sh or updateschema.bat script, install the Update 1 admin tools, as described in see Installing the OpenSSO Enterprise 8.0 Update 1 Admin Tools. CR 6823779: ssoadm cannot be used with Secure WebSphere Application Server 7.0If the admin tools (ssoAdminTools.zip) are configured to use the IBM JVM with a secure (SSL-enabled) WebSphere Application Server 7.0 instance, the ssoadm returns a fatal error. Workaround. To configure ssoadm, see Deploying IBM WebSphere Application Server 7.0 as the OpenSSO Enterprise 8.0 Update 1 Web Container. CR 6824420: Configuration fails for WebSphere Application Server 7.0 with Java 2 security enabledIf OpenSSO Enterprise 8.0 Update 1 is deployed with IBM WebSphere Application Server 7.0 and Java 2 security is enabled, the configuration fails. Workaround. Add the required permissions to the WebSphere Application Server 7.0 server.policy, as described in Deploying an IBM WebSphere Application Server 7.0 Web Container. CR 6836470: Hotfix Required to Use KDCs Hosted on Windows Server 2008OpenSSO Enterprise 8.0 Update 1 has added support for using KDCs hosted on Windows Server 2008. To use this new feature, however, you must install a Microsoft hotfix to KTpass on the Windows Server 2008 KDC before using the KDC for Windows Desktop SSO authentication. CR 6825011: Windows Desktop SSO Authentication fails with Login Exception on WebSphere Application Server 7.0Workaround. If OpenSSO Enterprise 8.0 Update 1 is deployed on IBM WebSphere Application Server 7.0 on Windows:
Set this new property using ssoadm or in the OpenSSO Enterprise Admin Console under Configuration > Sites and Servers > opensso-instance-name > Advanced. Then, restart the WebSphere Application Server 7.0 instance for the value to take effect. CR 6831600: Configurator buttons are not visible using Safari on a MacWhen running the Configurator using Safari on a Mac, the Next and Cancel buttons are not visible, which gives the impression that the configuration cannot continue. CR 6819848: Berkeley DB client does not failover to secondary Message Queue brokerIn a session failover configuration, the Berkeley DB client does not failover to the secondary Message Queue broker. OpenSSO Enterprise server, however, does failover CR 6834714: Permissions need updating for WebSphere Application Server 6.1If you are using IBM WebSphere Application Server 6.1 as the web container and the Java Security Manager is enabled, the securing permissions need to be updated. CR 6835816: After you enable FIPS mode, bootstrap file cannot be decryptedWorkaround. Before you enable FIPS mode, backup the bootstap file. Then, after you enable FIPS mode, replace the bootstrap file with the backup copy. For more information, see Configuring OpenSSO Enterprise 8.0 Update 1 in FIPS Mode CR 6831687: SAML2 post profile fails on the Service Provider (SP)Using JDK 1.6.x, when a Service Provider (SP) tries to verify a signed SAML2 response/assertion, the Identity Provider (IDP)throws a Null Pointer Exception.
CR 6828741: Configuring OpenSSO Enterprise 8.0 Update 1 as site throws exception in debug logsWhen you configure OpenSSO Enterprise 8.0 Update 1 using the console, if you provide the site details such as the load balancer and server instances, the configuration finishes successfully and you can log in. However, the debug logs contain an exception. Workaround. None. You can ignore the exception. CR 6833362: SAMLv2 returns error on WebLogic Server 10 with SOAP bindingIf you deploy OpenSSO Enterprise 8.0 Update 1 on WebLogic Server 10 for both the SP and IDP, configure the meta for SP and IDP for signing and encryption using the default keystore, and then terminate with SOAP binding, an error is returned. Workaround. Remove last two lines from idpArtifactResolution.jsp, idpMNISOAP.jsp, and spMNISOAP.jsp. Also, remove any empty spaces between %> and <%. OpenSSO Enterprise 8.0 Update 1 DocumentationIn addition to these Release Notes, additional OpenSSO Enterprise 8.0 documentation is available on the following site: http://docs.sun.com/coll/1767.1 Additional Sun Information and ResourcesYou can find additional useful information and resources at the following locations:
Deprecation Notifications and Announcements
How to Report Problems and Provide FeedbackIf you have questions or issues with OpenSSO Enterprise 8.0 Update 1, contact Sun Support Resources (SunSolve) at http://sunsolve.sun.com/. This site has links to the Knowledge Base, Online Support Center, and Product Tracker, as well as to maintenance programs and support contact numbers. If you are requesting help for a problem, please include the following information:
Accessibility Features for People With DisabilitiesTo obtain accessibility features that have been released since the publishing of this media, consult Section 508 product assessments available from Sun upon request to determine which versions are best suited for deploying accessible solutions. For information about Sun's commitment to accessibility, see http://sun.com/access. Related Third-Party Web SitesThird-party URLs are referenced in this document and provide additional, related information. |
Contents
|

