changeset 344:9f82ecc5a422

fingerprint
author Sebastien Jodogne <s.jodogne@gmail.com>
date Fri, 27 Mar 2020 07:26:16 +0100
parents fff45618262d
children f81b533a0fd0
files Sphinx/source/developers/repositories.rst
diffstat 1 files changed, 28 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/Sphinx/source/developers/repositories.rst	Thu Mar 26 18:42:31 2020 +0100
+++ b/Sphinx/source/developers/repositories.rst	Fri Mar 27 07:26:16 2020 +0100
@@ -77,6 +77,34 @@
 richer features than the Web interface.
 
 
+Note for Microsoft Windows
+..........................
+
+.. highlight:: text
+
+On Microsoft Windows, while cloning the repository, you might face an
+error similar to::
+
+  abort: error: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed (_ssl.c:661)
+
+In such a case, you must explicitly add the cryptographic fingerprint
+of our code server. To this end, edit the `configuration file
+<https://www.mercurial-scm.org/doc/hgrc.5.html#files>`__ of Mercurial
+(by default, ``%USERPROFILE%\Mercurial.ini``), and add the following
+lines::
+
+  [hostsecurity]
+  hg.orthanc-server.com:fingerprints=sha256:A1:75:3A:3F:20:74:C1:A6:C3:16:DD:EC:4C:67:74:C4:70:BE:E8:35:0A:0A:C7:2E:36:1F:49:8B:E2:60:61:73
+  
+.. highlight:: bash
+
+For reference, here is the command that was used to generate this
+fingerprint (`click here for more information
+<https://stackoverflow.com/a/56579497/881731>`__)::
+
+  $ openssl s_client -connect hg.orthanc-server.com:443 < /dev/null 2>/dev/null | openssl x509 -fingerprint -sha256 -noout -in /dev/stdin
+  
+
 Write access
 ^^^^^^^^^^^^