upgrade-070-080.xml 2.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041
  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <document><properties><title>Acegi Security - Upgrading from version 0.7.0 to 0.8.0</title></properties><body><section name="Upgrading from 0.7.0 to 0.8.0"><p>
  3. The following should help most casual users of the project update their
  4. applications:
  5. <ul>
  6. <li>HttpSessionIntegrationFilter has been removed. Use net.sf.acegisecurity.context.HttpSessionContextIntegrationFilter instead.
  7. Note you will need to set the mandatory "context" property to something like "net.sf.acegisecurity.context.security.SecureContextImpl".
  8. It's not the default because we want no dependencies between the context package and the rest of Acegi Security.<br></br><br></br></li>
  9. <li>Filter ordering has changed. See the reference guide for confirmation of the correct ordering. Basically you should have
  10. HttpSessionContextIntegrationFilter appear before any of your authentication mechanisms.<br></br><br></br></li>
  11. <li>IoC container hosted filter chains can now be used instead of lengthy web.xml declarations. See the reference guide or the
  12. Contacts Sample for further information.<br></br><br></br></li>
  13. <li>Certain classes have been moved to new packages: ContextHolderAwareRequestWrapper (and its filter),
  14. AuthenticationSimpleHttpInvokerRequestExecutor, ContextPropagatingRemoteInvocation,
  15. SecureContext (and its implementation). These classes were moved as part of refactorings aimed at
  16. improving the simplicity of the project's design.<br></br><br></br></li>
  17. <li>If you wish to use the new ConcurrentSessionController you must declare the HttpSessionEventPublisher context listener in your
  18. web.xml<br></br><br></br></li>
  19. <li>The JaasAuthenticationCallbackHandler interface has had it's setAuthentication method removed.
  20. The handle method now takes both the Callback and Authentication objects as arguments.<br></br><br></br></li>
  21. <li>Added AuthenticationException to the AutenticationEntryPoint.commence method signature.<br></br><br></br></li>
  22. <li>Added AccessDeniedException to the SecurityEncorcementFilter.sendAccessDeniedError method signature.<br></br><br></br></li>
  23. <li>The Authentication.getDetails() no longer returns simply the IP address used for authentication.
  24. It now returns a WebAuthenticationDetails instance, which contains the IP address, session information,
  25. and can be extended to store further details.<br></br><br></br></li>
  26. </ul>
  27. </p></section></body></document>