Author: fmeschbe
Date: Sun Apr 22 18:26:44 2012
New Revision: 1328924
URL: http://svn.apache.org/viewvc?rev=1328924&view=rev
Log:
authentication page improvements
Added:
sling/site/trunk/content/authentication.png (with props)
Modified:
sling/site/trunk/content/authentication---framework.mdtext
sling/site/trunk/content/authentication.mdtext
Modified: sling/site/trunk/content/authentication---framework.mdtext
URL:
http://svn.apache.org/viewvc/sling/site/trunk/content/authentication---framework.mdtext?rev=1328924&r1=1328923&r2=1328924&view=diff
==============================================================================
--- sling/site/trunk/content/authentication---framework.mdtext (original)
+++ sling/site/trunk/content/authentication---framework.mdtext Sun Apr 22
18:26:44 2012
@@ -73,16 +73,14 @@ Core 1.1.0)
Extracting the credentials and trying to login to the repository may yield
the following results:
-<table>
-<tr><td> Credentials </td><td> Login </td><td> Consequence </td></tr>
-<tr><td> present </td><td> successfull </td><td> Continue with an
authenticated request </td></tr>
-<tr><td> present </td><td> failed </td><td> Select *AuthenticationHandler* and
call
-*requestCredentials* method </td></tr>
-<tr><td> missing </td><td> anonymous allowed </td><td> Continue with a non
authenticated request
-using anonymous access to the repository </td></tr>
-<tr><td> missing </td><td> anonymous forbidden </td><td> Select
*AuthenticationHandler* and call
-*requestCredentials* method </td></tr>
-</table>
+
+| Credentials | Login | Consequence |
+|-------------|-------|-------------|
+| present | successfull | Continue with an authenticated request |
+| present | failed | Select `AuthenticationHandler` and call
`requestCredentials` method |
+| missing | anonymous allowed | Continue with a non authenticated request
using anonymous access to the repository |
+| missing | anonymous forbidden | Select `AuthenticationHandler` and call
`requestCredentials` method |
+
{note}
Only one *AuthenticationHandler* is able to provide credentials for a
@@ -100,27 +98,13 @@ The *handleSecurity* method gets credent
credentials. If the login is successful, the *SlingAuthenticator* sets
the following request attributes:
-<table>
-<tr><th> Attribute </th><th> Description </th></tr>
-<tr><td> *org.osgi.service.http.authentication.remote.user* </td><td> The user
ID of the
-JCR Session. This attribute is used by the HTTP Service implementation to
-implement the *HttpServletRequest.getRemoteUser* method. </td></tr>
-<tr><td> *org.osgi.service.http.authentication.type* </td><td> The
authentication type
-defined by the *AuthenticationHandler*. This attribute is used by the
-HTTP Service implementation to implement the
-*HttpServletRequest.getAuthType* method. </td></tr>
-<tr><td> *org.apache.sling.commons.auth.ResourceResolver* </td><td> The
-*ResourceResolver* created from the credentials and the logged in JCR
-Session. This attribute may be used by servlets to access the repository.
-Namely the *SlingMainServlet* uses this request attribute to provide the
-*ResourceResolver* to handle the request. </td></tr>
-<tr><td> *javax.jcr.Session* </td><td> The JCR Session. This attribute is for
backwards
-compatibility only. *Its use is deprecated and the attribute will be
-removed in future versions*. </td></tr>
-<tr><td> *org.apache.sling.commons.auth.spi.AuthenticationInfo* </td><td> The
-*AuthenticationInfo* object produced from the *AuthenticationHandler*.
-</td></tr>
-</table>
+| Attribute | Description |
+|-----------|-------------|
+| `org.osgi.service.http.authentication.remote.user` | The user ID of the JCR
Session. This attribute is used by the HTTP Service implementation to implement
the `HttpServletRequest.getRemoteUser` method. |
+| `org.osgi.service.http.authentication.type` | The authentication type
defined by the `AuthenticationHandler`. This attribute is used by the HTTP
Service implementation to implement the `HttpServletRequest.getAuthType`
method. |
+| `org.apache.sling.commons.auth.ResourceResolver` | The `ResourceResolver`
created from the credentials and the logged in JCR Session. This attribute may
be used by servlets to access the repository. Namely the `SlingMainServlet`
uses this request attribute to provide the `ResourceResolver` to handle the
request. |
+| `javax.jcr.Session` | The JCR Session. This attribute is for backwards
compatibility only. *Its use is deprecated and the attribute will be removed in
future versions*. |
+| `org.apache.sling.commons.auth.spi.AuthenticationInfo` | The
`AuthenticationInfo` object produced from the `AuthenticationHandler`. |
*NOTE*: Do _NOT_ use the *javax.jcr.Session* request attribute in your
Sling applications. This attribute must be considered implementation
@@ -172,13 +156,13 @@ setup to certain requests by scheme and/
*Examples*
* The *LoginServlet* contained in the Commons Auth bundle registers
-itself with the service registration property {{sling.auth.requirements =
-"-/system/sling/login"}} to ensure the servlet can be accessed without
+itself with the service registration property `sling.auth.requirements =
+"-/system/sling/login"` to ensure the servlet can be accessed without
requiring authentication.
* An authentication handler may register itself with the service
-registration property {{sling.auth.requirements =
-"-/apps/sample/loginform"}} to ensure the login form can be rendered
+registration property `sling.auth.requirements =
+"-/apps/sample/loginform"` to ensure the login form can be rendered
without requiring authentication.
Modified: sling/site/trunk/content/authentication.mdtext
URL:
http://svn.apache.org/viewvc/sling/site/trunk/content/authentication.mdtext?rev=1328924&r1=1328923&r2=1328924&view=diff
==============================================================================
--- sling/site/trunk/content/authentication.mdtext (original)
+++ sling/site/trunk/content/authentication.mdtext Sun Apr 22 18:26:44 2012
@@ -24,6 +24,7 @@ the servlet's *service* method.
{section}
{column}
+<img style="border: 0px solid black" title="Request Processing "
src="authentication.png">
!authentication.png|thumbnail!
{column}
{column}
Added: sling/site/trunk/content/authentication.png
URL:
http://svn.apache.org/viewvc/sling/site/trunk/content/authentication.png?rev=1328924&view=auto
==============================================================================
Binary file - no diff available.
Propchange: sling/site/trunk/content/authentication.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
