Fork me on GitHub

Simple. Java. Security.

Apache Shiro News

Stay up to date with the latest news on the Apache Shiro Security Framework

Release binaries (.jars) are also available through Maven Central and source bundles through Apache distribution mirrors. For more information on Shiro, please read the documentation.

Enjoy!

The Apache Shiro Team

The Shiro team is pleased to announce the release of Apache Shiro version 1.7.0. This is a feature release for 1.x.

This release includes 7 issues resolved since the 1.6.0 release and is available for Download now.

Of Note:

  • Disable session path rewriting by default.
  • Add system property to enable backslash path normalization.
  • DeleteMe cookie should use the defined "sameSite".
  • Also add cookie SameSite option to Spring.
  • SslFilter with HTTP Strict Transport Security (HSTS).
You can learn more on Jira

Release binaries (.jars) are also available through Maven Central and source bundles through Apache distribution mirrors.

For more information on Shiro, please read the documentation.

Enjoy!

The Apache Shiro Team

The Shiro team is pleased to announce the release of Apache Shiro version 1.6.0. This is a feature release for 1.x.

This release includes 3 issues resolved since the 1.5.3 release and is available for Download now.

Of Note:

  • Incorrect filterchainResolver.
  • SecurityUtils.securityManager should be volatile.
  • ArrayIndexOutOfBoundsException in Base64#decode.
  • Add support for Global Filters.
  • Dependency upgrade.
You can learn more on Jira

Release binaries (.jars) are also available through Maven Central and source bundles through Apache distribution mirrors.

For more information on Shiro, please read the documentation.

Enjoy!

The Apache Shiro Team

The Shiro team is pleased to announce the release of Apache Shiro version 1.5.3. This is a feature release for 1.x.

This release includes 3 issues resolved since the 1.5.2 release and is available for Download now.

Of Note:

  • INI parser does not properly handled backslashes at end of values.
  • Regression in URI parsing in Shiro 1.5.2.
  • SimplePrincipalMap and SimplePrincipalCollection throw different exceptions for the same problem.
  • Dependency upgrade.
You can learn more on Jira

Release binaries (.jars) are also available through Maven Central and source bundles through Apache distribution mirrors.

For more information on Shiro, please read the documentation.

Enjoy!

The Apache Shiro Team

The Shiro team is pleased to announce the release of Apache Shiro version 1.5.2. This is a feature release for 1.x.

This release includes 3 issues resolved since the 1.5.1 release and is available for Download now.

Of Note:

  • Fixes authentication bypass issue: CVE-2020-1957
  • FirstSuccessfulStrategy will short circuit correctly now.
You can learn more on Jira

Release binaries (.jars) are also available through Maven Central and source bundles through Apache distribution mirrors.

For more information on Shiro, please read the documentation.

Enjoy!

The Apache Shiro Team

The Shiro team is pleased to announce the release of Apache Shiro version 1.5.1. This is a feature release for 1.x.

This release includes 5 issues resolved since the 1.5.0 release and is available for Download now.

Of Note:

  • DefaultCipherInstance is an alias which is not available in every JVM or JCA Provider.
  • Bean reflection property failed with Enum values.
  • Matching of / (root) is broken.
You can learn more on Jira

Release binaries (.jars) are also available through Maven Central and source bundles through Apache distribution mirrors.

For more information on Shiro, please read the documentation.

Enjoy!

The Apache Shiro Team

The Shiro team is pleased to announce the release of Apache Shiro version 1.5.0. This is a feature release for 1.x.

This release includes 52 issues resolved since the 1.4.2 release and is available for Download now.

Of Note:

  • Update to compiler Java 8 min.
  • Validate Java 11 build.
  • Dependency upgrade.
You can learn more on Jira

Release binaries (.jars) are also available through Maven Central and source bundles through Apache distribution mirrors.

For more information on Shiro, please read the documentation.

Enjoy!

The Apache Shiro Team

The Shiro team is pleased to announce the release of Apache Shiro version 1.4.2. This is a feature release for 1.x.

This release includes 1 issue resolved since the 1.4.1 release and is available for Download now.

Of Note:

  • Updates the default Cipher mode to GCM in AesCipherService (CVE-2019-12422)
You can learn more on Jira

Release binaries (.jars) are also available through Maven Central and source bundles through Apache distribution mirrors.

For more information on Shiro, please read the documentation.

Enjoy!

The Apache Shiro Team

The Shiro team is pleased to announce the release of Apache Shiro version 1.4.1. This is a feature release for 1.x.

This release includes 27 issues resolved since the 1.4.0 release and is available for Download now.

Of Note:

  • Fix some OGSi and Apache Karaf feature issues.
  • Refresh cached session in HTTP request after user logs out
  • Upgrade to Spring 4.3.22.RELEASE
  • Upgrade to Springboot 1.5.19.RELEASE
  • Maven plugins upgrade
You can learn more on Jira

Release binaries (.jars) are also available through Maven Central and source bundles through Apache distribution mirrors.

For more information on Shiro, please read the documentation.

Enjoy!

The Apache Shiro Team

The Shiro team is pleased to announce the release of Apache Shiro version 1.4.0-RC2. This is a feature release for 1.x.

This release includes 15 issues resolved since the 1.3.2 release and is available for Download now.

Of Note:

  • The core has been broken up into a fewer smaller modules (lang, crypto, config), but package names remain the same. Maven, Gradle, and Ivy users will NOT be effected.
  • New modules for Spring Boot
  • New servlet fragment module
  • New module for JAX-RS (based off https://github.com/silb/shiro-jersey)
  • Guice 4 support
  • Shiro.ini string interpolation

This release is an release candidate, so we encourage feedback on the new modules above.

Release binaries (.jars) are also available through Maven Central and source bundles through Apache distribution mirrors.

For more information on Shiro, please read the documentation.

Enjoy!

The Apache Shiro Team

The Shiro team is pleased to announce the release of Apache Shiro version 1.3.2.

This security release contains 1 fix since the 1.3.1 release.

CVE-2016-6802:

Apache Shiro before 1.3.2, when using a non-root servlet context path, specifically crafted requests can be used to by pass some security servlet filters, resulting in unauthorized access.

Release binaries (.jars) are also available through Maven Central and source bundles through Apache distribution mirrors.

For more information on Shiro, please read the documentation.

The Apache Shiro Team

The Shiro team is pleased to announce the release of Apache Shiro version 1.3.1. This is a bug fix release for 1.3.x.

This release includes 2 issues resolved since the 1.3.0 release and is available for Download now.

Release binaries (.jars) are also available through Maven Central and source bundles through Apache distribution mirrors.

For more information on Shiro, please read the documentation.

Enjoy!

The Apache Shiro Team

The Shiro team is pleased to announce the release of Apache Shiro version 1.3.0. This is a feature release for 1.3.x.

This release includes 26 issues resolved since the 1.2.6 release and is available for Download now.

Release binaries (.jars) are also available through Maven Central and source bundles through Apache distribution mirrors.

For more information on Shiro, please read the documentation.

Enjoy!

The Apache Shiro Team

The Shiro team is pleased to announce the release of Apache Shiro version 1.2.6. This is a bug fix release for 1.2.x.

This release includes 2 bug fixes since the 1.2.5 release and is available for Download now.

Release binaries (.jars) are also available through Maven Central and source bundles through Apache distribution mirrors.

For more information on Shiro, please read the documentation.

Enjoy!

The Apache Shiro Team

The Shiro team is pleased to announce the release of Apache Shiro version 1.2.5. This is a bug fix release for 1.2.x.

This release includes 7 bug fixes since the 1.2.4 release and is available for Download now.

Release binaries (.jars) are also available through Maven Central and source bundles through Apache distribution mirrors.

For more information on Shiro, please read the documentation.

Enjoy!

The Apache Shiro Team

The Shiro team is pleased to announce the release of Apache Shiro version 1.2.4. This is a bug fix release for 1.2.x.

This release includes 5 bug fixes since the 1.2.3 release and is available for Download now.

Release binaries (.jars) are also available through Maven Central and source bundles through Apache distribution mirrors.

For more information on Shiro, please read the documentation.

Enjoy!

The Apache Shiro Team

Dear Apache Shiro Community,

The Shiro team is pleased to announce the release of Apache Shiro version 1.2.2. This is the second bug fix point release after 1.2.0.

This release includes 18 bug fixes since the 1.2.1 release and is available for Download now.

All binaries (.jars) are available in Maven Central already. Please note that the Apache mirrors are still updating to reflect the source distribution, but some mirrors may not be updated yet. If a mirror download link does not work, please try another or wait another 12 to 24 hours.

For more information on Shiro 1.2, please read the "What's new in Apache Shiro 1.2?" article or the previous 1.2 release announcement.

Enjoy!

The Apache Shiro Team

Dear Apache Shiro Community,

The Shiro team is pleased to announce the release of Apache Shiro version 1.2.1. This is the first bug fix point release after 1.2.0.

This release includes 11 bug fixes since the 1.2.0 release and is available for Download now.

All binaries (.jars) are available in Maven Central already. Please note that the Apache mirrors are still updating to reflect the source distribution, but some mirrors may not be updated yet. If a mirror download link does not work, please try another or wait another 12 to 24 hours.

For more information on Shiro 1.2, please read the "What's new in Apache Shiro 1.2?" article or the previous 1.2 release announcement.

Enjoy!

The Apache Shiro Team

Here's an article covering some of the main features and enhancements in Apache Shiro 1.2:

https://stormpath.com/blog/whats-new-apache-shiro-12

Apache Shiro 1.2.0 Released!

Dear Apache Shiro Community,

The Shiro team is pleased to announce the release of Apache Shiro version 1.2.0!

This release includes a number of bug fixes and new features since the 1.1.0 release.  The 1.2.0 release is available from the Download page.

All binaries (.jars) are available in Maven Central already.  Please note that the Apache mirrors are still updating to reflect the source distribution, but some mirrors may not be updated yet.  If a mirror download link does not work, please try another or wait another 12 to 24 hours.

New Features

  • The ability to disable sessions per filter chain or entirely for an application.
  • Servlet Context Listener initialization in web apps (to allow components to utilize Shiro before Filter initialization)
  • A command line program to securely hash passwords (or any url, file or stream input for that matter).
  • New secure password hash formats that adhere to Modular Crypt Format conventions.  These secure password hashes can be computed with the above named command line program and saved in text config (e.g. shiro.ini) directly.  Plaintext passwords should never be stored.  For those familiar with the Apache HTTPD passwd program, this achieves the same benefits.
  • A new LogoutFilter, as many apps don't need to show a view during logout (just logout and redirect to some known location).
  • Shiro filters can be enabled or disabled without removing them from the filter chain - useful in development (e.g. turn ssl requirement off in dev, but keep it on in production).
  • A lot of work has gone into making secure password hash storage and comparison a much simpler task in Shiro, focused around the new concept of a PasswordService.  You can use a PasswordService directly in your application code to hash passwords securely.  You can then configure a PasswordMatcher on your Realm(s) to use the same PasswordService for password comparisons.  See the PasswordService JavaDoc for example .ini configuration:

More complete PasswordService and related config documentation will be added to the Shiro website in the next few days - it was better to release now for the many who are waiting on the release, and follow up with this part of the documentation shortly.

  • Three new 'support' modules:
    • Apache Karaf features (shiro-features-1.2.0.jar)
    • Google Guice: guice.html
    • Jasig CAS: cas.html

And even more new features!  See the 'Resolved Issues' below for a complete list.

Backwards-incompatible or potential breaking changes

There are only a few small cases where breakage could occur - please view the release notes to ensure you mitigate any potential breaking change - particularly if you are using the SecureRandomNumberGenerator
or Shiro's Block Cipher Services (AES, Blowfish):

https://raw.githubusercontent.com/apache/shiro/shiro-root-1.2.0/RELEASE-NOTES

Resolved Issues

Jira resolved issue report:

https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310950&version=12315478

Enjoy!

The Apache Shiro Team

Apache Shiro Login Demo

Matt Raible has posted a really nice blog article and video demonstrating a login use case with Apache Shiro. Check out the Java Web Application Security - Part III: Apache Shiro Login Demo blog post and the video:

Hi Shiro community,

The following article helps explain the differences in role-based vs resource-based access control and why Shiro's permission construct (which is based on resources) can be much better for an application:

The New RBAC: Resource-Based Access Control

In our effort to improve the documentation you need to get started with Shiro, we've written a quick Java Authorization Guide for your review. Check out and tell us what you think. And if you haven't already, check out our previous post, the Java Authentication Guide.

Secure your Grails application quickly and easily using the Apache Shiro security framework. Although easy to get started with, this framework gives you a great deal of flexibility and will support your application as it grows.

https://grails.org/plugin/shiro

Mule now has integration with Apache Shiro. Thanks to Dan Diephouse at MuleSoft for the great blog post.

http://blogs.mulesoft.com/dev/mule-dev/apache-shiro-support-for-mule/

Check out the video from the San Francisco Java User Group presentation on Apache Shiro.

Video

Courtesy of Aleksandar and Max at the SF JUG

Dear Apache Shiro Community,

We are proud and excited to offer Apache Shiro's first release as an Apache Top Level Project, Apache Shiro version 1.1.0.

This release includes a number of bug fixes, new features and one important security vulnerability fix - it is recommended that users upgrade to 1.1.0 as soon as possible.

Version 1.1.0 is available immediately for download here accompanied by associated documentation and Release Notes.

All binaries are available in Maven Central already. Please note that most of the Apache mirrors have been updated to reflect the source distribution, but some mirrors may not be updated yet. If a mirror download link does not work, please try another or wait another 12 to 24 hours.

Enjoy!

On Wednesday, September 22nd 2010, the Apache Software Foundation Board voted unanimously to accept Apache Shiro's graduation out of the Incubator and to become a Apache Top Level Project.

Many thanks to the entire community for the continued growth and support, and especially to our Mentors, for helping us navigate the project through the incubation process. Everything is much appreciated and it has been well worth it.

Next steps: It will take us a bit of time to migrate our infrastructure to non-Incubator resources (shiro.apache.org subdomain, Subversion move, etc), so please stay tuned. Hopefully that can be done in the next two weeks. Shortly thereafter, we hope to release Shiro 1.1.

Thanks again to all, and please keep contributing to the project and the mailing lists to continually better the project for everyone!

Best regards,

Les

On 12 October 2010 at 6:30 pm PDT, Les Hazlewood will present Super Simple Application Security with Apache Shiro to the San Francisco Java User Group. Please RSVP if you wish to attend - seats are limited!

Nathan Good wrote an article introducing some of Apache Shiro's capabilities. Thanks Nathan!

Tonight, 1 June 2010, Les Hazlewood will present Apache Shiro to the SDForum Java SIG in Palo Alto, California. Please come if you can!