svn commit: r1328924 - in /sling/site/trunk/content: authentication---framework.mdtext authentication.mdtext authentication.png

[fm...@apache.org]

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