Skip to content

Commit 75461fc

Browse files
authored
Feature: Add page about encrypted names/decrypt name feature (#79)
1 parent 15e5b3c commit 75461fc

6 files changed

+75
-1
lines changed

source/desktop/accessing-vaults.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ Click on ``Reveal Drive`` in the Cryptomator window to open the mount location u
5555

5656
Even though your files are shown unencrypted in the virtual drive, they are not stored unencrypted on the hard drive but only in `volatile memory <https://en.wikipedia.org/wiki/Volatile_memory>`_
5757

58-
.. image:: ../img/desktop/vault-detail-unlocked.png
58+
.. image:: ../img/desktop/vault-detail-unlocked-simple.png
5959
:alt: Cryptomator window showing an unlocked vault
6060

6161
.. note::
+73
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
Encrypted File Names
2+
====================
3+
4+
.. note::
5+
6+
Neither file name nor directory structure encryption can be disabled.
7+
8+
Cryptomator protect your files by not only encrypting their content, but also their names and the overall directory structure of the vault.
9+
For example, if you have a directory structure inside your vault like this:
10+
11+
.. code-block:: console
12+
13+
.
14+
├─ myProject.pptx
15+
├─ Images for Project
16+
│ └─ ImageOfBees.jpg
17+
└─ ...
18+
19+
The actual directory structure of the vault on your hard drive/cloud will look like this:
20+
21+
.. code-block:: console
22+
23+
.
24+
├─ d
25+
│ ├─ BZ
26+
│ │ └─ R4VZSS5PEF7TU3PMFIMON5GJRNBDWA
27+
│ │ ├─ dirId.c9r # internal vault file
28+
│ │ ├─ 5TyvCyF255sRtfrIv**83ucADQ==.c9r # myProject.pptx
29+
│ │ └─ FHTa55bH*sUfVDbEb0gTL9hZ8nho.c9r # Linking entry for directory "Images for Project"
30+
│ │ └─ dir.c9r # contains information for the link
31+
│ └─ FC
32+
│ └─ ZKZRLZUODUUYTYA4457CSBPZXB5A77 # content of the directory "Images for Project"
33+
│ └─ 4lmrQYfE_5ETusEkVJlTJrcFzjwxNBymig==.c9r # ImageOfBees.jpg
34+
├─ masterkey.cryptomator
35+
├─ masterkey.cryptomator.DFD9B248.bkup
36+
└─ vault.cryptomator
37+
38+
39+
While this increases security, it also makes it impossible to see the original file names and directory structure without decrypting them first.
40+
When you need to know the original name of a file (e.g. to restore an older version), you can use the ``Decrypt file name`` feature to decrypt the file name.
41+
42+
43+
.. _desktop/encrypted-file-names/decryption:
44+
45+
Decrypting File Names
46+
---------------------
47+
48+
.. note::
49+
50+
Due to technical reasons, Cryptomator can only decrypt the filen name given an encrypted file .
51+
It cannot compute the path inside the vault to the file.
52+
53+
You can access this feature from the unlocked view of a vault in the Cryptomator main window.
54+
On the bottom of the unlocked view, drop files on the "Decrypt file name" zone or click on it.
55+
A modal window with the encrypted-decrypted-mapping opens.
56+
57+
.. image:: ../img/desktop/vault-detail-unlocked.png
58+
:alt: Vault detail view in the unlocked state
59+
60+
The encrypted-decrypted-table has an action bar at the top with two buttons:
61+
* Clipboard button to copy the whole table as a CSV into the system clipboard
62+
* Trash button to clear the table
63+
64+
.. image:: ../img/desktop/decrypt-file-names.png
65+
:alt: Decrypt file names window
66+
:scale: 63%
67+
:align: center
68+
69+
Encrypted file names and their corresponding decrypted, original name are shown inside a two column table, with the encrypted names on the right.
70+
If you have not dropped any files, the table is empty.
71+
You can click inside the empty table to select files with a file picker dialog.
72+
73+
Once the table has content, you can select single cells and copy their content with the OS specific keyboard copy shortcut.
35 KB
Loading
Loading
-296 KB
Loading

source/index.rst

+1
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,7 @@ If you are interested in the security of Cryptomator, have a look at our :ref:`s
2525
desktop/accessing-vaults.rst
2626
desktop/password-and-recovery-key.rst
2727
desktop/vault-management.rst
28+
desktop/encrypted-file-names.rst
2829
desktop/volume-type.rst
2930
desktop/error-handling.rst
3031
desktop/sync-conflicts.rst

0 commit comments

Comments
 (0)