changeset 193:99ba212989cc

Added entry related to MD5 integrity file checking
author bgo-osimis
date Sun, 03 Feb 2019 14:44:14 +0100
parents 14735c696623
children d4c0b7c25126
files .hgignore Sphinx/source/faq/troubleshooting.rst
diffstat 2 files changed, 17 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/.hgignore	Sat Feb 02 17:39:00 2019 +0100
+++ b/.hgignore	Sun Feb 03 14:44:14 2019 +0100
@@ -1,2 +1,3 @@
 Sphinx/build
-Sphinx/env
\ No newline at end of file
+Sphinx/env
+.vscode/
--- a/Sphinx/source/faq/troubleshooting.rst	Sat Feb 02 17:39:00 2019 +0100
+++ b/Sphinx/source/faq/troubleshooting.rst	Sun Feb 03 14:44:14 2019 +0100
@@ -108,6 +108,21 @@
   CMake
   <https://bitbucket.org/sjodogne/orthanc/src/default/LinuxCompilation.txt>`__.
 
+Checking DICOM file integrity
+-----------------------------
+Orthanc stores, in its database, an `MD5 hash <https://en.wikipedia.org/wiki/MD5>`_ of the DICOM file contents.
+
+This MD5 corresponds to the hash of the DICOM file in memory, before it is written to the disk by Orthanc. This information is safely stored inside the database for any incoming DICOM file (provided that the ``StoreMD5ForAttachments`` configuration option is set to ``true``).
+
+It ispossible to ask Orthanc to check by itself whether the DICOM file was corrupted (i.e. to check whether the MD5 hash stored in the database corresponds to the hash of the file on the disk):
+
+``curl -X POST http://localhost:8042/instances/f257b066-f3992cc4-ca6a5e5f-3f8dcf3a-d4958939/attachments/dicom/verify-md5 -d ''``
+
+This MD5 may be different if errors occurred while the DICOM file was initially written to the storage, or if the file contents were tampered with afterwards.
+
+You can retrieve the stored MD5 hash of a DICOM instance as follows:
+
+``curl http://localhost:8042/instances/f257b066-f3992cc4-ca6a5e5f-3f8dcf3a-d4958939/attachments/dicom/md5``
 
 Windows-specific issues
 -----------------------