FAQ.md

-# FAQ
-
-## Erreurs communes
-
-### Warnings/Erreurs SSL
-
-Si vous obtenez le warning ou l'erreur suivant lorsque vous<br/>pullez/pushez :
-
-    warning: forge.univ-lyon1.fr certificate with fingerprint <fingerprint> not verified 
-
-ou
-
-    abort: error: _ssl.c:507: error:14090086:SSL routines:SSL3_GET_SERVER_CERTIFICATE:certificate verify failed
-
-Ajoutez le code suivant dans votre fichier ~/.hgrc sous Linux/Mac OS X;
-ou mercurial.ini dans le répertoire utilisateur sous windows (accessible
-également via l'explorateur de fichiers: clic-droit -&gt; ToirtoiseHg
--&gt; Global Settings, puis cliquer sur Editer le fichier):
-
-    [hostfingerprints]
-    forge.univ-lyon1.fr = a0:3c:b0:22:ee:72:36:83:a0:c2:ec:39:c8:db:a5:af:6c:05:d0:27
-
-Plus d'infos
-[ici](http://mercurial.selenic.com/wiki/CACertificates#Host_certificate_fingerprints)
-
-Valeur courante du finger print (depuis le 20/12/2016):
-
-    a0:3c:b0:22:ee:72:36:83:a0:c2:ec:39:c8:db:a5:af:6c:05:d0:27
-
-Ancien fingerprint (non valable)
--
-
-    da:77:4e:a7:f1:45:94:da:3b:64:ca:d9:c5:e2:13:fd:44:1b:e0:49
-
--
--
+# Erreurs communes
+
+## Erreur de certificat
+
+Il se peut que le certificat SSL ne soit pas reconnu sur votre machine, erreur du type:
+```
+server certificate verification failed. 
+```
+
+Dans ce cas il faut:
+1. récupérer le certificat du serveur [forge.univ-lyon1.fr.crt](./files/Wiki/FAQ/forge.univ-lyon1.fr.crt) directement ou via la commande (sous Linux / Mac OS X)
+   ```
+   echo | openssl s_client -connect forge.univ-lyon1.fr:443 2>/dev/null| grep -e '-----BEGIN CERTIFICATE-----' -A 30 > forge.univ-lyon1.fr.crt
+   ```
+2. Vérifier que c'est le bon certificat via `md5` ou `md5sum`:
+   ```
+   md5sum forge.univ-lyon1.fr.crt
+   ```
+   et obtenir l'une de ces deux sommes de contrôle:
+   ```
+   0f2fd35648d768171a0299384c869cbc
+   8b6200a66080a9ac010910653d2884d5
+   ```
+3. Placer ce fichier dans un répertoire, par exemple `$HOME/.git-certs/`
+4. Configurer git pour utiliser les certificats de ce répertoire:
+   ```
+   git config --global --add http.sslcapath $HOME/.git-certs/
+   ```
+
+Remarques: 
+* la configuration de git peut également être locale à un dépôt (en ne mettant pas `--global`)
+* le nom `forge.univ-lyon1.fr.crt` n'est pas important ici
+* il est possible de placer plusieurs fichier certificats dans le répertoire `$HOME/.git-certs/`
+
+Référence: https://git-scm.com/docs/git-config#git-config-httpsslCAPath
\ No newline at end of file
-
-    99:6e:d1:3a:6a:91:53:d8:82:8d:26:df:b4:d0:5c:59:5d:9f:b4:75
-
--
--
-
-    28:63:ad:2e:59:49:4b:f6:6c:3c:14:e8:2f:9f:11:47:d1:dc:ec:f7
-
--
-
-Si vous avez oublié de changer le finger print, mercurial affichera un
-message du type "unexpected fingerprint"
-
-### HTTP Error 413: Request Entity Too Large
-
-Vous essayez d'envoyer un fichier trop gros (&gt; 5Mo), ou bien
-l'ensemble des modifications à *pusher* depuis votre dépôt local
-mercurial est trop gros (&gt; 2Mo). Dans le dernier cas cela peut être
-du à de trop gros fichiers committés.
-
-Cette limite est volontaire et les gros fichiers n'ont normalement pas
-vocation à être versionnés dans la forge. D'autres solutions comme les
-solutions de stockage dans le *cloud* sont plus adaptées à ces cas de
-figure.
-
-### HTTP Error 502
-
-Il arrive parfois qu'un erreur 502 se produise sur un pull ou un push.
-Il s'agit d'un bug dont la cause reste encore difficile à identifier.
-Ce bug est lié à la présence de nouvelles branches, en général parce que
-deux développements ont été faits de manière concurrente.
-En attendant qu'une solution soit trouvée, il est possible de procéder
-comme suit (en supposant que la copie de travail locale soit un
-répertoire `/chemin/vers/A` et que l'id du projet soit `p1234567-A`):
-
-    cd /tmp
-    hg clone https://forge.univ-lyon1.fr/hg/p1234567-A B
-    cd B
-    hg pull /chemin/vers/A
-    hg merge
-    # resoudre les conflits éventuels
-    hg commit -m 'fusion avec xxx'
-    hg push
-
-### Vérifications à faire en cas d'erreur 'authentification' lors d'un clone
-
-Vérifications sur votre compte forge (via l'interface Web de la forge)
-
--   Votre identifiant commence par p ou x en minuscule
--   Votre *mode d'authentification* est **LDAP UCBL** et pas ~~Interne~~
-
-Si vous avez créé votre compte informatique UCBL ou modifié votre mot de
-passe (via Sesame) fin août / début septembre 2016, reconnectez vous sur
-https://sesame.univ-lyon1.fr/ et rechanger votre mot de passe.
-
-Si après avoir fait ces modifications (ou 24h après avoir fait le
-changement de mot de passe si applicable) vous avez toujours des erreurs
-d'authentification, laissez un
-[ticket](http://forge.univ-lyon1.fr/projects/forge/issues/new) ou
-envoyer un mail à emmanuel.coquery@univ-lyon1.fr