db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Knut Anders Hatlen (JIRA)" <j...@apache.org>
Subject [jira] Commented: (DERBY-4579) Document the configurable hash authentication scheme
Date Mon, 19 Apr 2010 22:27:50 GMT

    [ 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:
>            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

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

View raw message