Difference between revisions of "Document encryption"

From OpenKM Documentation
Jump to: navigation, search
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{TOCright}} __TOC__
 
{{TOCright}} __TOC__
  
Cryptography allows to plus documents protection in OpenKM. With cryptography extension can upload a new encrypted document, encrypt and decrypt existing document, edit and checkin encrypted document and download and decrypt encryted documents. In order making the cryptography process more secure are files are encrypted and decrypted in local user computer by a signed applet. That mean any networking file traffic is always with encrypted documents.
+
Cryptography allows for additional document protection in OpenKM. With the cryptography extension, one can upload a new encrypted document, encrypt and decrypt an existing document, edit and check in an encrypted document and download and decrypt encryted documents. In order to make the cryptography process more secure, files are encrypted and decrypted on the local user computer by a signed applet. That means any networking file traffic is always with encrypted documents.
  
  
All Cryptography options are available at tool menu:
+
All Cryptography options are available from the Tools menu:
  
  
Line 12: Line 12:
 
== Restrictions ==
 
== Restrictions ==
 
* Cryptography is only allowed in taxonomy view.
 
* Cryptography is only allowed in taxonomy view.
* Must have write privileges on document and folder to perfom cyptography operations.
+
* User must have write privileges on document and folder to perfom cyptography operations.
* For editing purpose, document might not be locked or checkout by other user.
+
* For editing purposes, the document should not be locked or checked out by another user.
 
 
  
 
== Description of different icon options ==
 
== Description of different icon options ==
Line 23: Line 22:
 
* [[File:Crypt_doc_decrypt.png]] → Download decrypted document
 
* [[File:Crypt_doc_decrypt.png]] → Download decrypted document
 
* [[File:Crypt_doc_decrypt_existing.png]] → Decrypt document
 
* [[File:Crypt_doc_decrypt_existing.png]] → Decrypt document
 
  
 
== Add new encrypted document ==
 
== Add new encrypted document ==
First must be selected some folder in taxonomy where user has write privileges to uploading a document. Then select the [[File:Crypt_doc_encrypt.png]] '''Add new encrypted document''' menu option. It'll appearing a crypt popup.
+
First select some folder in the taxonomy where you have write privileges to upload a document. Next, select the [[File:Crypt_doc_encrypt.png]] '''Add new encrypted document''' menu option. An encrypt popup will appear.
  
  
Line 32: Line 30:
  
  
Now simply put your cryptopharase twice, and select the file pressing the '''select file''' button. After it the document it'll be encrypted locally with cryptophrase and uploaded to OpenKM. When it process it'll be finished it'll appearing a successfully uploading popup message.
+
Now simply put your cryptopharase twice, and select the file to encrypt by clicking on the '''select file''' button. After that the document will be encrypted locally with the cryptophrase and then uploaded to OpenKM. When the process is finished, a popup message will appear indicating a successful upload.
  
  
Line 38: Line 36:
  
  
The OpenKM document explorer UI will be refreshing and will appearing the new document uploaded with the icon [[File:Crypt.png]] indicating that's a encrypted document.
+
The OpenKM document explorer UI will be refreshed and the newly uploaded document will appear with the cryptography icon [[File:Crypt.png]] indicating that it's an encrypted document.
  
  
Line 45: Line 43:
  
 
== Download decrypted document ==
 
== Download decrypted document ==
That operation downloads a encrypted document and decrypts it locally. First must selecting some encrypted document in OpenKM UI. Then selecting the [[File:Crypt_doc_decrypt.png]] '''Download decrypted document''' will appearing a decrypt remote OpenKM document popup.
+
This operation downloads an encrypted document and decrypts it locally. First select some encrypted document in OpenKM. Then select the [[File:Crypt_doc_decrypt.png]] '''Download decrypted document''' option and a popup will appear for decrypting the remote OpenKM document.
  
  
Line 51: Line 49:
  
  
Then must put decryptphrase and selecting the directory where you want to downloading the OpenKM document decrypted. Then OpenKM will download the encrypted document localy, decrypt and save. After it it'll appearing a information popup indicating the document has been saved localy.
+
Next, put the decryptphrase and select the directory where you want to download the decrypted version of the OpenKM document. OpenKM will then download the encrypted document to the local computer, decrypt and save. After that an information popup will appear indicating that the document has been saved locally.
  
  
Line 58: Line 56:
  
 
== Edit encrypted document ==
 
== Edit encrypted document ==
In order updating some encrypted document must be selected the [[File:Crypt_doc_checkout.png]] '''Edit crypted document''' menu option. It'll appearing a decrypt popup.
+
In order to edit an encrypted document, select the [[File:Crypt_doc_checkout.png]] '''Edit crypted document''' menu option. A decrypt popup will appear.
  
  
Line 64: Line 62:
  
  
Then must put decryptphrase and selecting the directory where you want to downloading the OpenKM document decrypted. Then OpenKM will download the encrypted document locally, decrypt and save. After it it'll appearing a information popup indicating the document has been saved locally.
+
Next, put the decryptphrase and select the directory where you want to download the decrypted version of the OpenKM document. OpenKM will then download the encrypted document to the local computer, decrypt and save. After that an information popup will appear indicating that the document has been saved locally.
  
  
Line 70: Line 68:
  
  
The OpenKM document explorer UI will be refreshing and will appearing the document marked for editing.
+
The OpenKM document explorer UI will be refreshed and the document will appear, marked for editing.
  
  
Line 76: Line 74:
  
  
== Checkin crypted document ==
+
== Check-in encrypted document ==
After making changes in local document ( decrypted using '''Edit encrypted document''' menu option ) must upload new document version to OpenKM repository. First will selecting the document that want to upload in OpenKM.
+
After making changes to the local document ( decrypted using '''Edit encrypted document''' menu option ), you must upload a new document version to the OpenKM repository. First select the document that you want to upload to OpenKM.
  
  
Line 83: Line 81:
  
  
Then will selecting the [[File:Crypt_doc_checkin.png]] '''Checkin encrypted document''' menu option. Will appearing a appearing a crypt popup.
+
Then select the [[File:Crypt_doc_checkin.png]] '''Checkin encrypted document''' menu option. An encrypt popup will appear.
  
  
Line 89: Line 87:
  
  
Now simply put your cryptopharase twice, and select the file pressing the '''select file''' button. After it the document it'll be encrypted locally with cryptophrase and uploaded to OpenKM. When it process it'll be finished it'll appearing a successfully uploading popup message.
+
Now simply put your cryptopharase twice, and select the file by clicking on the '''select file''' button. After that, the document will be encrypted locally with the cryptophrase and then uploaded to OpenKM. When the process is finished, a popup message will appear indicating a successful upload.
  
  
Line 95: Line 93:
  
  
The OpenKM document explorer UI will be refreshing and will appearing the document with major version.
+
The OpenKM document explorer UI will be refreshed and the document will appear as the latest version.
  
  
Line 101: Line 99:
  
  
{{Note|Cancelling checkin can be done with the normal '''cancel checkin''' button available in toolbar}}
+
{{Note|Cancelling checkin can be done with the normal '''cancel checkin''' button available in the toolbar}}
  
  
 
== Decrypt document ==
 
== Decrypt document ==
Decrypt document will decrypt some encrypted document in OpenKM and will replace for that decrypted version. For security purpose all previous encrypted document versions will be removed and replaced by decrypted document. Encrypted document will be downloaded and decrypted locally, then upload to OpenKM and purge version history.
+
Decrypt document will decrypt an encrypted document in OpenKM and will replace it will a decrypted version. For security reasons all previous encrypted document versions will be removed and replaced with the decrypted document. The encrypted document will be downloaded and decrypted locally, then uploaded to OpenKM and the version history purged.
  
  
First must selecting some encrypted document yet available at OpenKM.  
+
First select an encrypted document in OpenKM.  
  
  
Line 114: Line 112:
  
  
Then selection the [[File:Crypt_doc_decrypt_existing.png]] '''Decrypt document''' menu option. It'll appearing a decrypt menu popup.
+
Then select the [[File:Crypt_doc_decrypt_existing.png]] '''Decrypt document''' menu option. A decrypt popup will appear.
  
  
 
[[File:Okm_user_guide_220.jpeg|center]]
 
[[File:Okm_user_guide_220.jpeg|center]]
  
 
+
Next, put the decryptphrase and select the '''Decrypt file''' button. The encrypted document will be downloaded and decrypted locally and then uploaded to OpenKM, and version history will be purged too. An information popup will appear indicating that the operation was done sucessfully.
Then must put decryptphrase and selecting the '''Decrypt file button'''. The encrypted document will be downloaded and decrypted locally and then uploaded to OpenKM and history version will be purged too. I'll appearing a information popup indicating that operation has done sucessfully.
 
  
  
[[File:Okm_user_guide_221.jpeg‎|center]]
+
[[File:Okm_user_guide_221.jpeg?|center]]
  
  
The OpenKM document explorer UI will be refreshing and will appearing the document decrypted with major version and with history purged.
+
The OpenKM document explorer UI will be refreshed and the decrypted document will appear as the latest version, and with history purged.
  
  
Line 133: Line 130:
  
 
==Encrypt document ==
 
==Encrypt document ==
Encrypt document will encrypt some non encrypted document in OpenKM and will replace for that encrypted version. For security purpose all previous document versions will be removed and replaced by encrypted document. Openkm document will be downloaded and encrypted locally, then upload to OpenKM and purge version history.
+
Encrypt document will encrypt some unencrypted document in OpenKM and will replace it with the encrypted version. For security purposes all previous document versions will be removed and replaced with the encrypted document. The OpenKM document will be downloaded and encrypted locally, then uploaded to OpenKM and version history purged.
  
  
First must selecting some non encrypted document yet available at OpenKM.  
+
First select some unencrypted document in OpenKM.  
  
  
Line 142: Line 139:
  
  
Then selecting the [[File:Crypt_doc_encrypt_existing.png]] '''Encrypt document''' menu option. The document will be downloading locally, encrypted, uploaded to OpenKM and purge history version.
+
Then select the [[File:Crypt_doc_encrypt_existing.png]] '''Encrypt document''' menu option. The document will be downloaded locally, encrypted, uploaded to OpenKM, and version history purged.
  
  
Line 148: Line 145:
  
  
The OpenKM document explorer UI will be refreshing and will appearing the document encrypted with major version and with history purged.
+
The OpenKM document explorer UI will be refreshed and the encrypted document will appear as the latest version, and with history purged.
  
  

Latest revision as of 17:29, 29 November 2011

Cryptography allows for additional document protection in OpenKM. With the cryptography extension, one can upload a new encrypted document, encrypt and decrypt an existing document, edit and check in an encrypted document and download and decrypt encryted documents. In order to make the cryptography process more secure, files are encrypted and decrypted on the local user computer by a signed applet. That means any networking file traffic is always with encrypted documents.


All Cryptography options are available from the Tools menu:


Okm user guide 212.jpeg


Restrictions

  • Cryptography is only allowed in taxonomy view.
  • User must have write privileges on document and folder to perfom cyptography operations.
  • For editing purposes, the document should not be locked or checked out by another user.

Description of different icon options

  • Crypt doc encrypt.png → Add new encrypted document
  • Crypt doc encrypt existing.png → Encrypt document
  • Crypt doc checkout.png → Edit encrypted document
  • Crypt doc checkin.png → Checkin encrypted document
  • Crypt doc decrypt.png → Download decrypted document
  • Crypt doc decrypt existing.png → Decrypt document

Add new encrypted document

First select some folder in the taxonomy where you have write privileges to upload a document. Next, select the Crypt doc encrypt.png Add new encrypted document menu option. An encrypt popup will appear.


Okm user guide 213.jpeg


Now simply put your cryptopharase twice, and select the file to encrypt by clicking on the select file button. After that the document will be encrypted locally with the cryptophrase and then uploaded to OpenKM. When the process is finished, a popup message will appear indicating a successful upload.


Okm user guide 214.jpeg


The OpenKM document explorer UI will be refreshed and the newly uploaded document will appear with the cryptography icon Crypt.png indicating that it's an encrypted document.


Okm user guide 215.jpeg


Download decrypted document

This operation downloads an encrypted document and decrypts it locally. First select some encrypted document in OpenKM. Then select the Crypt doc decrypt.png Download decrypted document option and a popup will appear for decrypting the remote OpenKM document.


Okm user guide 216.jpeg


Next, put the decryptphrase and select the directory where you want to download the decrypted version of the OpenKM document. OpenKM will then download the encrypted document to the local computer, decrypt and save. After that an information popup will appear indicating that the document has been saved locally.


Okm user guide 217.jpeg


Edit encrypted document

In order to edit an encrypted document, select the Crypt doc checkout.png Edit crypted document menu option. A decrypt popup will appear.


Okm user guide 216.jpeg


Next, put the decryptphrase and select the directory where you want to download the decrypted version of the OpenKM document. OpenKM will then download the encrypted document to the local computer, decrypt and save. After that an information popup will appear indicating that the document has been saved locally.


Okm user guide 217.jpeg


The OpenKM document explorer UI will be refreshed and the document will appear, marked for editing.


Okm user guide 218.jpeg


Check-in encrypted document

After making changes to the local document ( decrypted using Edit encrypted document menu option ), you must upload a new document version to the OpenKM repository. First select the document that you want to upload to OpenKM.


Okm user guide 218.jpeg


Then select the Crypt doc checkin.png Checkin encrypted document menu option. An encrypt popup will appear.


Okm user guide 213.jpeg


Now simply put your cryptopharase twice, and select the file by clicking on the select file button. After that, the document will be encrypted locally with the cryptophrase and then uploaded to OpenKM. When the process is finished, a popup message will appear indicating a successful upload.


Okm user guide 214.jpeg


The OpenKM document explorer UI will be refreshed and the document will appear as the latest version.


Okm user guide 219.jpeg



Nota clasica.png Cancelling checkin can be done with the normal cancel checkin button available in the toolbar


Decrypt document

Decrypt document will decrypt an encrypted document in OpenKM and will replace it will a decrypted version. For security reasons all previous encrypted document versions will be removed and replaced with the decrypted document. The encrypted document will be downloaded and decrypted locally, then uploaded to OpenKM and the version history purged.


First select an encrypted document in OpenKM.


Okm user guide 219.jpeg


Then select the Crypt doc decrypt existing.png Decrypt document menu option. A decrypt popup will appear.


Okm user guide 220.jpeg

Next, put the decryptphrase and select the Decrypt file button. The encrypted document will be downloaded and decrypted locally and then uploaded to OpenKM, and version history will be purged too. An information popup will appear indicating that the operation was done sucessfully.



The OpenKM document explorer UI will be refreshed and the decrypted document will appear as the latest version, and with history purged.


Okm user guide 222.jpeg


Encrypt document

Encrypt document will encrypt some unencrypted document in OpenKM and will replace it with the encrypted version. For security purposes all previous document versions will be removed and replaced with the encrypted document. The OpenKM document will be downloaded and encrypted locally, then uploaded to OpenKM and version history purged.


First select some unencrypted document in OpenKM.


Okm user guide 222.jpeg


Then select the Crypt doc encrypt existing.png Encrypt document menu option. The document will be downloaded locally, encrypted, uploaded to OpenKM, and version history purged.


Okm user guide 223.jpeg


The OpenKM document explorer UI will be refreshed and the encrypted document will appear as the latest version, and with history purged.


Okm user guide 224.jpeg