Skip to content
Snippets Groups Projects
Commit 963f92bc authored by équipe  ALTO3's avatar équipe ALTO3
Browse files

bbe : précisions sur les versions openjdk testées. + mise en page

parent f30132a7
No related branches found
No related tags found
No related merge requests found
# Bienvenue sur l'espace Gitlab de l'application ALTO3 de la DGFiP.
......@@ -19,10 +18,12 @@ Le code source utilisé par ce module Testeur est le même que celui utilisé pa
Il est important de noter que **le contrôle du FEC se fait exclusivement sur le poste de l'utilisateur** : le module Testeur réalise les contrôles uniquement en local, et aucune connexion réseau n'est établie vers quelque serveur externe que ce soit.
## Caractéristiques techniques du module Testeur
* language Java
* Java Runtime Environment version 1.8+ uniquement
* Java Runtime Environment version 1.8+ uniquement, testé et fonctionnel également sous OpenJDK 13, 15 et 17
## Ressources mises à disposition
......@@ -34,35 +35,43 @@ Il est important de noter que **le contrôle du FEC se fait exclusivement sur le
* Méthodologie pour vérifier l'intégrité du fichier jar
### Guide utilisateur pour utiliser le module testeur
<wip>
/ travail en cours /
NB : dans le cadre du contrôle de conformité d'un fichier FEC fournit au format XML, la validité du XML sera testée au regard des fichiers descriptifs XSD prévus dans le cadre législatif. En cas de conformité aux fichiers XSD, alors le fichier FEC XML sera converti en fichier plat, pour ensuite être testé au regar de sa conformité dans le cadre du contrôle.
### Code source de l'application
<wip>
/ travail en cours /
### Fichier jar executable
<wip>
/ travail en cours /
### Condensat du fichier jar (fichier et ressource directement sur le gitlab) pour vérifier son intégrité
Voici le condensat SHA256 pour la version v<wip> du module Testeur : <SHA-256>
Voici le condensat SHA256 pour la version v<wip> du module Testeur : <insérer le SHA-256 de la version courante>
Le fichier contenant ce condensat est également disponible en téléchargement : <insérer le lien de téléchargement du fichier de condensat de la version actuelle>
Le fichier contenant ce condensat est également disponible en téléchargement : <lien de téléchargement du fichier de condensat de la version actuelle>
### Méthodologie pour vérifier la signature du fichier jar
Le fichier Jar executable mis à disposition sur la présente page est signé avec la clé privée de la DGFIP. Afin de vérifier la conformité de cette signature, la procédure suivante est proposée :
Utiliser l'utilitaire fournit par Java : **jarsigner**
(NB : jarsigner n'est pas installé par défaut avec Java Runtime Environment, il est donc nécessaire de se procurer préalablement la version adaptée à votre installation de java).
(NB : jarsigner n'est pas installé par défaut avec Java Runtime Environment, il est donc nécessaire de se procurer préalablement la version adaptée à votre installation de java).
Une fois jarsigner disponible dans votre environnement, à partir d'une fenêtre de commande (cmd), depuis le répertoire contenant le fichier Jar du testeur, exécuter la commande :
......@@ -86,20 +95,22 @@ jar verified.
Dans l'exemple présenté ci dessus, la commande indique "jar verified" qui atteste que le fichier téléchargé a bien été signé avec le certificat de la DGFIP.
### Méthodologie pour vérifier l'intégrité du fichier jar
Voici les méthodes qui peuvent être utilisées pour tester l'intégrité du fichier téléchargé, avant son execution, selon votre environnement.
NB : Hypothèse : le fichier "alto3-testeur-execSigned.sha256" contient une seule ligne contenant le sha256 du fichier jar mis à disposition.
##### Sous Linux
##### Sous Linux : bash
```bash
echo "$(cat alto3-testeur-execSigned.sha256) alto3-testeur-execSigned.jar" | sha256sum --check
```
##### Sous Windows : powershell :
##### Sous Windows : powershell
```powershell
(Get-FileHash 'alto3-testeur-execSigned.jar').Hash -eq (Get-Content alto3-testeur-execSigned.sha256)
```
......@@ -107,7 +118,8 @@ echo "$(cat alto3-testeur-execSigned.sha256) alto3-testeur-execSigned.jar" | sha
Si les condensats sont identiques, la commande retourne "True".
Si les condensats ne sont pas identiques, la commande retourne "False".
##### Sous Windows : batch :
##### Sous Windows : batch
La commande certutil ne permet pas de réaliser automatiquement la comparaison entre une clé générée et une clé fournie. La comparaison doit donc être "visuelle" :
```batch
certutil -hashfile 'alto3-testeur-execSigned.jar' SHA256
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment