svn commit: r1154966 - in /db/derby/docs/branches/10.8/src: adminguide/tadmincbdjhhfd.dita adminguide/tadminnetservbasic.dita devguide/cdevcsecure42374.dita

[ch...@apache.org]

Author: chaase3
Date: Mon Aug  8 13:51:02 2011
New Revision: 1154966

URL: http://svn.apache.org/viewvc?rev=1154966&view=rev
Log:
DERBY-5376  Documentation should state authentication/authorization requirements more strongly

Merged DERBY-5376-2.diff to 10.8 docs branch from trunk revision 1154958.

Modified:
    db/derby/docs/branches/10.8/src/adminguide/tadmincbdjhhfd.dita
    db/derby/docs/branches/10.8/src/adminguide/tadminnetservbasic.dita
    db/derby/docs/branches/10.8/src/devguide/cdevcsecure42374.dita

Modified: db/derby/docs/branches/10.8/src/adminguide/tadmincbdjhhfd.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/branches/10.8/src/adminguide/tadmincbdjhhfd.dita?rev=1154966&r1=1154965&r2=1154966&view=diff
==============================================================================
--- db/derby/docs/branches/10.8/src/adminguide/tadmincbdjhhfd.dita (original)
+++ db/derby/docs/branches/10.8/src/adminguide/tadmincbdjhhfd.dita Mon Aug  8 13:51:02 2011
@@ -32,10 +32,12 @@ after use, because failure to do so migh
 such as blocked ports on the server.</note></context>
 <example>
 <p>
-You are strongly urged to enable user authentication when you run a
-Network Server.
-For details on how to configure user authentication, please consult
-the "Working with user authentication" section in the Developer's Guide.
+You are strongly urged to enable user authentication and user authorization when
+you run a Network Server. For details on how to configure user authentication,
+see "Working with user authentication" in the
+<ph conref="../conrefs.dita#pub/citdevelop"></ph>. For information on user
+authorization, see "Users and authorization identifiers" and "User
+authorizations" in the <ph conref="../conrefs.dita#pub/citdevelop"></ph>.
 You are also urged to install a Java security manager with a
 customized security policy. For details on how to do this, see
 <xref href="tadminnetservcustom.dita"></xref>.

Modified: db/derby/docs/branches/10.8/src/adminguide/tadminnetservbasic.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/branches/10.8/src/adminguide/tadminnetservbasic.dita?rev=1154966&r1=1154965&r2=1154966&view=diff
==============================================================================
--- db/derby/docs/branches/10.8/src/adminguide/tadminnetservbasic.dita (original)
+++ db/derby/docs/branches/10.8/src/adminguide/tadminnetservbasic.dita Mon Aug  8 13:51:02 2011
@@ -30,9 +30,13 @@ manager, the Network Server will install
 a Basic policy. This happens if you boot the Network Server as your VM's entry
 point, e.g.: </p>  <codeblock>
 java org.apache.derby.drda.NetworkServerControl start ...
-</codeblock>  <p> Note that you should run your Network Server with user authentication
-enabled. For details on how to enable user authentication, please see "Working
-with user authentication" in the <ph conref="../conrefs.dita#pub/citdevelop"></ph>. </p>  <p> Some
+</codeblock>  <p>Note that you should run your Network Server with user
+authentication and user authorization enabled. For details on how to enable user
+authentication, see "Working with user authentication" in the
+<ph conref="../conrefs.dita#pub/citdevelop"></ph>. For information on user
+authorization, see "Users and authorization identifiers" and "User
+authorizations" in the <ph conref="../conrefs.dita#pub/citdevelop"></ph>.</p>
+<p> Some
 of your application code may run as procedures and functions which you have
 declared using the CREATE PROCEDURE and CREATE FUNCTION statements. You will
 need to add privileged blocks to your declared procedures and functions if

Modified: db/derby/docs/branches/10.8/src/devguide/cdevcsecure42374.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/branches/10.8/src/devguide/cdevcsecure42374.dita?rev=1154966&r1=1154965&r2=1154966&view=diff
==============================================================================
--- db/derby/docs/branches/10.8/src/devguide/cdevcsecure42374.dita (original)
+++ db/derby/docs/branches/10.8/src/devguide/cdevcsecure42374.dita Mon Aug  8 13:51:02 2011
@@ -21,9 +21,13 @@ limitations under the License.
 <concept id="cdevcsecure42374" xml:lang="en-us">
 <title>Working with user authentication</title>
 <shortdesc><ph conref="../conrefs.dita#prod/productshortname"></ph> provides
-support for user authentication. <term>User authentication</term> means that <ph
-conref="../conrefs.dita#prod/productshortname"></ph> authenticates the name
-and password for a user before allowing that user access to the system.</shortdesc>
+support for user authentication and user authorization. <term>User
+authentication</term> means that
+<ph conref="../conrefs.dita#prod/productshortname"></ph> authenticates the name
+and password for a user before allowing that user access to the system.
+<term>User authorization</term> allows access to a particular
+database. You are strongly urged to implement both authentication and
+authorization on any multi-user database used in production.</shortdesc>
 <prolog><metadata>
 <keywords><indexterm>user authentication<indexterm>overview</indexterm></indexterm>
 <indexterm>authentication<indexterm>users, overview</indexterm></indexterm>