{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"maxLevel":{"value":"3"},"minLevel":{"value":"3"}},"macroMetadata":{"macroId":{"value":"af906618-05f4-41fd-8d53-c99a514984c6"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"221ddbbc-2b3f-4f3f-b24b-b88b793b094d"}},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Upgrades MUST be done in place!","type":"text"}]},{"type":"paragraph","content":[{"text":"If you are upgrading, PLEASE follow the directions on the ","type":"text"},{"text":"Upgrading","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631513"}}]},{"text":" page and do NOT install the new version separately and then attempt to apply your old configuration files. You MUST upgrade \"in place\" by using an installation directory that contains a copy of the previously working configuration.","type":"text"}]},{"type":"paragraph","content":[{"text":"Failure to do so will result in a non-working system in the majority of cases because there are absolutely essential differences between the output of the installer in the two cases to prevent your configuration from being altered in unexpected ways.","type":"text"}]},{"type":"paragraph","content":[{"text":"This problem is exacerbated by the extent of the internal changes made to V4.1 and the results of combining old and new files without an extreme amount of effort will be unpleasant. It is urgent that people heed this warning and attempt to modernize settings (if at all) only after upgrading and verifying the behavior of the system.","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Upgrade Plugins First","type":"text"}]},{"type":"paragraph","content":[{"text":"Less critically than the above warning, it’s advisable to upgrade any plugins you may have installed (meaning official plugins using the machinery introduced with V4.1 of the IdP) before upgrading the IdP itself, as this may prevent some extra warning noise in the log (or outright incompatibility issues noted by the installer). Upgrade and test those plugin features, and once those are validated, you can proceed to upgrade the IdP itself.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Please review these release notes before upgrading your system. You should review the notes for all the versions subsequent to the one you're running prior to upgrade, including referring back to older ","type":"text"},{"text":"V3 notes","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP30/pages/2494726503"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Also be aware of the following issues regarding container or Java compatibility:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"LDAPonJava","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631798"}}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Known Bugs","type":"text"}]},{"type":"paragraph","content":[{"text":"These are known issues in the code that are likely to affect deployers and have yet to be fixed or that require some intervention because of how upgrades work.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://shibboleth.atlassian.net/browse/IDP-1820"}}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This is a change required to ","type":"text"},{"text":"web.xml","type":"text","marks":[{"type":"em"}]},{"text":" for systems that have been upgraded from prior to V3.2 ","type":"text"},{"text":"and","type":"text","marks":[{"type":"strong"}]},{"text":" have been maintaining their own copy of ","type":"text"},{"text":"web.xml","type":"text","marks":[{"type":"em"}]},{"text":" since then. The fix needed for this is documented below under V4.1.0 under Breaking Changes → Deployment Descriptor Issue.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://shibboleth.atlassian.net/browse/IDP-1625"}}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This issue breaks the Cancel option in the ","type":"text"},{"text":"Duo","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631604"}}]},{"text":" login flow when the ","type":"text"},{"text":"CSRF","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1280180737"}}]},{"text":" feature is enabled. The fix is documented in the issue and can be applied directly to the duo.vm template. Since it involves a template, the fix is manual.","type":"text"}]}]}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.3.3 (April 15th, 2024)","type":"text"}]},{"type":"paragraph","content":[{"text":"This is a patch release to address a Spring Framework ","type":"text"},{"text":"advisory","type":"text","marks":[{"type":"link","attrs":{"href":"https://spring.io/security/cve-2024-22262"}}]},{"text":", a repeat (actually third time) of the same URL parsing bug that resulted in the previous update and impacts the CAS protocol support feature.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.3.2 (March 21, 2024)","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"jira","parameters":{"macroParams":{"server":{"value":"System Jira"},"jqlQuery":{"value":"filter=10065 "},"count":{"value":"true"},"serverId":{"value":"f52c7d31-6eab-3f0e-93c3-231b5754d506"}},"macroMetadata":{"macroId":{"value":"6f5b64d3-534b-46c7-b5df-d7ab84062a2a"},"schemaVersion":{"value":"1"},"title":"Jira Legacy"}},"localId":"78cad18f-c8b2-4e9c-b988-63152b04859c"}}]},{"type":"paragraph","content":[{"text":"This is a patch release to roll up bug fixes and update dependencies on the old branch of the software, and intended to be the final V4 release barring additional security issues requiring further releases. It addresses the Spring Framework bug noted in an ","type":"text"},{"text":"advisory","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.net/community/advisories/secadv_20240320.txt"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.3.1.4 (Windows only) (November 3, 2023)","type":"text"}]},{"type":"paragraph","content":[{"text":"This is a service release of the Windows installation package which updates Jetty to 10.0.18, addressing a potential memory leak that might impact some deployers.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.3.1.3 (Windows only) (October 11, 2023)","type":"text"}]},{"type":"paragraph","content":[{"text":"This is a service release of the Windows installation package which updates Jetty to 10.0.17, addressing ","type":"text"},{"text":"security advisories","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.eclipse.org/lists/jetty-announce/msg00181.html"}}]},{"text":" issued by the Jetty Project. These vulnerabilities only impact use of HTTP/2, which is not supported by our delivered Jetty installation, but we are updating out of caution.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.3.1.2 (Windows only) (September 15, 2023)","type":"text"}]},{"type":"paragraph","content":[{"text":"This is a service release of the Windows installation package which updates Jetty to 10.0.16, addressing ","type":"text"},{"text":"security advisories","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.eclipse.org/lists/jetty-announce/msg00180.html"}}]},{"text":" issued by the Jetty Project.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.3.1.1 (Windows only) (April 19, 2023)","type":"text"}]},{"type":"paragraph","content":[{"text":"This is a service release of the Windows installation package which updates Jetty to 10.0.15, addressing a pair of ","type":"text"},{"text":"security advisories","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.eclipse.org//lists/jetty-announce/msg00176.html"}}]},{"text":" issued by the Jetty Project.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.3.1 (March 30, 2023)","type":"text"}]},{"type":"paragraph","content":[{"text":"This is a patch release to address pair of regressions (one serious).","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://shibboleth.atlassian.net/browse/IDP-2084"}}]},{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://shibboleth.atlassian.net/browse/IDP-1685"}}]},{"type":"paragraph","content":[{"text":"There are no other changes in this release.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.3.0 (January 18, 2023)","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"jira","parameters":{"macroParams":{"server":{"value":"System JIRA"},"jqlQuery":{"value":"filter=10058 "},"count":{"value":"true"},"serverId":{"value":"f52c7d31-6eab-3f0e-93c3-231b5754d506"}},"macroMetadata":{"macroId":{"value":"376b9efb-c60b-4015-8820-db82334d65d1"},"schemaVersion":{"value":"1"},"title":"Jira Legacy"}},"localId":"a3a52801-05c4-44ae-90b3-629afd307f5b"}}]},{"type":"paragraph","content":[{"text":"This is a small(ish) feature release expected to wrap up work on the V4 branch. It contains some additional deprecation and at-risk warnings for features either scheduled for removal in V5 or being considered for removal in a future version. Please check your warning log regularly for these warnings to ensure that you aren’t caught off guard or have the opportunity to express any concerns regarding any at risk features.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Changes to Existing Behavior","type":"text"}]},{"type":"paragraph","content":[{"text":"When proxying (i.e., using the ","type":"text"},{"text":"SAML login flow","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1282539600"}}]},{"text":" feature), the IdP will now include a ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" element in the request containing the original requesting SP's entityID. This is a requirement of the standard and was a bug by omission. In the event that you wish to suppress this behavior either out of concern for privacy or due to bugs on the part of other actors in the system, the ","type":"text"},{"text":"ignoreScoping","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631694"}}]},{"text":" profile setting will suppress the generation of (and the evaluation of) the element altogether, though this is contrary to the standard.","type":"text"}]},{"type":"paragraph","content":[{"text":"A change was made to the feature allowing the IdP to auto-search for property files to load at startup. Prior to this version, if any directories under the search tree were unreadable due to access control, IdP startup would fail. With this release, the code is now trapping that error and startup continues, allowing this to be done deliberately to hide content from the IdP. Since this error can only be logged to the container’s log (it happens prior to the IdP starting up), it may be less obvious that it’s happening if it’s by mistake.","type":"text"}]},{"type":"paragraph","content":[{"text":"Deployers should ensure their containers are logging appropriately in some way (this is outside the scope of the IdP itself, though our Jetty examples do include it) and be aware there could be helpful information there.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Miscellaneous Changes","type":"text"}]},{"type":"paragraph","content":[{"text":"The most impactful change is a harbinger of a necessary adjustment that will be coming with V5.0 impacting any scripts or components that require injection of the HttpServletRequest or HttpServletResponse via the ","type":"text"},{"text":"shibboleth.HttpServletRequest","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"shibboleth.HttpServletResponse","type":"text","marks":[{"type":"strong"}]},{"text":" beans, which are now deprecated in favor of a new pair of beans, ","type":"text"},{"text":"shibboleth.HttpServletRequestSupplier","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"shibboleth.HttpServletResponseSupplier","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"For the time being, uses of those beans will produce deprecation warnings, but they will be removed in V5.0. Remediating the warning requires adding the “Supplier” suffix to the end of the bean names at the point of injection, and then adding a call to get() in between the original reference to the bean and the servlet method called.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example, this script line relying on the “custom” extension point to access the user agent string:","type":"text"}]},{"type":"codeBlock","content":[{"text":"var ua = custom.getHeader(\"User-Agent\");","type":"text"}]},{"type":"paragraph","content":[{"text":"becomes this (the only change is the additional indirection through the ","type":"text"},{"text":"get()","type":"text","marks":[{"type":"strong"}]},{"text":" method):","type":"text"}]},{"type":"codeBlock","content":[{"text":"var ua = custom.get().getHeader(\"User-Agent\");","type":"text"}]},{"type":"paragraph","content":[{"text":"The quickest way to remediate the issue is to grep for the old bean names, adjust them whereever they’re spotted, and then track back to where they’re used (usually via scripts as in the above example) and add the indirection method.","type":"text"}]},{"type":"paragraph","content":[{"text":"See also ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/3139993601"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"New Features","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Administrative Logout","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/3031990275"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Authentication Audit Logging","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631711"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Explicit support for Date/Time-valued Attributes (see ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/3041263617"}},{"text":", ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/3036381185"}},{"text":", and ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1272054348"}},{"text":")","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":" New Properties","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"See ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/3031990275"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.xml.strictEntityResolution","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.authn.audit.enabled","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631711"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.authn.*.audit.enabled","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631711"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.authn.*.audit.category","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631711"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.authn.*.audit.format","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631711"}}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"New Beans","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"See ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/3031990275"}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.HttpServletRequestSupplier","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.HttpServletResponseSupplier","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.DecryptionRecipients","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.authn.*.AuditExtractors","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631711"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.authn.*.DefaultAuditExtractors","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631711"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.Conditions.SimpleAttribute","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631700"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.Conditions.DynamicAttribute","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631700"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.Conditions.RegexAttribute","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631700"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.Conditions.DateAttribute","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631700"}}]}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.2.1.1 (July 6, 2022)","type":"text"}]},{"type":"paragraph","content":[{"text":"This is a service release of the Windows installation package which addresses a Jetty logging issue and updates Jetty to 10.0.11 to address a memory leak.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.2.1 (April 18, 2022)","type":"text"}]},{"type":"paragraph","content":[{"text":"This is a fixed package to address a regression that caused the spymemcached library to be omitted. Only users of the memcache storage option would be impacted.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.2.0 (April 15, 2022)","type":"text"}]},{"type":"paragraph","content":[{"text":"This is a relatively “light” feature release that mainly exists to support API changes needed for some of our plugins, which have been updated along with it and require this version to use.","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"jira","parameters":{"macroParams":{"server":{"value":"System JIRA"},"jqlQuery":{"value":"filter=10035 "},"count":{"value":"true"},"serverId":{"value":"f52c7d31-6eab-3f0e-93c3-231b5754d506"}},"macroMetadata":{"macroId":{"value":"3815baf3-f546-48be-a940-ac8045832c84"},"schemaVersion":{"value":"1"},"title":"Jira Legacy"}},"localId":"ec11f9f1-fc8f-420b-b3c0-f46e5fee9cb2"}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Changes to Existing Behavior","type":"text"}]},{"type":"paragraph","content":[{"text":"A regression in all 4.x releases was identified in the way the ","type":"text"},{"text":"Attribute-Based Subject C14N","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631602"}}]},{"text":" feature handles scoped attribute values such that only the value portion would be returned and used, ignoring the scope. For example, an eduPersonPrincipalName of “foo@example.org” would be returned as “foo”. This was easily fixed, but MAY impact existing behavior if the “broken” behavior were relied on. This can be remedied by adjusting the configuration to transform the scoped value back into an unscoped one but is something that could alter behavior following an upgrade until it’s addressed.","type":"text"}]},{"type":"paragraph","content":[{"text":"The support for auto-loading files that end in “.properties” was apparently broken in such a manner that the V4.1 releases may have excluded any file also named ","type":"text"},{"text":"idp.properties","type":"text","marks":[{"type":"em"}]},{"text":" regardless of location. The new version was fixed to properly handle all paths as unique regardless of filename and load such files, so you should NOT store any “backup” files or copies of your property files inside the ","type":"text"},{"text":"conf","type":"text","marks":[{"type":"strong"}]},{"text":" tree. Note that the new release also logs any duplicate properties it detects for debugging. This will normally be sent to the container’s logging sink because it happens before the IdP is “started” enough to log things itself.","type":"text"}]},{"type":"paragraph","content":[{"text":"A long-standing design flaw was fixed so that deployers can configure inbound SAML ","type":"text"},{"text":"profile interceptor","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631714"}}]},{"text":" flows without having to “repeat” a built-in interceptor flow that implements some of the inbound security handling logic. We are unaware of widespread (or any?) use of the inbound profile interceptor hook, but if it’s in use, there are possibly unneeded duplicate references to a flow ID such as “security/saml2-sso” or similarly-named flows that need to be removed. The duplicate reference will cause message replay failures because the flow will be run twice.","type":"text"}]},{"type":"paragraph","content":[{"text":"The CAS implementation was modified to better support consent by storing consented attribute IDs inside service ticket state for recovery during validation. This allows consent to be enabled and honored during the first hop of ticket validation, even if the consent is stored client-side or was granted only for a single request.","type":"text"}]},{"type":"paragraph","content":[{"text":"A ","type":"text"},{"text":"bug","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/browse/IDP-1936"}}]},{"text":" dating back to the earliest Shibboleth releases was corrected to prevent the IdP from issuing duplicate SAML Attributes with the same fully-qualified name. The IdP now detects this and merges the values such that a single Attribute is produced with all of the values. This seems to have been a behavior people had somehow depended on, though doing so would depend on bugs in an SP in the first place since the result of processing 2 Attributes with 1 value and 1 Attribute with 2 values cannot be different in a compliant SP implementation.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"User Interface Changes","type":"text"}]},{"type":"paragraph","content":[{"text":"The original view templates and stylesheets have been replaced in this release with a freshened set that are intended to be more modern and accessible. The look and feel is still assumed to be inadequate for any use other than testing, but may provide a better baseline to adjust. The name/location of the “common” stylesheet is adjustable with a message property.","type":"text"}]},{"type":"paragraph","content":[{"text":"The new placeholder stylesheet and logos have different filenames from earlier versions, so are installed automatically on new or upgraded installs. This is necessary so that installing modules that copy in new Velocity templates will result in at least a usable configuration. Older views that already exist will never be overwritten by upgrades, so they will continue to reference whatever stylesheets were used before.","type":"text"}]},{"type":"paragraph","content":[{"text":"See the ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/2934734849"}},{"text":" topic for more information.","type":"text"}]},{"type":"paragraph","content":[{"text":"Another “UI-adjacent” change is adding support for post-authentication interceptor flows into the ","type":"text"},{"text":"Administrative","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631720"}}]},{"text":" flow layer, in particular the ","type":"text"},{"text":"Hello World","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1289683553"}}]},{"text":" flow. This allows easier demoing and testing of features like consent or expiring password warnings within the IdP itself.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Logout Changes","type":"text"}]},{"type":"paragraph","content":[{"text":"This release contains a few new options and optimizations to improve logout behavior and quiet noise in the logs, and are worth a review if you operate an IdP with a lot of SPs that do not support logout.","type":"text"}]},{"type":"paragraph","content":[{"text":"It includes an automatic behavioral change that tracks the endpoint used to deliver an assertion when starting a session, and uses that URL when selecting a logout endpoint to use if there are multiple endpoints spanning different virtual hosts or paths. The endpoint selected will contain the longest matching sequence of characters starting from the beginning of the URL(s). This approach is notably more compatible with Shibboleth SPs that are virtually hosted with a single entityID.","type":"text"}]},{"type":"paragraph","content":[{"text":"Another automatic change eliminates attempts to issue logout requests to SAML 2.0 SPs whose metadata contains no logout endpoints. This should reduce the extra noise of EndpointResolutionFailed events in the log and improve performance.","type":"text"}]},{"type":"paragraph","content":[{"text":"A new property named ","type":"text"},{"text":"idp.logout.assumeAsync","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631719"}}]},{"text":" can be enabled to handle SPs that can issue logout requests but do not properly handle inbound logout requests or responses. Enabling the option allows an IdP administrator who controls the SP's metadata to remove the broken logout endpoints from the metadata without preventing the handling of logout requests because of \"unable to respond\" failures.","type":"text"}]},{"type":"paragraph","content":[{"text":"A new property named ","type":"text"},{"text":"idp.logout.propagationHidden","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631719"}}]},{"text":" can be enabled to hide the list of services and logout status during logout propagation. Enabling this will require other template changes to properly report the logout to the user but allows the logout propagation to be hidden without editing style sheets or changing system files.","type":"text"}]},{"type":"paragraph","content":[{"text":"A new bean named ","type":"text"},{"text":"shibboleth.PlaintextNameIDFormats","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631719"}}]},{"text":" can be defined to suppress encryption of particularly formats that are not sensitive enough to require encryption (e.g., transient IDs when query support is not enabled). This further optimizes performance when lots of logouts are propagated at once.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Session Enhancements","type":"text"}]},{"type":"paragraph","content":[{"text":"The bean ","type":"text"},{"text":"shibboleth.SessionAddressLookupStrategy","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631620"}}]},{"text":" can be used to source the “address” associated with an IdP session in an arbitrary way, allowing a wider variety of techniques for managing session affinity with clients. The IdP no longer requires that the address be in the form of an IP address, though it remains aware of that as a default.","type":"text"}]},{"type":"paragraph","content":[{"text":"Support for adjusting cookie names used by the IdP has been extended to cover most/all use cases, including the session cache. This is NOT intended to encourage any dependency on the names of the cookies, but rather to support ongoing hackery around the web for changing cookie behavior based on name, notably the Google invention of a __Host- prefix to prevent domain-scoped cookies from being fed into sensitive services. See ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/3140714497"}},{"text":" for examples.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Miscellaneous Changes","type":"text"}]},{"type":"paragraph","content":[{"text":"Display name and descriptive information associated with attributes used on the ","type":"text"},{"text":"consent ","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631715"}}]},{"text":"view is now determined in a just-in-time fashion. This reduces the processing needed for those deployments (or specific attributes) which do not require consent. This change should be irrelevant unless you are using an externally-developed feature using the old (and now deprecated) APIs. Legacy behavior can be re-established by using the ","type":"text"},{"text":"idp.service.attribute.resolver.suppressDisplayInfo","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631674"}}]},{"text":" property.","type":"text"}]},{"type":"paragraph","content":[{"text":"The startup sequence now logs any duplicate properties it finds to help with debugging. This is generally only visible in the container log prior to IdP “startup” so requires proper logging configuration at that layer.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"New Properties","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.logout.assumeAsync","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631719"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.logout.propagationHidden","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631719"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.session.cookieName","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631620"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.authn.SPNEGO.cookieName","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631622"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.policy.assertionLifetime","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.soap.httpClient","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.service.attribute.resolver.suppressDisplayInfo","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.velocity.runtime.strictmode","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/2891251713"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.velocity.space.gobbling","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/2891251713"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.warning.notifyCookiePrefix","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1289683459"}}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"New Beans","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.PlaintextNameIDFormats","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631719"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.ComputedIdSaltLookupStrategy","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631673"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.SessionAddressLookupStrategy","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631620"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.CorsConfigurations","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/2958163969"}}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"New Messages","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.css","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/2934734849"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.logout.hidden","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631719"}}]}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.1.7 (April 18, 2022)","type":"text"}]},{"type":"paragraph","content":[{"text":"This is a patch release to update to Spring Framework 5.3.19 in response to the ","type":"text"},{"text":"RCE vulnerability","type":"text","marks":[{"type":"link","attrs":{"href":"https://spring.io/blog/2022/04/13/spring-framework-data-binding-rules-vulnerability-cve-2022-22968"}}]},{"text":" reported against Spring MVC.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.1.6 (March 31, 2022)","type":"text"}]},{"type":"paragraph","content":[{"text":"This is a patch release to update to Spring Framework 5.3.18 in response to the ","type":"text"},{"text":"RCE vulnerability","type":"text","marks":[{"type":"link","attrs":{"href":"https://spring.io/blog/2022/03/31/spring-framework-rce-early-announcement"}}]},{"text":" reported against Spring MVC.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.1.5 (January 19, 2022)","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"jira","parameters":{"macroParams":{"server":{"value":"System JIRA"},"jqlQuery":{"value":"filter=10043 "},"count":{"value":"true"},"serverId":{"value":"f52c7d31-6eab-3f0e-93c3-231b5754d506"}},"macroMetadata":{"macroId":{"value":"3c0e4123-6e89-49aa-b96c-7ef3b7dbe0f9"},"schemaVersion":{"value":"1"},"title":"Jira Legacy"}},"localId":"7fefd42d-72d2-4c92-816f-974bec2fab16"}}]},{"type":"paragraph","content":[{"text":"This is a patch release primarily to update logback, the logging solution we provide by default. A few other dependencies were also updated to address open CVEs, including Spring.","type":"text"}]},{"type":"paragraph","content":[{"text":"The new logback version was issued in response to the log4shell debacle, and includes some hardening of features and the removal of other features to reduce the attack surface, though logback itself did not have any meaningful vulnerability that wouldn’t require compromise of its configuration file to begin with.","type":"text"}]},{"type":"paragraph","content":[{"text":"While it’s possible some deployers may have made use of the ","type":"text"},{"text":"removed features","type":"text","marks":[{"type":"link","attrs":{"href":"https://logback.qos.ch/news.html"}}]},{"text":", we’d rather err on the side of caution and the removed features will eventually be impossible to support anyway in order to keep up with any subsequent logback versions. Those with a real need for any of the removed features could choose to switch to an alternate logging solution, though some custom development will usually be required for that.","type":"text"}]},{"type":"paragraph","content":[{"text":"Please note that the IdP does not, and will never, require write access to its configuration. Many potential vulnerabilities may rely on elevation of privilege by leveraging one bug to make a change to a configuration file that in turn exposes the system to an RCE. It is a good idea to make sure the configuration is owned by a different account than the one used to run the IdP’s JVM, and so make the configuration read-only. Just making the files read-only is not sufficient since ownership is enough to allow the mode to be changed back. This is not new, and is very general advice, but it’s worth remembering.","type":"text"}]},{"type":"paragraph","content":[{"text":"The version of Jetty provided with the Windows installer has been refreshed to the latest 9.4 revision. Note that some earlier versions dating back to 9.4.39 and possibly some later revisions exhibited a bug on Linux observed to cause low priority CPU exhaustion (noticeable but not such that higher priority activity would be interrupted). This issue resolved itself with the version included in this release. It is unknown to what extent this issue may or may not impact Windows.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.1.4 (July 27, 2021)","type":"text"}]},{"type":"paragraph","content":[{"text":"This is a patch release that supersedes V4.1.3 and fixes a regression introduced into that version.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.1.3 (July 23, 2021)","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"jira","parameters":{"macroParams":{"server":{"value":"System JIRA"},"jqlQuery":{"value":"filter=10034 "},"count":{"value":"true"},"serverId":{"value":"f52c7d31-6eab-3f0e-93c3-231b5754d506"}},"macroMetadata":{"macroId":{"value":"27c4eeaa-8069-47f9-bdd0-6306e1d9c4b5"},"schemaVersion":{"value":"1"},"title":"Jira Legacy"}},"localId":"74e2b1d6-27f3-4738-af86-c858b85bc93c"}}]},{"type":"paragraph","content":[{"text":"This is a patch release, primarily addressing ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://shibboleth.atlassian.net/browse/IDP-1833"}},{"text":", which prevented the new ","type":"text"},{"text":"Duo plugin","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDPPLUGINS/pages/1374027959"}}]},{"text":" from functioning on Windows.","type":"text"}]},{"type":"paragraph","content":[{"text":"Unfortunately it contains a regression that breaks the SAML proxying support, so please refer to the V4.1.4 release for the Duo fix, now available.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.1.2 (May 27, 2021)","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"jira","parameters":{"macroParams":{"server":{"value":"System JIRA"},"jqlQuery":{"value":"filter=10033 "},"count":{"value":"true"},"serverId":{"value":"f52c7d31-6eab-3f0e-93c3-231b5754d506"}},"macroMetadata":{"macroId":{"value":"2208770e-57d3-42ce-97cb-0293136605ca"},"schemaVersion":{"value":"1"},"title":"Jira Legacy"}},"localId":"a0257d83-c7af-42e8-9dd8-225b6bfa6b20"}}]},{"type":"paragraph","content":[{"text":"This is a patch release addressing some bugs and removing some dependencies that are no longer required for the core IdP to run.","type":"text"}]},{"type":"paragraph","content":[{"text":"Please note that there is no V4.1.1. An issue with dependency versions identified during the release process led to that version being abandoned and replaced immediately by this version.","type":"text"}]},{"type":"paragraph","content":[{"text":"Also note that the OIDC plugins have all been updated in conjunction with this release (the installer should note the need to update them). The Jira filter above includes all of the issues addressed in both the IdP and the updated plugins.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you use the ","type":"text"},{"text":"X509","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631625"}}]},{"text":" login flow, the workaround required to address the regression in V4.1 is no longer required, so you should remove ","type":"text"},{"text":"edit-webapp/WEB-INF/classes/net/shibboleth/idp/flows/authn/x509-authn-beans.xml","type":"text","marks":[{"type":"em"}]},{"text":" from your system prior to upgrading, or do so and rebuild the war after.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.1.0.1 (Windows only) (April 5, 2021)","type":"text"}]},{"type":"paragraph","content":[{"text":"This is a service release of the Windows installation package which updates Jetty to 9.4.39, addressing several security advisories issued by the Jetty Project.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.1.0 (March 24, 2021)","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"jira","parameters":{"macroParams":{"server":{"value":"System JIRA"},"jqlQuery":{"value":"filter=10032 "},"count":{"value":"true"},"serverId":{"value":"f52c7d31-6eab-3f0e-93c3-231b5754d506"}},"macroMetadata":{"macroId":{"value":"86d8769e-6634-43ce-81ac-a992c4ea0390"},"schemaVersion":{"value":"1"},"title":"Jira Legacy"}},"localId":"7e880d16-fd4f-4c81-8086-7e2899055110"}}]},{"type":"paragraph","content":[{"text":"This is a significant new feature release that includes a larger than usual number of new configuration options, but these are backward-compatible and mostly simplify things for new deployers. The new ","type":"text"},{"text":"Plugin","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1294074003"}}]},{"text":" and ","type":"text"},{"text":"Module","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1294073981"}}]},{"text":" layers are a key addition in support of an initial set of add-on features described in the ","type":"text"},{"text":"IdP Plugins","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDPPLUGINS"}}]},{"text":" wiki space.","type":"text"}]},{"type":"paragraph","content":[{"text":"A section has been added to the ","type":"text"},{"text":"Upgrading","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631513"}}]},{"text":" page specific to this release. Note especially that previous versions of the OIDC OP extension are ","type":"text"},{"text":"not","type":"text","marks":[{"type":"strong"}]},{"text":" compatible with this release, nor will many of the older OIDC configuration settings work with the new plugin without some (usually small) alterations. See ","type":"text"},{"text":"OIDC OP Upgrading","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDPPLUGINS/pages/1376878984"}}]},{"text":" for details.","type":"text"}]},{"type":"paragraph","content":[{"text":"More specifics can be found among the various topics, but you may wish to review the new material on ","type":"text"},{"text":"ModuleConfiguration","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1294073981"}}]},{"text":" and consider disabling any modules associated with unused features. This will remove some unchanged files outright and rename others so that you can find and remove them. A new install of V4.1 only enables the \"idp.authn.Password\" and \"idp.admin.Hello\" modules (which support the ","type":"text"},{"text":"Password","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631611"}}]},{"text":" login flow and the new ","type":"text"},{"text":"Hello World","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1289683553"}}]},{"text":" flow respectively).","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that while much of the documentation includes sections of material labeled \"V4.1+\", this doesn't mean the V4.0 material is \"non-functional\" in an upgraded system. It's just easier to document approaches that are \"standard\" in each version without constantly noting this. Some of the V4.1 \"tabs\" in the various topics will also contain advice or information on how to \"modernize\" a configuration to replace unnecessary XML with property definitions and eliminate additional logging.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Breaking Changes","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Deployment Descriptor Issue","type":"text"}]},{"type":"paragraph","content":[{"text":"Older installations of the IdP dating back to V3.0 or V3.1 that have customized ","type":"text"},{"text":"web.xml","type":"text","marks":[{"type":"em"}]},{"text":" (identified by the presence of ","type":"text"},{"text":"edit-webapp/WEB-INF/web.xml","type":"text","marks":[{"type":"em"}]},{"text":") may have an incompatibility that is not accounted for during the upgrade process. The issue will prevent the IdP from starting up successfully and will be logged in the Java container as an error to load the ","type":"text"},{"text":"global.xml","type":"text","marks":[{"type":"em"}]},{"text":" file. The trigger for this issue is the following outdated content in ","type":"text"},{"text":"web.xml","type":"text","marks":[{"type":"em"}]},{"text":":","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Old web.xml Content","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"contextClass\nnet.shibboleth.ext.spring.context.DeferPlaceholderFileSystemXmlWebApplicationContext","type":"text"}]},{"type":"paragraph","content":[{"text":"To correct this issue, the classname must be changed to ","type":"text"},{"text":"net.shibboleth.ext.spring.context.DelimiterAwareApplicationContext","type":"text","marks":[{"type":"code"}]},{"text":" and the warfile rebuilt to pick up the change. You may of course wish to compare your copy to the new default version (in ","type":"text"},{"text":"dist/webapp/WEB-INF/web.xml","type":"text","marks":[{"type":"em"}]},{"text":") for other useful changes, but this specific change is the only known incompatibility.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Extension Point Change","type":"text"}]},{"type":"paragraph","content":[{"text":"As part of making the system more plugin-friendly, one very infrequent extension point was broken, contrary to our usual compatibility rules for a minor release. Registration of custom PrincipalSerializer beans as part of more advanced authentication extensions will no longer be recognized and the ","type":"text"},{"text":"shibboleth.DefaultPrincipalSerializers","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"shibboleth.PrincipalSerializers","type":"text","marks":[{"type":"strong"}]},{"text":" list beans are no longer recognized as of V4.1.","type":"text"}]},{"type":"paragraph","content":[{"text":"The replacement for this mechanism is a new auto-wired service interface, ","type":"text"},{"text":"PrincipalService","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net.shibboleth.idp.authn.principal.PrincipalService"}}]},{"text":". Updated information on this mechanism can be found on the ","type":"text"},{"text":"Authentication","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631867"}}]},{"text":" development documentation page, but this is very unlikely to impact anyone. Upgraded systems should not break outright, but will fail to locate and use any custom serializers registered using the old hook.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Changes to Defaults","type":"text"}]},{"type":"paragraph","content":[{"text":"The following defaults have changed for new installs but will not change for properly upgraded systems (generally these are set through explicitly uncommented properties or beans that have to be present to enable a behavior):","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The new ","type":"text"},{"text":"idp.bindings.inMetadataOrder","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631678"}}]},{"text":" property defaults to true, but is set to false in new installs. The primary purpose and impact is discussed below under \"Restoration of Logout Behavior\".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Attribute Release","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631715"}}]},{"text":" consent flow is no longer enabled by default, due to the lack of a deployable storage option out of the box and the the ease with which it can be enabled.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Elimination of system Files","type":"text"}]},{"type":"paragraph","content":[{"text":"With this release, we have eliminated the requirement for a \"system\" directory in the installation tree in favor of embedding the resources into the system's libraries. Because of historical references to files in this directory in the deployer-editable ","type":"text"},{"text":"web.xml","type":"text","marks":[{"type":"em"}]},{"text":" file, it's not possible to remove it entirely from an upgraded system to maintain compatibility, but new installs will not include it. A future release may require modifications to ","type":"text"},{"text":"web.xml","type":"text","marks":[{"type":"em"}]},{"text":" to allow for complete elimination of the directory.","type":"text"}]},{"type":"paragraph","content":[{"text":"As part of this change, you may also wish to remove a stale, though harmless, reference to \"%{idp.home}/system/messages/messages\" from the ","type":"text"},{"text":"shibboleth.MessageSourceResources","type":"text","marks":[{"type":"strong"}]},{"text":" bean in ","type":"text"},{"text":"services.xml","type":"text","marks":[{"type":"em"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"New Property Files and Property Lookup","type":"text"}]},{"type":"paragraph","content":[{"text":"Many common settings that used to be configurable only with XML files and Spring configuration are now exposed as properties (if and only if the original beans don't exist, for compatibility). There are new property files in the various subdirectories ","type":"text"},{"text":"(","type":"text","marks":[{"type":"em"}]},{"text":"conf/authn/authn.properties","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631601"}}]},{"text":",","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"text":"conf/admin/admin.properties","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631720"}}]},{"text":", ","type":"text"},{"text":"conf/c14n/subject-c14n.properties","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631709"}}]},{"text":") that contain examples of these settings.","type":"text"}]},{"type":"paragraph","content":[{"text":"While new installs automatically take advantage of these properties, (properly) upgraded systems will not without other adjustments. The linked topics discuss how to \"enable\" their use in those cases for those that want to take advantage of them.","type":"text"}]},{"type":"paragraph","content":[{"text":"Also take note that with this release, the process of \"finding\" property files has been improved. In older versions, and when the ","type":"text"},{"text":"idp.searchForProperties","type":"text","marks":[{"type":"strong"}]},{"text":" property is false/missing, the set of property files loaded is solely controlled by the ","type":"text"},{"text":"idp.additionalProperties","type":"text","marks":[{"type":"strong"}]},{"text":" setting. New installs by default, or systems that explicitly enable the ","type":"text"},{"text":"idp.searchForProperties","type":"text","marks":[{"type":"strong"}]},{"text":" property, will locate and load all files with the \".properties\" extension in the ","type":"text"},{"text":"conf","type":"text","marks":[{"type":"strong"}]},{"text":" tree. The explicit property can still be used for directly loading files from alternate locations.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that there are no plans to actually break or remove support for the older ways of configuring many features; the property additions are purely for simplification for newer deployers or for those who wish to take advantage.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Auto-Wired Components and Logging","type":"text"}]},{"type":"paragraph","content":[{"text":"To better accommodate plugins, the system now relies on Spring to automatically locate and consume beans of certain types at runtime instead of requiring lists of beans in many places in the user-editable configuration.","type":"text"}]},{"type":"paragraph","content":[{"text":"As a result, upgraded systems will initially output a number of INFO log messages at startup such as:","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Log example","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"2021-03-11 13:51:22,113 - - INFO [net.shibboleth.ext.spring.util.IdentifiedComponentManager:89] - Replacing auto-wired component: intercept/context-check\n2021-03-11 13:51:22,113 - - INFO [net.shibboleth.ext.spring.util.IdentifiedComponentManager:89] - Replacing auto-wired component: intercept/terms-of-use\n2021-03-11 13:51:22,113 - - INFO [net.shibboleth.ext.spring.util.IdentifiedComponentManager:89] - Replacing auto-wired component: intercept/attribute-release\n2021-03-11 13:51:22,215 - - INFO [net.shibboleth.ext.spring.util.IdentifiedComponentManager:89] - Replacing auto-wired component: http://shibboleth.net/ns/profiles/status\n2021-03-11 13:51:22,215 - - INFO [net.shibboleth.ext.spring.util.IdentifiedComponentManager:89] - Replacing auto-wired component: http://shibboleth.net/ns/profiles/reload-service-configuration\n2021-03-11 13:51:22,216 - - INFO [net.shibboleth.ext.spring.util.IdentifiedComponentManager:89] - Replacing auto-wired component: http://shibboleth.net/ns/profiles/reload-metadata\n2021-03-11 13:51:22,216 - - INFO [net.shibboleth.ext.spring.util.IdentifiedComponentManager:89] - Replacing auto-wired component: http://shibboleth.net/ns/profiles/resolvertest\n2021-03-11 13:51:22,218 - - INFO [net.shibboleth.ext.spring.util.IdentifiedComponentManager:89] - Replacing auto-wired component: http://shibboleth.net/ns/profiles/metrics\n2021-03-11 13:51:22,218 - - INFO [net.shibboleth.ext.spring.util.IdentifiedComponentManager:89] - Replacing auto-wired component: http://shibboleth.net/ns/profiles/storage","type":"text"}]},{"type":"paragraph","content":[{"text":"Similar messages will appear for the authentication flow IDs and the authentication type comparison rules. These reflect the fact that your existing configuration explicitly contains definitions for the various \"flow descriptors\" and other beans present in various files that are now either optional or reduced in size.","type":"text"}]},{"type":"paragraph","content":[{"text":"These definitions can be removed if desired, eliminating the messages, but you should refer to the \"Upgrading from V4.0 and Earlier\" section under the new V4.1+ tabs on various pages (","type":"text"},{"text":"AuthenticationConfiguration","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631601"}}]},{"text":", ","type":"text"},{"text":"ProfileInterceptConfiguration","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631714"}}]},{"text":", ","type":"text"},{"text":"AdministrativeConfiguration","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631720"}}]},{"text":") for help with that to make sure you don't lose any customizations you might have made. It's entirely non-essential and the log messages are there simply to provide accurate information about whether the internal versions of these beans are used or not.","type":"text"}]},{"type":"paragraph","content":[{"text":"Later on, if you need to explicitly override one of the beans that is auto-wired, the message will simply act as a verification that this is happening (i.e., if you don't see it, you know you didn't manage to successfully override the system's version).","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Restoration of Logout Behavior","type":"text"}]},{"type":"paragraph","content":[{"text":"Adding SOAP Logout support had an unintentional side effect of causing the SOAP binding to be selected at times instead of the more advisable approach, required by the standard, of favoring front-channel bindings. This problem of binding selection dates back to V2 and was caused by the IdP choosing endpoints in metadata order. This has been addressed with a new property, ","type":"text"},{"text":"idp.bindings.inMetadataOrder","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631678"}}]},{"text":",","type":"text","marks":[{"type":"strong"}]},{"text":" that can be set to false to produce a more desirable binding selection order that favors Redirect and POST when supported. It defaults to true for compatibility, but is set to false for new installs.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"IPv6 Client Address Sanitization","type":"text"}]},{"type":"paragraph","content":[{"text":"After waiting for a fix upstream in Jetty that got reversed in a patch, we have applied a global fix to our code to ensure that IPv6 client addresses are consistently exposed without the use of brackets around the address (brackets should be confined to \"address-as-host\" scenarios, not bare addresses). This corrects a number of problems, but may result in changes to log files and could impact scripts that were not coded defensively to handle either format.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Removed Objects and Files","type":"text"}]},{"type":"paragraph","content":[{"text":"Some of the changes in this release have resulted in the elimination of certain beans and even whole files in many cases.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"conf/session-manager.xml","type":"text","marks":[{"type":"em"}]},{"text":" file is no longer created on new installs and in the vast majority of cases can be removed outright. If you adjusted the list of client storage service beans in that file (e.g., if you're not using client storage), you could just move that overridden list to ","type":"text"},{"text":"global.xml","type":"text","marks":[{"type":"em"}]},{"text":" and then remove the file. The other beans that were in the file are now superfluous.","type":"text"}]},{"type":"paragraph","content":[{"text":"Several other XML files are no longer created on new installs but are more likely to contain customizations and require more deliberate work to remove, which is discussed above and in various places in the documentation.","type":"text"}]},{"type":"paragraph","content":[{"text":"In addition, there are many \"optional\" files that are no longer installed by default, including some XML files and views, because they are part of ","type":"text"},{"text":"Modules","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1294073981"}}]},{"text":" that enable optional features. Turning on some features in the configuration will require enabling the corresponding module, or things will not function correctly in ways that will vary from failure to start the IdP, to exceptions at runtime, to log messages about missing files.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"New Flows","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Hello World","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1289683553"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Warning Interceptor","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1289683459"}}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"New Objects","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.BiConditions.AND","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631700"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.BiConditions.OR","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631700"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.BiConditions.NOT","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631700"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.BiConditions.Scripted","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631700"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.BiConditions.Expression","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631700"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.BiFunctions.Constant","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631700"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.BiFunctions.Compose","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631700"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.BiFunctions.Scripted","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631700"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.BiFunctions.Expression","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631700"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.Consumers.Scripted","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631700"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.Consumers.Expression","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631700"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.BiConsumers.Scripted","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631700"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.BiConsumers.Expression","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631700"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.BasicKeyInfoGeneratorFactory","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631697"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.X509KeyInfoGeneratorFactory","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631697"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.metrics.ExposedProperties","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631722"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.ExtensionSchemas","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631653"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.DefaultExtensionSchemas","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631653"}}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Renamed Objects","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.IncludedSignatureAlgorithms","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631697"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.ExcludedSignatureAlgorithms","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631697"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.IncludedEncryptionAlgorithms","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631697"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.ExcludedEncryptionAlgorithms","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631697"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.authn.RemoteUser.allowedUsernames","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631619"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.authn.RemoteUser.deniedUsernames","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631619"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.consent.attribute-release.PromptedAttributeIDs","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631715"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.consent.attribute-release.IgnoredAttributeIDs","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631715"}}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"New Properties","type":"text"}]},{"type":"paragraph","content":[{"text":"There are a lot of new properties because of the aforementioned changes, but a few miscellaneous settings are mentioned here:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.bindings.inMetadataOrder","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631678"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.schemaValidation.strict","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631653"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.logout.preserveQuery","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631719"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.security.basicKeyInfoFactory","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631697"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.security.x509KeyInfoFactory","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631697"}}]}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.0.1.2 (February 2, 2021)","type":"text"}]},{"type":"paragraph","content":[{"text":"This is a service release of the Windows installation package which deals with a compatibility issue with the container packages (Jetty and Procrun) when upgrading from 3.4.8. It is unneeded by anyone maintaining their own Java container, which continues to be strongly recommended.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.0.1.1 (July 22, 2020)","type":"text"}]},{"type":"paragraph","content":[{"text":"This is a service release of the Windows installation package in order to address a ","type":"text"},{"text":"security issue","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.eclipse.org/lists/jetty-announce/msg00144.html"}}]},{"text":" in Jetty, which has been updated to version 9.4.30. It is unneeded by anyone maintaining their own Java container, which continues to be strongly recommended.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.0.1 (June 3, 2020)","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"jira","parameters":{"macroParams":{"server":{"value":"System JIRA"},"jqlQuery":{"value":"filter=10031 "},"count":{"value":"true"},"serverId":{"value":"f52c7d31-6eab-3f0e-93c3-231b5754d506"}},"macroMetadata":{"macroId":{"value":"b516b707-520e-4484-aa83-db28d0970eb9"},"schemaVersion":{"value":"1"},"title":"Jira Legacy"}},"localId":"b7edc8c4-be38-479a-a329-4859cffdd848"}}]},{"type":"paragraph","content":[{"text":"This is a patch release to address bugs identified and to shore up some missing LDAP features that arose due to the loss of JNDI support, such as SASL authentication and referral handling. The LDAP features are an exception to our usual policy on new features in a patch release and configuration options are denoted with the ","type":"text"},{"text":"4.0.1","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]},{"text":" designation where applicable.","type":"text"}]},{"type":"paragraph","content":[{"text":"A bug was corrected that was causing metadata resolver crashes on invalid metadata containing empty elements. Previous releases inadvertently accepted and ignored these elements. The patch adds warnings about the invalid content but corrects the crashing bug.","type":"text"}]},{"type":"paragraph","content":[{"text":"Jetty has been updated for the Windows installer to version 9.4.28 and an issue corrected with the use of wildcard certificates. The full fix for this in the case of back-channel deployment involves an update to the plugin we supply for certificate validation bypass, and this plugin has been renamed to reflect that it is designed solely for use with Jetty 9.4. The ","type":"text"},{"text":"Jetty94","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1274544254"}}]},{"text":" page has been updated to reflect this. The older plugin and back-channel XML configuration remains compatible for now, but will fail in the unlikely even a wildcard or multi-SAN certificate were used.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Changes to Defaults","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The transcoding rule shipped with 4.0.0 for the \"telephoneNumber\" attribute had the SAML 1 and SAML 2 names swapped, so upgraded systems will carry this mistake until corrected by hand.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Known Issues","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A bug was introduced into the default web.xml file in the interminable attempts to fix warnings around the default method constraints. The element ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" should have been ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":". This may cause warnings or result in the rule being ignored.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In both 4.0.1 and 4.0.0, an inadvertent change has caused the attribute filtering engine to alter the order of attribute values produced by the resolver. The order in fact varies by server and over time. While this is not a bug per se because attribute values are unordered by that point, it does cause unpredictable hashing values when comparing values for attribute release consent, which causes re-prompting. This will be fixed in V4.1.","type":"text"}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":3},"content":[{"text":"4.0.0 (March 11, 2020)","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"jira","parameters":{"macroParams":{"server":{"value":"System JIRA"},"jqlQuery":{"value":"filter=10030 "},"count":{"value":"true"},"serverId":{"value":"f52c7d31-6eab-3f0e-93c3-231b5754d506"}},"macroMetadata":{"macroId":{"value":"a8eb2e80-6a00-4033-b6d0-40caed7766ff"},"schemaVersion":{"value":"1"},"title":"Jira Legacy"}},"localId":"99484c42-d6b2-4969-b48f-a5b67bfac3bb"}}]},{"type":"paragraph","content":[{"text":"This is the first release of the fourth-generation Identity Provider software. The key documentation links are located on the IDP4 space ","type":"text"},{"text":"Home","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4"}}]},{"text":" page, such as ","type":"text"},{"text":"SystemRequirements","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631833"}}]},{"text":", ","type":"text"},{"text":"Installation","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631502"}}]},{"text":", and ","type":"text"},{"text":"Upgrading","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631513"}}]},{"text":" material. Note the new ","type":"text"},{"text":"SystemRequirements","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631833"}}]},{"text":" as they have substantially changed with regard to Java and container versions.","type":"text"}]},{"type":"paragraph","content":[{"text":"This release should interoperate with all previous releases of Shibboleth and other software that supports the same ","type":"text"},{"text":"standards","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/DEV/pages/1118699530"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"As a major upgrade, the list of issues fixed and features added is numerous. Many significant changes are highlighted below, with particularly noteworthy issues highlighted in note or warning boxes.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"There are API additions, changes, and removals, and any third-party extensions will need to be checked for code compatibility and recompiled for use with this version, and any custom scripts created by deployers should be carefully tested and reviewed.","type":"text"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Changes to Defaults","type":"text"}]},{"type":"paragraph","content":[{"text":"The following defaults have changed for both new installs and upgrades and should be reviewed for possible incompatibilities:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The idp.cookie.secure property now defaults to true if not set by the deployer. In the unlikely event that HTTP compatibility is a requirement, the property would need to be adjusted. (Note that the container's session cookies are controlled by policy in web.xml and while we have also changed that default, only upgraders without their own web.xml customizations would be exposed to that change.)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The default LDAP provider is now UnboundID. See the LDAP section below for more information.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Some legacy code that was used to maintain the V2-style formatting of the %T audit field (the timestamp of the record) was removed and the log now outputs all date/time fields using the supplied formatter or a default. The format of the %T field may therefore change for some deployers.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Related, the ","type":"text"},{"text":"shibboleth.AuditDateTimeFormat","type":"text","marks":[{"type":"strong"}]},{"text":" bean is interpreted as a pattern by the Java ","type":"text"},{"text":"DateTimeFormatter","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-jdk.cgi/java.time.format.DateTimeFormatter?module=java.base"}}]},{"text":" class, rather than the deprecated joda-time version, and there are some differences in those classes that may result in changes to your logs. If you require identical output, review is warranted.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A side effect of the attribute-related changes noted below is that SAML 2.0 ","type":"text"},{"text":"AttributeEncoders","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631590"}}]},{"text":" with no ","type":"text"},{"text":"friendlyName","type":"text","marks":[{"type":"code"}]},{"text":" attribute default to populating FriendlyName with the attribute's ID. At present there is no way to restore the original behavior other than to convert to use of the ","type":"text"},{"text":"AttributeRegistryConfiguration","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1272054306"}}]},{"text":" to express the rule.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The following defaults have changed for new installs but will not change for properly upgraded systems (generally these are set through explicitly uncommented properties or beans that have to be present to enable a behavior):","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The default XML Encryption algorithm is now AES128-GCM rather than AES128-CBC. See ","type":"text"},{"text":"GCMEncryption","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1285914730"}}]},{"text":" for much more on this, and do note that newly installed systems will fail to interoperate with a large number of SAML SPs without modern algorithm support.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"HTML Local Storage is now enabled by default when the client-side session storage feature is used (which has been and remains the default option as well).","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In addition the logout-enabling ","type":"text"},{"text":"idp.session.trackSPSessions","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"idp.session.secondaryServiceIndex","type":"text","marks":[{"type":"strong"}]},{"text":" properties are also enabled by default. They can be disabled by deployers that do not wish to try and support logout propagation.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The set of profiles enabled by default no longer includes any SAML 1.1 support, or SAML 2.0 Attribute Query.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The default trust engines used at runtime now omit PKIX support. Support for only the ","type":"text"},{"text":"Metadata Interoperability Profile","type":"text","marks":[{"type":"link","attrs":{"href":"https://wiki.oasis-open.org/security/SAML2MetadataIOP"}}]},{"text":" is now the default behavior with no attempt at a fallback.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A few ","type":"text"},{"text":"ReloadableServices","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631674"}}]},{"text":" that were configured by default to fail-fast have changed to non-fail-fast behavior.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Audit output has been changed to include a much more useful default format and various improvements to how specific fields are logged to shrink repetitive and unnecessary constant values.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Removal of Deprecated Features","type":"text"}]},{"type":"paragraph","content":[{"text":"A number of previously deprecated features, settings, APIs, etc. have been removed. The use of these deprecated bits should have produced a standard warning either at startup or during use in the most recent releases of the software, and most of them are now non-functional. Eliminating warnings before upgrading is strongly advised.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Date/Time APIs","type":"text"}]},{"type":"paragraph","content":[{"text":"The entire code base has been converted from the joda-time Date/Time API to the new Date/Time API introduced in Java 8. This change is widespread in the code, with most uses of long/Long types to represent timestamps and durations converted into ","type":"text"},{"text":"Instant","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-jdk.cgi/java.time.Instant?module=java.sql"}}]},{"text":" and ","type":"text"},{"text":"Duration","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-jdk.cgi/java.time.Duration?module=java.sql"}}]},{"text":" classes.","type":"text"}]},{"type":"paragraph","content":[{"text":"The change is mostly invisible to deployers because of the widespread support for ISO Duration notation in the configuration. There are a couple of areas of direct impact that are now deprecated and will be removed from a future version:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Passing back a login timestamp as a joda-time object in the ","type":"text"},{"text":"External","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631607"}}]},{"text":" login flow.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use of a joda-time DateTimeFormatter object, primarily (but not required) for ","type":"text"},{"text":"ExpiringPasswordInterceptConfiguration","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631717"}}]},{"text":".","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"It was also observed that V3 may have been improperly interpreting timestamps without the trailing 'Z' indicator as compliant UTC values, which was not a correct assumption. Using such values is a violation of the SAML specification in any event, and V4 does not handle such values and will reject them in most cases as expired or in the future depending on the default time zone of the system relative to UTC.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Predicate/Function APIs","type":"text"}]},{"type":"paragraph","content":[{"text":"The entire code base has been converted from the Guava Predicate/Function API to the new functional API interfaces introduced in Java 8. This change is widespread in the code, but we have supplied migration aids via our numerous ","type":"text"},{"text":"utility/parent","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631700"}}]},{"text":" beans and a support class that converts between the legacy Guava Predicate.apply() signature and the new standard Predicate.test() signature.","type":"text"}]},{"type":"paragraph","content":[{"text":"We expect most custom code and scripts based on Guava Predicates will work unmodified, but may produce warnings when the apply() method is called to allow code cleanup and prevent future problems.","type":"text"}]},{"type":"paragraph","content":[{"text":"One place we missed is near the bottom of the ","type":"text"},{"text":"views/login.vm","type":"text","marks":[{"type":"em"}]},{"text":" file. If you happen to be using the \"not-quite-deprecated\" Extended Flows feature, there's a call to \"apply\" in the template that needs to be manually changed to \"test\". This also applies to new installs prior to V4.1.0 which will contain the fixed template.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"heading","attrs":{"level":5},"content":[{"text":"Beware of Guava's \"compose\" method","type":"text"}]},{"type":"paragraph","content":[{"text":"Legacy use of Guava Functions may work for the most part, but there is a known issue in Spring's wiring behavior that breaks the use of Guava's \"compose\" helper. If you have custom bean wiring anywhere that contains a reference like this, you will likely have to update it to avoid problems:","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Using that syntax will often result in the two constructor arguments to that bean getting swapped/reversed, which reverses the order of the composition, usually producing bad output at best, and a crash or even more catastrophic outcome at worst.","type":"text"}]},{"type":"paragraph","content":[{"text":"Unfortunately there's no easy fix for this because of the way Guava accommodates the conversion to Java 8's Function interface. As a result, the best thing you can do is simply scan for this and convert the above syntax to:","type":"text"}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"That is functionally equivalent and should avoid the re-ordering behavior we're seeing with Spring.","type":"text"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Profile Configuration APIs","type":"text"}]},{"type":"paragraph","content":[{"text":"A lot of cleanup was performed to eliminate inconsistent method names in the APIs used for configuring and overriding profile behavior in ","type":"text"},{"text":"relying-party.xml","type":"text","marks":[{"type":"em"}]},{"text":" using overrides. In a small number of advanced cases, people may encounter errors in their configuration due to type incompatibilities, which may require reviewing the appropriate class Javadoc. But as a rule of thumb, all the property names now follow these conventions:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"p:something takes a literal value such as a boolean, integer, long, String, Duration, etc.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"p:somethingPredicate takes a Java Predicate when the equivalent literal would be a boolean","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"p:somethingLookupStrategy takes a Java Function when the equivalent literal would be other than a boolean","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"As an example, the V3 property ","type":"text"},{"text":"signAssertions","type":"text","marks":[{"type":"code"}]},{"text":" was Predicate-valued, while the V4 version takes a literal boolean and ","type":"text"},{"text":"signAssertionsPredicate","type":"text","marks":[{"type":"code"}]},{"text":" takes a Predicate. There are a number of such cases but not many with common use.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"LDAP Changes","type":"text"}]},{"type":"paragraph","content":[{"text":"The default LDAP implementation is now the UnboundID library and JNDI is no longer officially supported. There will be no JNDI support at all in a future version and we expect to migrate to a native implementation being built within a future version of ","type":"text"},{"text":"Ldaptive","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.ldaptive.org"}}]},{"text":" at that time.","type":"text"}]},{"type":"paragraph","content":[{"text":"This release includes configuration updates to facilitate that change, particularly in the ","type":"text"},{"text":"LDAPAuthnConfiguration","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631612"}}]},{"text":" and to a lesser degree in the ","type":"text"},{"text":"LDAPConnector","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631572"}}]},{"text":". Deployers using this feature should review and update their configurations when possible to modernize them and minimize the need for future changes. In many cases, the ","type":"text"},{"text":"ldap-authn-config.xml","type":"text","marks":[{"type":"em"}]},{"text":" file can be replaced outright with no impact, along with an additional change noted in the ","type":"text"},{"text":"LDAPAuthnConfiguration","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631612"}}]},{"text":" page under \"Note Regarding Upgrades\".","type":"text"}]},{"type":"paragraph","content":[{"text":"Most previously necessary ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" elements can be replaced by various new (or recently added) settings that configure the equivalent behavior in a non-JNDI fashion. For example, specifying binary attributes in the ","type":"text"},{"text":"LDAPConnector","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631572"}}]},{"text":" is now possible directly via the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" element added in a V3.4 patch. If you encounter properties that have no obvious replacement, seek assistance.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ldaptive ","type":"text"},{"text":"JAAS","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631613"}}]},{"text":" module has an incompatible change in its handling of timeout settings. Specifying values in milliseconds will result in a DateTime parsing exception. The values must be converted to ISO syntax (e.g., 2000 → PT2S).","type":"text"}]},{"type":"paragraph","content":[{"text":"In addition, various LDAP pooling properties prefixed by \"idp.pool.LDAP.\" (such as ","type":"text"},{"text":"idp.pool.LDAP.validatePeriod)","type":"text","marks":[{"type":"strong"}]},{"text":" previously defaulted to numeric values expressed in seconds (e.g. 300 == 5 minutes). These are now being interpreted as milliseconds, which causes overly frequent pool validation if the defaults are used with an unmodified V3 ","type":"text"},{"text":"ldap-authn-config.xml","type":"text","marks":[{"type":"em"}]},{"text":" file. This is discussed further on the ","type":"text"},{"text":"LDAPAuthnConfiguration","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631612"}}]},{"text":" page.","type":"text"}]},{"type":"paragraph","content":[{"text":"Finally, the ","type":"text"},{"text":"LDAPConnector","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631572"}}]},{"text":"'s ","type":"text"},{"text":"maxResultSize","type":"text","marks":[{"type":"code"}]},{"text":" option's behavior is different from V3 in that the connector will raise an error if the size is exceeded rather than ignoring this condition.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Password Flow Extension","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Password","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631611"}}]},{"text":" login flow has undergone significant internal reimplementation to support a much higher degree of flexibility. The redesign has resulted in the elimination of one existing extension mechanism that we don't believe was heavily used, described in the V3 documentation under the heading ","type":"text"},{"text":"Custom Back-Ends","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP30/pages/2494726322"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"A simpler extension point is now provided for implementation of such custom validators, and converting is not a complex task.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Attribute-Related Changes","type":"text"}]},{"type":"paragraph","content":[{"text":"A major new addition to V4 is the ","type":"text"},{"text":"AttributeRegistry","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1272054306"}}]},{"text":" service that replaces, or at least supplements, the ","type":"text"},{"text":"AttributeEncoder","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631590"}}]},{"text":" mechanism for translating attributes. While upgraded systems should operate unchanged, deployers are advised to review this new feature and may achieve substantial simplification of their configuration by taking advantage of it. Many existing encoders may be removable.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Note that installing from scratch and ","type":"text"},{"text":"then","type":"text","marks":[{"type":"strong"}]},{"text":" applying a legacy configuration will in most cases result in ","type":"text"},{"text":"duplicate Attributes appearing in SAML message","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"b92923cf-89f3-48d7-b73a-03ca0339b3e7"}}]},{"text":"s due to the overlap between the existing encoders and the new rules. The upgrade process is designed to prevent that by excluding the new rules from the default configuration. Of course, the inverse is also true: if you want the new default rules to apply, you must make that transition after upgrading.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"A consequence of this new service is that adjusting ","type":"text"},{"text":"AttributeEncoders","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631590"}}]},{"text":" requires reloading \"shibboleth.AttributeRegistryService\" and not the “shibboleth.AttributeResolverService” service as in previous releases.","type":"text"}]},{"type":"paragraph","content":[{"text":"In the unlikely event that you have any attribute display name or description metadata present for an attribute definition but do ","type":"text"},{"text":"not","type":"text","marks":[{"type":"strong"}]},{"text":" have an encoder, the compatibility support is ","type":"text"},{"text":"not","type":"text","marks":[{"type":"strong"}]},{"text":" going to attach that display metadata to the resulting attribute. This does not seem like a likely scenario, but it's a change.","type":"text"}]},{"type":"paragraph","content":[{"text":"The rules for attribute IDs are tightened in this release to preclude whitespace and single quotes. With advance warning this set may be tightened further if warranted. We strongly advise sticking to simple ASCII characters.","type":"text"}]},{"type":"paragraph","content":[{"text":"The class hierarchy around ","type":"text"},{"text":"IdPAttributeValue","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net.shibboleth.idp.attribute.IdPAttributeValue"}}]},{"text":" has been simplified and the use of generics eliminated. Some scripts may be impacted by changes to method names. There is no longer a universal getValue method exposed, but getNativeValue generally returns the equivalent result save for scoped values, where a Pair is returned. This change prevents unintentional \"lossy\" conversions to String for non-String values.","type":"text"}]},{"type":"paragraph","content":[{"text":"The removal of the deprecated ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" element from the ","type":"text"},{"text":"TemplateAttributeDefinition","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631563"}}]},{"text":" syntax creates a rare scenario that can break existing behavior in a small set of cases if an ","type":"text"},{"text":"InputDataConnector","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631554"}}]},{"text":" is supplied with the ","type":"text"},{"text":"allAttributes","type":"text","marks":[{"type":"code"}]},{"text":" option set. Using this syntax requires that all inputs either have the same number of values (or no values). Instead of using the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" element in conjunction with ","type":"text"},{"text":"allAttributes","type":"text","marks":[{"type":"code"}]},{"text":", simply enumerate the attributes to be sourced from the connector.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Metadata Changes","type":"text"}]},{"type":"paragraph","content":[{"text":"Due to additional \"up front\" processing of some SAML metadata content, certain invalid SAML constructs that used to be ignored are no longer being tolerated during the initial load of a ","type":"text"},{"text":"MetadataProvider","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631635"}}]},{"text":", in particular the appearance of empty XML elements such as ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":", and all the child elements within the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" element.","type":"text"}]},{"type":"paragraph","content":[{"text":"Such elements are invalid according to the standard and the IdP's behavior is correct, but the initial release had a bug that results in a NullPointerException instead of ignoring the element. The crash was corrected in V4.0.1. Deployers should not in general rely on the IdP to be tolerant of invalid SAML constructs.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Logout Changes","type":"text"}]},{"type":"paragraph","content":[{"text":"The Single Logout feature now includes some additional control points, properties, and changes to the default views that allow more control over how logout proceeds, whether users are able to cancel/abort them, and other requested \"flow of control\" enhancements. These are discussed in the ","type":"text"},{"text":"LogoutConfiguration","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631719"}}]},{"text":" topic.","type":"text"}]},{"type":"paragraph","content":[{"text":"In addition, SOAP logout for SAML has been implemented for the first time, and unfortunately this change can cause some impact to existing deployments because of a bug related to how bindings are chosen, which has historically been in metadata order. This can cause SOAP to be selected in preference to front-channel bindings, which is an error. Control over this has been added for a future release. This section will be updated with more information as various aspects of controlling the SOAP logout behavior are investigated.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"New Deprecations","type":"text"}]},{"type":"paragraph","content":[{"text":"Due to a Spring bug that causes problems with configuration reloading, we have deprecated the original set of HttpClient parent beans and any inheritance from those beans in custom HttpClient configurations. We have introduced new parent beans without predefined settings that were causing the problems, and adjusted the ","type":"text"},{"text":"HttpClientConfiguration","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631724"}}]},{"text":" documentation in various ways to refer to them.","type":"text"}]},{"type":"paragraph","content":[{"text":"Internal components that rely on a default HttpClient configuration now rely on a system bean definition intended only for internal use, configured as before via the ","type":"text"},{"text":"services.properties","type":"text","marks":[{"type":"em"}]},{"text":" file.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you have beans that are inheriting from the deprecated versions, a warning will be issued. They will be removed from V5. This extends to several properties that were used to configure the caching versions of the clients, which will be removed.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"CSRF Prevention","type":"text"}]},{"type":"paragraph","content":[{"text":"The IdP includes a new ","type":"text"},{"text":"Cross-Site Request Forgery (CSRF) Protection","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1280180737"}}]},{"text":" feature that is enabled by default for new installs. The ","type":"text"},{"text":"idp.csrf.enabled","type":"text","marks":[{"type":"strong"}]},{"text":" property is a general on/off switch if problems are encountered or upgraders wish to enable it. The feature can also be easily incorporated in custom webflow views with minimal effort.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Extensible Installer","type":"text"}]},{"type":"paragraph","content":[{"text":"Mostly of interest to packagers, the installer is now built with Java and has explicit extension points. See ","type":"text"},{"text":"Programming the V4 Installer","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1279033402"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Noteworthy New Features","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The aforementioned new ","type":"text"},{"text":"AttributeRegistryConfiguration","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1272054306"}}]},{"text":" and ","type":"text"},{"text":"Cross-Site Request Forgery (CSRF) Protection","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1280180737"}}]},{"text":" features","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Producing encodeable attributes directly from ","type":"text"},{"text":"DataConnectors","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631564"}}]},{"text":" with the ","type":"text"},{"text":"exportAttributes","type":"text","marks":[{"type":"code"}]},{"text":" setting","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"More flexible ","type":"text"},{"text":"PasswordAuthnConfiguration","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631611"}}]},{"text":" allowing back-ends to be combined JAAS-style","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SAML proxy login flow (","type":"text"},{"text":"SAMLAuthnConfiguration","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1282539600"}}]},{"text":") and various related features","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"New Objects","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.SameSiteCookieMap","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631697"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.authn.LDAP.authenticator","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631612"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.LDAPAuthenticationFactory","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631612"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.authn.discoveryURL","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631601"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.authn.discoveryURLStrategy","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631601"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.authn.SAML.*","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1282539600"}}]},{"text":" objects","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"c14n/SAML2ProxyTransform c14n flow","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1280180722"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.ProxyNameTransformPredicate","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1280180722"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.ProxyNameTransformFormats","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1280180722"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.PrincipalProxyRequestMappings","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631601"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.PrincipalProxyResponseMappings","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631601"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.authn.Password.Validators","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631611"}}]},{"text":" list and related validators","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Many objects connected to ","type":"text"},{"text":"AttributeRegistryConfiguration","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1272054306"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.SubjectLocalityAddressStrategy","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.DefaultVelocityEngineProperties","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.VelocityEngineProperties","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.ExceptionResolverViewExtenderFunction","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631634"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.HttpClientFactory","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631724"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.FileCachingHttpClientFactory","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631724"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.MemoryCachingHttpClientFactory","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631724"}}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"New Properties","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.cookie.sameSite","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631697"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.cookie.sameSiteCondition","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631697"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.csrf.enabled","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1280180737"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.csrf.token.parameter","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1280180737"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.sealer.keyStrategy","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631697"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.service.metadata.enableByReferenceFilters","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631674"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.service.attribute.registry.*","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631674"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.service.attribute.resolver.stripNulls","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631549"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.service.managedBean.*","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631674"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.logout.promptUser","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631719"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.cas.relyingPartyIdFromMetadata","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631632"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.saml.honorWantAssertionsSigned","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631694"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idp.saml.honorWantAuthnRequestsSigned","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1265631694"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"i","type":"text"},{"text":"dp.velocity.space.gobbling","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/2891251713"}}]}]}]}]},{"type":"paragraph"}],"version":1}

Browser not supported