Mailing-List: contact derby-dev-help@db.apache.org; run by ezmlm
Precedence: bulk
Reply-To: <derby-dev@db.apache.org>
Message-ID: <19985060.22491271716070392.JavaMail.jira@thor>
Date: Mon, 19 Apr 2010 18:27:50 -0400 (EDT)
From: "Knut Anders Hatlen (JIRA)" <jira@apache.org>
To: derby-dev@db.apache.org
Subject: [jira] Commented: (DERBY-4579) Document the configurable hash
 authentication scheme
In-Reply-To: <756851717.226261268398587316.JavaMail.jira@brutus.apache.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit


    [ https://issues.apache.org/jira/browse/DERBY-4579?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12858706#action_12858706 ] 

Knut Anders Hatlen commented on DERBY-4579:
-------------------------------------------

One more thing. After this issue was filed, the new authentication mechanism has been made the default for BUILTIN in new databases. At database creation time, the property will be initialized to SHA-256 (or under certain conditions SHA-1 because of DERBY-4602). We may want to state that in the documentation for the property. For example: "In a newly created database, the value of this property will be either SHA-256, if it is available on the platform, or SHA-1 otherwise."

> Document the configurable hash authentication scheme
> ----------------------------------------------------
>
>                 Key: DERBY-4579
>                 URL: https://issues.apache.org/jira/browse/DERBY-4579
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.6.0.0
>            Reporter: Knut Anders Hatlen
>            Assignee: Kim Haase
>
> DERBY-4483 adds the ability to configure which message digest algorithm to use to protect the passwords that are stored in the database when using BUILTIN authentication.
> I think these changes are required:
> * Reference manual: Document the new database property derby.authentication.builtin.algorithm. It's a dynamic property that can be set either on database level or on system level. Its value is the name of a message digest algorithm available from one of the Java Cryptography Extension providers registered in the JVM. Example values: MD5, SHA-256, SHA-512. The specified algorithm will be applied on the concatenation of the user name and the password before it's stored in the database. If the property is NULL or the empty string, the old algorithm (SHA-1 on the password only) is applied instead.
> * Developer's guide: Mention the property in "List of user authentication properties"
> * Server and admin guide: In the table in section "Network client security", mention that strong password substitution cannot be used to connect as a user whose password has been stored with the new scheme. I'd suggest changing the following sentence:
>     Strong password substitution cannot be used with external Derby authentication schemes (for example, LDAP).
> And replacing it with something like:
>     Strong password substitution can only be used with Derby's NONE and BUILTIN authentication schemes. Also, for the BUILTIN scheme, it does not work for database-level users whose password has been protected by a custom message digest algorithm specified by the derby.authentication.builtin.algorithm property.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.