This is an automated email from the ASF dual-hosted git repository.
lprimak pushed a commit to branch asf-staging
in repository https://gitbox.apache.org/repos/asf/shiro-site.git
The following commit(s) were added to refs/heads/asf-staging by this push:
new 6e3b74924 update
6e3b74924 is described below
commit 6e3b74924d23dcb196f807de7861a8cf610f8237
Author: lprimak <[email protected]>
AuthorDate: Sun Oct 11 01:04:18 2026 -0500
update
---
.well-known/security.txt | 2 +-
authenticator.html | 28 ++++++++++++++
authorizer.html | 31 +++++++++++++++
documentation.html | 23 +++++++++--
feed.xml | 2 +-
get-started.html | 39 +++++++++++++++++++
guides.html | 88 +++++++++++++++++++++++++++++++++++++++---
java-authentication-guide.html | 28 ++++++++++++++
java-authorization-guide.html | 29 +++++++++++++-
reference.html | 39 +++++++++++++++++++
10 files changed, 297 insertions(+), 12 deletions(-)
diff --git a/.well-known/security.txt b/.well-known/security.txt
index f5e73a636..4b7838b4c 100644
--- a/.well-known/security.txt
+++ b/.well-known/security.txt
@@ -1,5 +1,5 @@
Contact: mailto:[email protected]
-Expires: 2027-10-11T05:39:47Z
+Expires: 2027-10-11T06:03:45Z
Preferred-Languages: en
Canonical: https://shiro.apache.org/.well-known/security.txt
Policy: https://shiro.apache.org/security-reports.html
\ No newline at end of file
diff --git a/authenticator.html b/authenticator.html
index 315dc0281..963ee8af1 100644
--- a/authenticator.html
+++ b/authenticator.html
@@ -235,6 +235,7 @@
<li><a
href="#Authenticator-AuthenticationStrategy">AuthenticationStrategy</a></li>
<li><a href="#Authenticator-Configuration">Configuration</a></li>
<li><a href="#Authenticator-RealmInteraction">How Authenticators Work with
Realms</a></li>
+<li><a href="#Authenticator-SeeAlso">See Also</a></li>
</ul>
</div>
<div id="preamble">
@@ -403,6 +404,33 @@ The Realm is responsible for:</p>
<p>The Authenticator simply orchestrates this process by delegating to Realms
in order and handling the results according to its configured strategy.</p>
</div>
</div>
+</div>
+<div class="sect1">
+<h2 id="Authenticator-SeeAlso">See Also</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>To learn more about related topics, see:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="authentication.html">Authentication</a> - Conceptual overview of
authentication in Shiro.</p>
+</li>
+<li>
+<p><a href="java-authentication-guide.html">Java Authentication Guide</a> -
Practical guide to implementing authentication in your application.</p>
+</li>
+<li>
+<p><a href="realm.html">Realms</a> - How Realms connect Shiro to your data
sources.</p>
+</li>
+<li>
+<p><a href="authorizer.html">Authorizers</a> - The counterpart component for
authorization.</p>
+</li>
+<li>
+<p><a href="securitymanager.html">SecurityManager</a> - The component that
orchestrates Authenticators and other Shiro components.</p>
+</li>
+</ul>
+</div>
+</div>
</div>
<hr />
diff --git a/authorizer.html b/authorizer.html
index 2324e4516..8629870dd 100644
--- a/authorizer.html
+++ b/authorizer.html
@@ -241,6 +241,7 @@
<li><a href="#Authorizer-Configuration">Configuration</a></li>
<li><a href="#Authorizer-RealmInteraction">How Authorizers Work with
Realms</a></li>
<li><a href="#Authorizer-MultipleRealms">Authorization with Multiple
Realms</a></li>
+<li><a href="#Authorizer-SeeAlso">See Also</a></li>
</ul>
</div>
<div id="preamble">
@@ -437,6 +438,36 @@ However, the exact behavior depends on the authorization
data model and how the
Custom Authorizer implementations can be used to implement different
aggregation strategies if needed.</p>
</div>
</div>
+</div>
+<div class="sect1">
+<h2 id="Authorizer-SeeAlso">See Also</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>To learn more about related topics, see:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="authorization.html">Authorization</a> - Conceptual overview of
authorization in Shiro.</p>
+</li>
+<li>
+<p><a href="java-authorization-guide.html">Java Authorization Guide</a> -
Practical guide to implementing authorization in your application.</p>
+</li>
+<li>
+<p><a href="permissions.html">Permissions</a> - Understanding Shiro’s
permission model.</p>
+</li>
+<li>
+<p><a href="realm.html">Realms</a> - How Realms connect Shiro to your data
sources.</p>
+</li>
+<li>
+<p><a href="authenticator.html">Authenticators</a> - The counterpart component
for authentication.</p>
+</li>
+<li>
+<p><a href="securitymanager.html">SecurityManager</a> - The component that
orchestrates Authorizers and other Shiro components.</p>
+</li>
+</ul>
+</div>
+</div>
</div>
<hr />
diff --git a/documentation.html b/documentation.html
index 78b3941f4..babb55815 100644
--- a/documentation.html
+++ b/documentation.html
@@ -230,7 +230,12 @@
<h2 id="introduction">Introduction</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>Helpful if read in order:</p>
+<p>This page serves as the central hub for all Apache Shiro documentation.
Whether you are just getting started or looking for detailed reference
material, you will find links to the appropriate resources here.</p>
+</div>
+<div class="sect2">
+<h3 id="new_to_shiro">New to Shiro?</h3>
+<div class="paragraph">
+<p>If you are new to Apache Shiro, we recommend reading these resources in
order:</p>
</div>
<div class="ulist">
<ul>
@@ -238,16 +243,20 @@
<p><a href="https://www.infoq.com/articles/apache-shiro";>Application Security
with Apache Shiro</a> - full intro article on InfoQ.com</p>
</li>
<li>
-<p><a href="10-minute-tutorial.html">10 Minute Tutorial</a></p>
+<p><a href="10-minute-tutorial.html">10 Minute Tutorial</a> - quick hands-on
introduction</p>
</li>
<li>
-<p><a href="webapp-tutorial.html">Beginner’s Webapp Tutorial: a
step-by-step tutorial to enable Shiro in a web application</a></p>
+<p><a href="webapp-tutorial.html">Beginner’s Webapp Tutorial</a> -
step-by-step guide to enable Shiro in a web application</p>
</li>
<li>
<p><a href="https://start.flowlogix.com";>Flowlogix Starter</a> - generate
Jakarta EE projects with Shiro support</p>
</li>
</ul>
</div>
+<div class="paragraph">
+<p>Once you understand the basics, explore the <a
href="guides.html">Guides</a> page for a complete learning path.</p>
+</div>
+</div>
</div>
</div>
<div class="sect1">
@@ -258,7 +267,7 @@
<div class="ulist">
<ul>
<li>
-<p><a href="reference.html">Reference Manual</a></p>
+<p><a href="reference.html">Reference Manual</a> - comprehensive reference
covering all Shiro concepts and features</p>
</li>
</ul>
</div>
@@ -309,6 +318,12 @@
</li>
</ul>
</div>
+</div>
+<div class="sect2">
+<h3 id="upgrading">Upgrading?</h3>
+<div class="paragraph">
+<p>If you are upgrading from an earlier version of Shiro, see the <a
href="migration-guide.html">Migration Guide</a> for important changes and
upgrade instructions.</p>
+</div>
<h2 id="Lendahandwithdocumentation">Lend a hand with documentation</h2>
<p>While we hope this documentation helps you with the work you're doing with
Apache Shiro, the community is improving and expanding the documentation all
the time. If you'd like to help the Shiro project, please consider correcting,
expanding, or adding documentation where you see a need. Every little bit of
help you provide expands the community and in turn improves Shiro. </p>
diff --git a/feed.xml b/feed.xml
index 76fc82f6e..0da564582 100644
--- a/feed.xml
+++ b/feed.xml
@@ -4,7 +4,7 @@
<subtitle>Simple. Java. Security.</subtitle>
<link href="https://shiro.apache.org/"/>
<link rel="self" href="https://shiro.apache.org/feed.xml"; />
- <updated>2026-10-11T05:39:47Z</updated>
+ <updated>2026-10-11T06:03:46Z</updated>
<author>
<name>Les Hazlewood</name>
diff --git a/get-started.html b/get-started.html
index 8f682921c..bd607c024 100644
--- a/get-started.html
+++ b/get-started.html
@@ -287,6 +287,45 @@ Articles and Guides written by and for members of the
Apache Shiro community.</p
</ul>
</div>
</div>
+</div>
+<div class="sect1">
+<h2 id="next_steps">Next Steps</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Once you have completed the tutorials above, consider exploring these
topics:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="guides.html">All Guides</a> - Browse the complete collection of
Shiro guides.</p>
+</li>
+<li>
+<p><a href="reference.html">Reference Documentation</a> - Comprehensive
reference covering all Shiro features.</p>
+</li>
+<li>
+<p><a href="realm.html">Realms</a> - Learn how to connect Shiro to your user
data sources.</p>
+</li>
+<li>
+<p><a href="migration-guide.html">Migration Guide</a> - If you are upgrading
from an older Shiro version.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="need_help">Need Help?</h2>
+<div class="sectionbody">
+<div class="ulist">
+<ul>
+<li>
+<p><a href="mailing-lists.html">Mailing Lists</a> - Ask questions and get help
from the community.</p>
+</li>
+<li>
+<p><a href="issues.html">Issue Tracker</a> - Report bugs or request
features.</p>
+</li>
+</ul>
+</div>
+</div>
</div>
<hr />
diff --git a/guides.html b/guides.html
index e577776ed..2d54184df 100644
--- a/guides.html
+++ b/guides.html
@@ -226,27 +226,105 @@
</table>
</div>
+<div id="preamble">
+<div class="sectionbody">
<div class="paragraph">
-<p>Here are some basic guides on how to use Shiro.</p>
+<p>This page collects the primary guides for learning Apache Shiro. Whether
you are new to Shiro or looking to deepen your understanding, these guides
provide practical, step-by-step instructions.</p>
</div>
<div class="paragraph">
<p>Please post any errata to the user or dev mailing lists.</p>
</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="getting_started">Getting Started</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>If you are new to Shiro, start here:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="10-minute-tutorial.html">10 Minute Tutorial</a> - A quick hands-on
introduction to Shiro’s core API and concepts.</p>
+</li>
+<li>
+<p><a href="tutorial.html">Your First Shiro Application</a> - Build a simple
application secured by Shiro from scratch.</p>
+</li>
+<li>
+<p><a href="webapp-tutorial.html">Beginner’s Webapp Tutorial</a> - A
step-by-step guide to enabling Shiro in a web application.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="core_concepts">Core Concepts</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Once you understand the basics, explore these guides to learn how
authentication and authorization work in Shiro:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="java-authentication-guide.html">Authentication Guide</a> - Learn
how to verify user identity using Shiro’s authentication API.</p>
+</li>
+<li>
+<p><a href="java-authorization-guide.html">Authorization Guide</a> -
Understand how to control access to resources based on roles and
permissions.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="advanced_topics">Advanced Topics</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>After mastering the core concepts, consider these topics:</p>
+</div>
<div class="ulist">
<ul>
<li>
-<p><a href="10-minute-tutorial.html">10 Minute Tutorial</a></p>
+<p><a href="realm.html">Realm Guide</a> - Learn how Realms connect Shiro to
your user data sources.</p>
</li>
<li>
-<p><a href="java-authentication-guide.html">Authentication Guide</a></p>
+<p><a href="session-management.html">Session Management</a> - Understand how
Shiro manages user sessions across environments.</p>
</li>
<li>
-<p><a href="java-authorization-guide.html">Authorization Guide</a></p>
+<p><a href="cryptography.html">Cryptography</a> - Explore Shiro’s
simplified cryptography APIs.</p>
</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="upgrading_shiro">Upgrading Shiro</h2>
+<div class="sectionbody">
+<div class="ulist">
+<ul>
<li>
-<p><a href="migration-guide.html">Migration Guide: Upgrading Shiro 1.x → 2.x →
3.x</a></p>
+<p><a href="migration-guide.html">Migration Guide: Upgrading Shiro 1.x → 2.x →
3.x</a> - Step-by-step instructions for upgrading between major Shiro
versions.</p>
</li>
</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="see_also">See Also</h2>
+<div class="sectionbody">
+<div class="ulist">
+<ul>
+<li>
+<p><a href="reference.html">Reference Documentation</a> - Complete reference
for all Shiro features.</p>
+</li>
+<li>
+<p><a href="documentation.html">Documentation Hub</a> - Central hub for all
Shiro documentation resources.</p>
+</li>
+<li>
+<p><a href="articles.html">Community Articles</a> - Articles and tutorials
contributed by the Shiro community.</p>
+</li>
+</ul>
+</div>
+</div>
</div>
<hr />
diff --git a/java-authentication-guide.html b/java-authentication-guide.html
index 6260469c6..886e89fe5 100644
--- a/java-authentication-guide.html
+++ b/java-authentication-guide.html
@@ -244,6 +244,7 @@
</ul>
</li>
<li><a href="#logging_out">Logging Out</a></li>
+<li><a href="#see_also">See Also</a></li>
</ul>
</div>
<div id="preamble">
@@ -496,6 +497,33 @@ After the login, your identity has been verified and
<code>isAuthenticated()=TRU
<p>When you log out in Shiro it will close out the user session and removes
any associated identity from the subject instance. If you’re using
RememberMe in a web environment, then <code>.logout()</code> will, by default,
also delete the RememberMe cookie from the browser.</p>
</div>
</div>
+</div>
+<div class="sect1">
+<h2 id="see_also">See Also</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Now that you understand authentication in Shiro, continue learning with
these resources:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="java-authorization-guide.html">Java Authorization Guide</a> -
Learn how to control access to resources after authentication.</p>
+</li>
+<li>
+<p><a href="realm.html">Realms</a> - Learn how to connect Shiro to your user
data sources.</p>
+</li>
+<li>
+<p><a href="authentication.html">Authentication Concepts</a> - Deeper dive
into Shiro’s authentication architecture.</p>
+</li>
+<li>
+<p><a href="authenticator.html">Authenticators</a> - Understand the component
that performs authentication.</p>
+</li>
+<li>
+<p><a href="subject.html">Subject</a> - Learn more about the Subject API.</p>
+</li>
+</ul>
+</div>
+</div>
</div>
<hr />
diff --git a/java-authorization-guide.html b/java-authorization-guide.html
index 69d0862c6..bc0e87acb 100644
--- a/java-authorization-guide.html
+++ b/java-authorization-guide.html
@@ -533,7 +533,34 @@ public void openAccount( Account acct ) {
<h2 id="caching_authorization">Caching Authorization</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>TBD</p>
+<p>Shiro supports caching authorization data to improve performance. When
authorization checks are performed frequently, caching avoids repeated lookups
to the underlying data source. For more information on how caching works in
Shiro, see the <a href="caching.html">Caching Documentation</a>.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="see_also">See Also</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Now that you understand authorization in Shiro, continue learning with
these resources:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="permissions.html">Permissions</a> - Deep dive into Shiro’s
permission model.</p>
+</li>
+<li>
+<p><a href="realm.html">Realms</a> - Learn how Realms provide authorization
data.</p>
+</li>
+<li>
+<p><a href="authorization.html">Authorization Concepts</a> - Deeper dive into
Shiro’s authorization architecture.</p>
+</li>
+<li>
+<p><a href="authorizer.html">Authorizers</a> - Understand the component that
performs authorization.</p>
+</li>
+<li>
+<p><a href="java-authentication-guide.html">Java Authentication Guide</a> - If
you haven’t already, learn about authentication.</p>
+</li>
+</ul>
</div>
</div>
</div>
diff --git a/reference.html b/reference.html
index 088b0cd45..4a89af598 100644
--- a/reference.html
+++ b/reference.html
@@ -226,6 +226,25 @@
</table>
</div>
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p>This reference manual provides comprehensive documentation for all Apache
Shiro features. Use this as your primary reference when implementing security
in your applications.</p>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>If you are new to Shiro, we recommend starting with the <a
href="10-minute-tutorial.html">10 Minute Tutorial</a> or the <a
href="guides.html">Guides</a> before diving into the reference material.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
<div class="olist arabic">
<ol class="arabic">
<li>
@@ -361,6 +380,26 @@
</div>
</li>
</ol>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="see_also">See Also</h2>
+<div class="sectionbody">
+<div class="ulist">
+<ul>
+<li>
+<p><a href="guides.html">Guides</a> - Tutorials and step-by-step
instructions.</p>
+</li>
+<li>
+<p><a href="documentation.html">Documentation Hub</a> - Central hub for all
Shiro documentation.</p>
+</li>
+<li>
+<p><a href="migration-guide.html">Migration Guide</a> - For users upgrading
between major versions.</p>
+</li>
+</ul>
+</div>
+</div>
</div>
<hr />
