Derby
  1. Derby
  2. DERBY-5376

Documentation should state authentication/authorization requirements more strongly

    Details

    • Type: Improvement Improvement
    • Status: Closed
    • Priority: Major Major
    • Resolution: Fixed
    • Affects Version/s: 10.8.1.2
    • Fix Version/s: 10.8.2.2, 10.9.1.0
    • Component/s: Documentation
    • Labels:
      None

      Description

      The Administration Guide and Developer's Guide should state more strongly the importance of securing a multi-user Derby system by implementing authentication and authorization. I have found two Admin Guide topics and one Dev Guide topic where this information can most usefully be added.

      1. DERBY-5376.diff
        4 kB
        Kim Haase
      2. DERBY-5376.diff
        4 kB
        Kim Haase
      3. DERBY-5376.stat
        0.1 kB
        Kim Haase
      4. DERBY-5376.zip
        12 kB
        Kim Haase
      5. DERBY-5376-2.diff
        4 kB
        Kim Haase
      6. DERBY-5376-2.zip
        12 kB
        Kim Haase

        Activity

        Hide
        Kim Haase added a comment -

        Closing, since fixes appear in latest alpha docs.

        Show
        Kim Haase added a comment - Closing, since fixes appear in latest alpha docs.
        Hide
        Kim Haase added a comment -

        Thanks very much, Dag and Rick.

        Committed patch DERBY-5376-2.diff to documentation trunk at revision 1154958.
        Merged to 10.8 doc branch at revision 1154966.

        Show
        Kim Haase added a comment - Thanks very much, Dag and Rick. Committed patch DERBY-5376 -2.diff to documentation trunk at revision 1154958. Merged to 10.8 doc branch at revision 1154966.
        Hide
        Rick Hillegas added a comment -

        +1. Thanks, Kim.

        Show
        Rick Hillegas added a comment - +1. Thanks, Kim.
        Hide
        Dag H. Wanvik added a comment -

        Looks good to me, Thanks, Kim.

        Show
        Dag H. Wanvik added a comment - Looks good to me, Thanks, Kim.
        Hide
        Kim Haase added a comment -

        Oops, how careless of me. Thanks, Rick! Attaching DERBY-5376-2.diff and DERBY-5376-2.zip, with those corrections.

        Any other changes? Thanks in advance.

        Show
        Kim Haase added a comment - Oops, how careless of me. Thanks, Rick! Attaching DERBY-5376 -2.diff and DERBY-5376 -2.zip, with those corrections. Any other changes? Thanks in advance.
        Hide
        Rick Hillegas added a comment -

        Thanks for the patch, Kim. A couple comments:

        o tadmincbdjhhfd - We should capitalize the lead word in the sentence beginning "for information on user authorization"

        o tadminnetservbasic - Same comment.

        Thanks.

        Show
        Rick Hillegas added a comment - Thanks for the patch, Kim. A couple comments: o tadmincbdjhhfd - We should capitalize the lead word in the sentence beginning "for information on user authorization" o tadminnetservbasic - Same comment. Thanks.
        Hide
        Kim Haase added a comment -

        Note: I prematurely attached the patch file without granting permission and now can't seem to get rid of it.

        Show
        Kim Haase added a comment - Note: I prematurely attached the patch file without granting permission and now can't seem to get rid of it.
        Hide
        Kim Haase added a comment -

        Attaching DERBY-5376.diff, DERBY-5376.stat, and DERBY-5376.zip, with changes to the following files:

        M src/adminguide/tadmincbdjhhfd.dita
        M src/adminguide/tadminnetservbasic.dita
        M src/devguide/cdevcsecure42374.dita

        For the two Admin Guide topics, I added information and pointers on authorization, on top of the existing information on authentication. For the Dev Guide topic, I added a definition of authorization, and a strong recommendation to use both authentication and authorization, to the introductory paragraph (which also appears in the parent topic in the frames version).

        Please let me know what changes are needed and if anything needs to be said elsewhere. These introductory sections seem to be the best places.

        Show
        Kim Haase added a comment - Attaching DERBY-5376 .diff, DERBY-5376 .stat, and DERBY-5376 .zip, with changes to the following files: M src/adminguide/tadmincbdjhhfd.dita M src/adminguide/tadminnetservbasic.dita M src/devguide/cdevcsecure42374.dita For the two Admin Guide topics, I added information and pointers on authorization, on top of the existing information on authentication. For the Dev Guide topic, I added a definition of authorization, and a strong recommendation to use both authentication and authorization, to the introductory paragraph (which also appears in the parent topic in the frames version). Please let me know what changes are needed and if anything needs to be said elsewhere. These introductory sections seem to be the best places.
        Hide
        Kim Haase added a comment -

        Attaching , with changes to the following files:

        M src/adminguide/tadmincbdjhhfd.dita
        M src/adminguide/tadminnetservbasic.dita
        M src/devguide/cdevcsecure42374.dita

        For the two Admin Guide topics, I added information and pointers on authorization, on top of the existing information on authentication. For the Dev Guide topic, I added a definition of authorization, and a strong recommendation to use both authentication and authorization, to the introductory paragraph (which also appears in the parent topic in the frames version).

        Please let me know what changes are needed and if anything needs to be said elsewhere. These introductory sections seem to be the best places.

        Show
        Kim Haase added a comment - Attaching , with changes to the following files: M src/adminguide/tadmincbdjhhfd.dita M src/adminguide/tadminnetservbasic.dita M src/devguide/cdevcsecure42374.dita For the two Admin Guide topics, I added information and pointers on authorization, on top of the existing information on authentication. For the Dev Guide topic, I added a definition of authorization, and a strong recommendation to use both authentication and authorization, to the introductory paragraph (which also appears in the parent topic in the frames version). Please let me know what changes are needed and if anything needs to be said elsewhere. These introductory sections seem to be the best places.

          People

          • Assignee:
            Kim Haase
            Reporter:
            Kim Haase
          • Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved:

              Development