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

Kim Haase commented on DERBY-5928:
----------------------------------

The section "Configuring security for your environment" has lists of tasks that 
are somewhat different depending whether you are in embedded or client-server 
mode. I assume these differences are current and valid and that the list of 
tasks should be different for the two modes. Please let me know if any changes 
are needed here.

The major work involved in this documentation, I believe, is to flip the 
contents of the "Derby and security" and "Configuring security for your 
environment" sections of http://db.apache.org/derby/docs/dev/devguide/, rework 
them slightly, and add links to further information to the "Configuring 
security for your environment" sections. The remaining sections can probably 
remain as is.

Further information is to be found in both the Reference Manual and the Admin 
Guide.

The first topic, "Derby and security", should be titled "Configuring security 
for Derby" and should rework the contents of "Configuring security for your 
environment" and its two subsections.

The next topic should be "Derby security concepts" and should use the material 
from the original "Derby and security" topic.

The other topics should probably remain the same, although additional tweaks 
are possible.
  Working with user authentication
  Users and authorization identifiers
  User authorizations
  Encrypting databases on disk
  Signed jar files
  User authentication and authorization examples
  Running Derby under a security manager
                
> Add more task focus to Derby security documentation
> ---------------------------------------------------
>
>                 Key: DERBY-5928
>                 URL: https://issues.apache.org/jira/browse/DERBY-5928
>             Project: Derby
>          Issue Type: Task
>          Components: Documentation
>    Affects Versions: 10.9.1.0
>            Reporter: Kim Haase
>            Assignee: Kim Haase
>
> It has been recommended that the Derby security documentation in the 
> Developer's Guide should have more of a task-based focus: instead of 
> beginning with an outline of security concepts and then describing the tasks 
> a user or administrator should perform to secure Derby, we should begin with 
> a list of the steps required for security, with links to details on how to 
> perform them, and cover the concepts after that. Users should have a single 
> location where they can verify that they have done everything they can to 
> ensure database security.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

Reply via email to