[Pkg-owncloud-commits] [owncloud-doc] 20/38: added section on re-sharing after encryption is enabled, clarified which files are encrypted

[David Prévot]

This is an automated email from the git hooks/post-receive script.

taffit pushed a commit to branch master
in repository owncloud-doc.

commit a057b2a1f4d46727f6b52b7d5fffe0045c8259bd
Author: Carla Schroder <carla at owncloud.com>
Date:   Mon Oct 20 13:43:04 2014 -0700

    added section on re-sharing after encryption is enabled, clarified which files are encrypted
---
 user_manual/files/encryption.rst   |  34 ++++++++++++++++++++++++++++------
 user_manual/images/encryption2.png | Bin 21352 -> 8914 bytes
 2 files changed, 28 insertions(+), 6 deletions(-)

diff --git a/user_manual/files/encryption.rst b/user_manual/files/encryption.rst
index c6c5403..1aeb2e2 100644
--- a/user_manual/files/encryption.rst
+++ b/user_manual/files/encryption.rst
@@ -2,12 +2,12 @@ Encrypting Your ownCloud Files
 ==============================
 
 ownCloud includes an Encryption app, and when it is enabled by your ownCloud 
-administrator all of your files are automatically encrypted. Encryption is 
-server-wide, so when it is enabled all files on the server are encrypted and 
-you cannot choose to keep your files unencrypted. You don't have to do anything 
-special, as it uses your ownCloud login as the encryption password. Just log in 
-and out and manage and share your files as you normally do, and you can change 
-your password whenever you want.
+administrator all of your ownCloud data files are automatically encrypted. 
+Encryption is server-wide, so when it is enabled you cannot choose to keep your 
+files unencrypted. You don't have to do anything special, as it uses your 
+ownCloud login as the password for your unique private encryption key. Just log 
+in and out and manage and share your files as you normally do, and you can 
+still change your password whenever you want.
 
 Its main purpose is to encrypt files on remote storage services that are 
 connected to your ownCloud server, such as Dropbox and Google Drive. This is an 
@@ -44,10 +44,28 @@ files you have, and then you are returned to your default ownCloud page.
 
 .. figure:: ../images/encryption2.png
 
+
 .. note:: You must never lose your ownCloud password, because you will lose 
    access to your files. Though there is an optional recovery option that your 
    ownCloud administrator may enable; see the Recovery Key Password section to 
    learn about this.
+   
+Sharing Encrypted Files
+-----------------------
+
+Only users who have private encryption keys have access to shared encrypted 
+files and folders. Users who have not yet created their private encryption keys 
+will not have access to encrypted shared files; they will see folders and 
+filenames, but will not be able to open or download the files. They will see a 
+yellow warning banner that says "Encryption App is enabled but your keys are not 
+initialized, please log-out and log-in again."
+
+Share owners may need to re-share files after encryption is enabled; users 
+trying to access the share will see a message advising them to ask the share 
+owner to re-share the file with them. For individual shares, un-share and 
+re-share the file. For group shares, share with any individuals who can't access 
+the share. This updates the encryption, and then the share owner can remove the 
+individual shares.
 
 Recovery Key Password
 ~~~~~~~~~~~~~~~~~~~~~
@@ -86,6 +104,10 @@ structures. These files are never encrypted:
 - Image thumbnails from the Gallery app.
 - Previews from the Files app.
 - The search index from the full text search app.
+- Third-party app data
+
+There may be other files that are not encrypted; only files that are exposed to 
+third-party storage providers are guaranteed to be encrypted.
 
 Change Private Key Password
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/user_manual/images/encryption2.png b/user_manual/images/encryption2.png
index 2be406f..2a72475 100644
Binary files a/user_manual/images/encryption2.png and b/user_manual/images/encryption2.png differ

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-owncloud/owncloud-doc.git