db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From j..@apache.org
Subject svn commit: r433290 - in /db/derby/docs/trunk/src/devguide: tdevdvlp40140.dita tdevdvlpcreateencryptdbextkey.dita
Date Mon, 21 Aug 2006 17:13:43 GMT
Author: jta
Date: Mon Aug 21 10:13:42 2006
New Revision: 433290

URL: http://svn.apache.org/viewvc?rev=433290&view=rev
Log:
DERBY-1622: Add documentation for encrypting databases using encryptionKey
connection attribute.

Committed patch derby1622_devguide_5.diff by Laura Stewart <scotsmatrix@gmail.com>.

Added:
    db/derby/docs/trunk/src/devguide/tdevdvlpcreateencryptdbextkey.dita   (with props)
Modified:
    db/derby/docs/trunk/src/devguide/tdevdvlp40140.dita

Modified: db/derby/docs/trunk/src/devguide/tdevdvlp40140.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/tdevdvlp40140.dita?rev=433290&r1=433289&r2=433290&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/tdevdvlp40140.dita (original)
+++ db/derby/docs/trunk/src/devguide/tdevdvlp40140.dita Mon Aug 21 10:13:42 2006
@@ -37,13 +37,13 @@
 <choice>If the database was encrypted using the bootPassword mechanism, specify
 the <i>bootPassword</i> attribute. For example:<codeblock>jdbc:derby:wombat;bootPassword=clo760uds2caPe
</codeblock></choice>
 <choice>If the database was encrypted using an external key, specify the <i>encryptionKey</i>
attribute.
-For example: <codeblock>jdbc:derby:flintstone;encryptionAlgorithm=AES/CBC/NoPadding;encryptionKey=c566bab9ee8b62a5ddb4d9229224c678
</codeblock></choice>
+For example: <codeblock>jdbc:derby:flintstone;encryptionAlgorithm=AES/CBC/NoPadding;encryptionKey=c566bab9ee8b62a5ddb4d9229224c678
</codeblock><p
+>If the algorithm that was used when the database was created is not the default
+algorithm, you must also specify the <i>encryptionAlgorithm</i> attribute.
+The default encryption algorithm used by <ph conref="devconrefs.dita#prod/productshortname"></ph>
is
+DES/CBC/NoPadding.</p></choice>
 </choices>
 </step>
 </steps>
-<postreq>If the algorithm that was used when the database was created is not
-the default algorithm, you must also specify the <i>encryptionAlgorithm</i> attribute.
-The default encryption algorithm used by <ph conref="devconrefs.dita#prod/productshortname"></ph>
is
-DES/CBC/NoPadding.</postreq>
 </taskbody>
 </task>

Added: db/derby/docs/trunk/src/devguide/tdevdvlpcreateencryptdbextkey.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/tdevdvlpcreateencryptdbextkey.dita?rev=433290&view=auto
==============================================================================
--- db/derby/docs/trunk/src/devguide/tdevdvlpcreateencryptdbextkey.dita (added)
+++ db/derby/docs/trunk/src/devguide/tdevdvlpcreateencryptdbextkey.dita Mon Aug 21 10:13:42
2006
@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="utf-8"?>
+ 
+<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN"
+ "../dtd/task.dtd">
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at      
+
+   http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<task id="tdevdvlpcreateencryptdbextkey" xml:lang="en-us">
+<title>Creating an encrypted database with an external key</title>
+<shortdesc>You can create a database and encrypt the database with an external
+key.</shortdesc>
+<prolog><metadata>
+<keywords><indexterm>encrypting databases<indexterm>external key, on creation</indexterm></indexterm>
+<indexterm>databases<indexterm>creating encrypted, with external key</indexterm></indexterm>
+</keywords>
+</metadata></prolog>
+<taskbody>
+<context><p>To create an encrypted database using an external key:</p></context>
+<steps>
+<step><cmd>Use the <i>encryptionKey</i> attribute in the connection
URL.</cmd>
+<stepxmp>For example to create the database and encrypt the database <codeph>encDB</codeph>
using
+an external key, specify this URL:<codeblock>jdbc:derby:encDB;create=true;dataEncryption=true;encryptionAlgorithm=DES/CBC/NoPadding;encryptionKey=6162636465666768
</codeblock
+></stepxmp><info><note type="attention"> If you lose the encryption
key you
+will not be able to boot the database.</note></info></step>
+</steps>
+</taskbody>
+</task>

Propchange: db/derby/docs/trunk/src/devguide/tdevdvlpcreateencryptdbextkey.dita
------------------------------------------------------------------------------
    svn:eol-style = native



Mime
View raw message