Manuel D Utilisateur SFTP F
Manuel D Utilisateur SFTP F
Manuel D Utilisateur SFTP F
Version 11
Table des matires
8. Fichiers............................................................................... 19
8.1 Structure du nom des fichiers:.............................................19
8.2 Le fichier de dclaration (FI): ..............................................22
8.3 Le fichier de signature (FS) .................................................23
8.4 Le fichier GO .....................................................................24
8.5 Le fichier TD......................................................................24
2
1. Quest-ce que SFTP?
SFTP signifie SSH File Transfer Protocol ou Secure File Transfer Protocol.
Comme lindique la premire dfinition, SFTP fait partie de SSH ou Secure Shell. Il sagit
dun remplaant sr pour ltablissement dune session de terminal sur des machines
UNIX. SFTP est le composant de ce protocole SSH qui assure le transfert de fichiers.
Un client SFTP se comporte comme un client FTP classique, o vous avez une vue sur les
rpertoires et les fichiers, et o vous pouvez dposer, extraire des fichiers avec les
mmes commandes que FTP.
Contrairement FTP, les ordinateurs Windows ne disposent pas dun client standard.
Vous devez donc pour cela installer du software supplmentaire. Il existe des
clients software SFTP gratuits et payants. Les systmes Linux proposent des
packages standard dune implmentation open source de SSH (OpenSSH).
SFTP est toutefois un tout autre protocole que FTP. Il est en effet protg laide de
techniques cryptographiques, ce qui signifie que tout le trafic entre un client et
un serveur est entirement chiffr, depuis le processus didentification jusqu lenvoi
de fichiers. tant donn cette protection, SFTP convient trs bien lchange
scuris de fichiers sur linternet.
Tout comme le client, chaque serveur SFTP dispose galement dune paire de cls.
Lors de ltablissement dune connexion avec un serveur, celui-ci transmettra sa cl
publique (galement appele host key) au client. Cest alors lutilisateur final quil
appartient daccepter cette cl. partir de ce point, la connexion scurise peut tre
tablie et lutilisateur peut sidentifier.
3
2. Choisir votre certificat digital qualifi
Chaque fichier de dclaration que vous envoyez par SFTP doit tre accompagn dun
fichier de signature. Pour gnrer ce fichier de signature vous avez besoin dun certificat
digital qualifi.
Sur la base de votre certificat qualifi (extension .pfx ou .p12) et pour chaque
fichier de dclaration (FI), vous devrez crer un fichier de signature (FS) que vous
placerez sur le serveur SFTP avec le fichier de dclaration.
Il est important, lors du choix dun certificat digital qualifi, de tenir compte de la manire
dont vous comptez crer vos fichiers de signature (FS) :
Vous pouvez crer vous-mme votre fichier de signature, en utilisant par exemple
OpenSSL, ou utiliser des programmes que des producteurs de logiciels ou vous-mme
auraient dvelopp.
Procdure OpenSSL :
Si vous souhaitez crer le fichier de signature par le biais de OpenSSL, il est important de
demander un certificat votre prestataire de services de certification, partir duquel
vous pourrez ensuite exporter la cl prive. Ceci pose problme pour les certificats
figurant sur des cartes puce ou des cls USB.
En effet, la procdure dcrite dans la partie 10 Annexe : Gnrer un fichier de signature
(FS) via OPENSSL ne convient PAS aux certificats qui se trouvent sur une carte didentit
lectronique (eID) ou sur une carte Isabel. Dans la pratique, la procdure ne peut tre
utilise que pour des certificats mis par Globalsign et Certipost.
4
Apposer sa signature avec la carte didentit lectronique (eID) :
Si vous voulez crer un fichier de signature avec leID, vous pouvez utiliser lapplication
Belgian eID Signer ou une procdure avec Cryptonit. Vous trouverez lapplication
Belgian eID Signer et la procdure avec Cryptonit dans la bibliothque de documents
complmentaires (https://www.socialsecurity.be/public/doclibrary/fr/batch.htm). Vous
pouvez bien entendu dvelopper vous-mme les programmes ncessaires ou faire appel
des logiciels disponibles sur le march.
Les procdures avec lapplication Belgian eID Signer et avec Cryptonit exigent la
prsence du titulaire de leID. Pour chaque fichier de signature, leID devra tre
insre dans le lecteur de carte et le titulaire de leID devra saisir son code PIN. Par
consquent, si le titulaire de leID est absent et que vous devez crer un fichier de
signature pour lenvoi dun message structur, vous devrez utiliser une autre eID. Avant
lenvoi, votre gestionnaire local ou co-gestionnaire local devra alors charger la cl
publique de lautre eID dans les paramtres de votre canal sur le site portail.
Construire un fichier de signature sur base dune carte Isabel nest pas possible parce
que la cl prive ne peut pas tre export. Nous ne sommes donc pas en mesure de vous
fournir un manuel ou une technique pour le faire. Le helpdesk de chez Isabel ne sait pas
vous aider non plus.
5
3. Votre connexion internet
Pour transfrer rapidement et correctement des fichiers via SFTP, il est primordial de
disposer dune connexion internet de qualit.
Vous avez donc tout intrt vrifier depuis quel PC ou serveur le transfert seffectue le
mieux. vitez le chargement via une connexion internet sans fil. En effet, de petites
perturbations dans le rseau sans fil peuvent rompre le transfert de fichiers.
Contrlez galement les paramtres de votre pare-feu. Ce dernier doit autoriser le trafic
SFTP vers le port 8022.
Veillez aussi disposer dune bande passante suffisante durant le transfert. Dautres
processus en cours peuvent occuper la bande passante ncessaire au bon transfert via
SFTP.
Pour pouvoir communiquer avec notre serveur SFTP, vous avez besoin dun client SFTP.
Les systmes Linux proposent des packages standards dune implmentation open source
de SSH (OpenSSH).
Il existe galement plusieurs clients SFTP pour Apple. Vous pouvez les trouver par un
moteur de recherche et effectuer une recherche sur SFTP & Apple' ou sur le site
www.apple.com.
Documentation:
6
5. Crer votre paire de cls
Pour effectuer un envoi via SFTP, vous avez besoin dune paire de cls SSH. Vous devez
la crer vous-mme.
Dans certains clients SFTP est compris un gnrateur de cl.
Si le client que vous avez choisi ne dispose pas dun gnrateur de cl, vous devrez crer
les cls via un autre gnrateur de cls que vous pouvez trouver facilement via une
recherche sur internet. Le programme Putty Key Generator fonctionne trs bien. Vous
pouvez le retrouver en utilisant puttygen dans un moteur de recherche.
Votre cl publique doit tre charge lors de louverture du canal SFTP sur le portail de la
scurit sociale.
Votre cl prive doit tre charge dans le client SFTP que vous utilisez. Veuillez pour
cette action consulter la documentation de votre client SFTP. Il est conseill de protger
votre cl prive avec un mot de passe.
Spcifications:
Format
Une distinction est faite entre les cls qui sont compatibles avec la version 1 de SSH et
celles qui sont compatibles avec la version 2. La version 1 est considre comme peu
sre et ne sera pas accepte.
En plus il y a diffrents formats pour les cls publiques. Les plus courants sont ceux du
logiciel OpenSSH et SSH. (La mise en application commerciale de SSH-protocol).
Pour les cls publiques, les formats de OpenSSH et de SSH seront soutenus uniquement.
Bref rsum:
7
Exemple : cration des cls avec Putty Key Generator
2. Dterminez la longueur de la
cl
8
Sauvez les deux cls sur votre PC
9
6. Crer votre canal SFTP sur le portail de la scurit sociale
Ci-dessous, vous trouvez les diffrentes tapes que vous devez parcourir pour ouvrir
votre canal SFTP. Si vous disposez dj dun canal dexpdition pour la qualit ou si vous
avez eu pour la qualit un canal Isabel dans le pass vous ne devez pas parcourir
certains tapes.
10
Cliquez sur Enregistrement des
donnes de configuration(*)
Vu quil existe alors dj un utilisateur technique, vous ne verrez pas les deux crans
suivants.
11
Cliquez sur Suivant
12
Chargez ici votre cl publique SSH
(*) Si vous optez pour lutilisation de votre carte didentit lectronique (eID), vous
devez charger ici le certificat de signature de votre eID.
(**) Si vous disposez dj dun canal denvoi (FTP ou MQLink) pour la qualit et que
vous choisissez les mmes applications pour votre canal SFTP, vous devrez indiquer
un canal de prfrence par application.
13
Choisissez un nom dutilisateur technique (*)
(*) Si vous disposez dj dun canal FTP ou si vous avez cr un canal MQLink avec
dial-up, vous ne verrez pas cet cran et ne devrez donc pas choisir de nom
dutilisateur technique vu que le nom dutilisateur technique choisi pour FTP et/ou
MQLink reste dapplication pour SFTP.
14
Cliquez sur Confirmer
15
Vous avez besoin de votre
numro dexpditeur (*) dans
le nom de vos fichiers et vous
avez besoin de votre nom
dutilisateur pour vous
identifier sur le serveur SFTP.
(*) Si vous disposez dj dun canal denvoi (FTP ou MQLink) pour la qualit ou si
vous avez dj eu un canal Isabel dans le pass, vous conserverez toujours le
numro dexpditeur que vous aviez dj.
16
7. Paramtrer votre client SFTP
Pour faire la liaison entre le serveur SFTP de la scurit sociale (host) vous devez
introduire les donnes ci-dessous dans votre client SFTP (*).
(*) Pour installer votre client SFTP, rfrez-vous la documentation de celui-ci. titre
informatif, vous trouverez dans la bibliothque technique
(https://www.socialsecurity.be/public/doclibrary/fr/batch.htm) de la documentation sur
les clients SFTP manuels (Filezilla, WinSCP, Bitvise Tunnelier) que nous avons nous-
mmes tests.
Exemple:
17
Acceptez une fois la cl publique (host key) du serveur SFTP de la scurit sociale. Il
sagit de la cl publique du serveur : ssh-rsa 4096
9c:de:2d:42:b4:2e:2a:3b:b9:85:0d:79:98:66:d9:3f
Si vous avez protg votre cl prive par un mot de passe, on vous demande de
linscrire.
Ensuite, vous tes enregistr. Vous voyez gauche les rpertoires de votre pc et
droite, les rpertoires du serveur SFTP de la scurit sociale.
18
8. Fichiers
Une diffrence avec lenvoi via le canal Isabel, est que dans lenvironnement de
production pour SFTP (comme cest le cas pour FTP, MQlink et Webservice MTOM), ct
de votre fichier de dclaration (FI), vous devez ajouter un fichier GO et un fichier de
signature (FS) et les placer sur le serveur.
Le fichier de signature nest pas exig dans lenvironnement de simulation mais le fichier
GO, lui, est obligatoire.
Pour les messages structurs, les noms de fichiers ont la structure suivante :
FI.XXXX.123456.20120213.00001.R.1.1
FS.XXXX.123456.20120213.00001.R.1.1
GO.XXXX.123456.20120213.00001.R.1
(TD.XXXX.123456.20120213.00001.R.1)
19
Sixime partie du nom:
Indique l'environnement de travail:
R Utilis pour la production
T Utilis pour un test (DRS, DUC, Dimona, Chmage Temporaire) ou un test de
circuit DmfA
S Utilis pour un test de dclaration DmfA
Avec la DmfA, vous pouvez envoyer vos fichiers de test comme test de dclaration
(extension S et dossier INTEST-S) ou comme test de circuit (extension T et dossier
INTEST). Pour toutes les autres applications, vous pouvez utiliser uniquement l'extension
T et le dossier INTEST pour vos fichiers de test.
Lors d'un test de dclaration (extension de fichier S), tous les contrles de rception
et tous les contrles de contenu sont parcourus. Il n'y a pas de contrle des donnes
d'identification du/des travailleur(s). Aprs un ACRF positif, vous recevez une notification,
mais pas de fichier DMNO ou PID. Vous placez vos fichiers dans le dossier INTEST-S et
vous trouvez le rsultat dans le dossier OUTTEST-S. tant donn que la dclaration n'est
pas sauvegarde dans l'environnement de simulation, vous pouvez tester plusieurs fois la
mme dclaration.
Lors d'un test de circuit (extension de fichier T), le circuit de contrle entier est
parcouru comme dans l'environnement de production. Il y a un contrle des donnes
d'identification du/des travailleur(s),mais pas de contrle d'identification via Sigedis.
Aprs un ACRF positif, vous recevez les fichiers de rponse comme dans l'environnement
de production (notifications, PID et DMNO).
Vous placez vos fichiers dans le dossier INTEST et vous trouvez le rsultat dans le
dossier OUTTEST.
En cas de notification positive, la dclaration est sauvegarde dans l'environnement de
simulation. Tout comme dans l'environnement de production, le test de circuit est limit
une dclaration accepte par combinaison numro ONSS/trimestre.
20
Exemples:
FI.DMFA.123456.20120213.00001.R.1.1
FS.DMFA.123456.20120213.00001.R.1.1
GO.DMFA.123456.20120213.00001.R.1
FI.DMFA.123456.20120213.00001.R.2.1
FI.DMFA.123456.20120213.00001.R.2.2
FS.DMFA.123456.20120213.00001.R.2.1
FS.DMFA.123456.20120213.00001.R.2.2
GO.DMFA.123456.20120213.00001.R.2
21
8.2 Le fichier de dclaration (FI):
Les fichiers de dclaration (FI) sont identiques pour tous les canaux.
Sur la page de dpart de chaque application sur le portail de la scurit sociale dans la
librairie technique, vous trouvez toutes les informations techniques (glossaires, les
schmas, les annexes structures et les instructions) pour faire votre fichier de
dclaration.
22
8.3 Le fichier de signature (FS)
Vous pouvez crer votre fichier de signature (FS) vous-mme, via par exemple,
OpenSSL(*) ou vous pouvez utiliser un programme dune maison de soft ou le
dvelopper vous-mme.
Pour OpenSSL(*), il est important que votre certificat ne se trouve pas sur une carte
puce ou une cl USB pour que vous puissiez exporter la cl prive.
Si vous voulez crer un fichier de signature avec leID, vous pouvez utiliser
lapplication Belgian eID Signer ou une procdure avec Cryptonit.
Lapplication et la procdure se trouvent dans la bibliothque de documents
complmentaires: (https://www.socialsecurity.be/public/doclibrary/fr/batch.htm).
Pour crer votre fichier de signature vous devez utiliser le certificat digital qualifi
(.pfx ou .p12) dont vous avez charg la cl publique (.cer) sur le portail de la scurit
sociale lors de la cration de votre canal SFTP.
(*) Vous trouverez les explications concernant la cration dun fichier de signature
avec OpenSSL la fin de ce manuel au point 10 Annexe: Gnrer un fichier de
signature avec OpenSSL.
23
8.4 Le fichier GO
Est le signal que lexpditeur a plac ses fichiers et que le traitement de ces
fichiers peut commencer.
Doit toujours tre plac aprs les fichiers FI et FS comme dernier fichier dans le
dossier IN, INTEST ou INTEST-S.
Lors dune dclaration en plusieurs parties (FI), un seul fichier GO est joint.
Pour crer un fichier GO, vous devez ouvrir un fichier vide (par exemple un fichier texte)
et le sauvegarder sous le nom de fichier correct.
8.5 Le fichier TD
Sert indiquer que les fichiers FI et/ou FS placs ne peuvent pas tre traits
(TD = To Delete). Un fichier TD peut donc tre utilis si les fichiers placs
contiennent une erreur.
Doit toujours tre plac aprs les fichiers FI et FS comme dernier fichier dans le
dossier IN, INTEST ou INTEST-S.
Lors dune dclaration en plusieurs parties (FI), un seul fichier TD est joint.
Pour crer un fichier TD, vous devez ouvrir un fichier vide (par exemple un fichier texte)
et le sauvegarder sous le nom de fichier correct.
24
9. Transfrer vos fichiers
Ouvrez dans votre client SFTP le rpertoire dans lequel vous souhaitez placer vos fichiers.
Dans cet exemple, nous allons ouvrir le rpertoire INTEST pour dposer nos fichiers
Ensuite nous glissons les diffrents fichiers (FI, FS et GO) vers le rpertoire INTEST.
Comme le fichier GO lance le traitement toujours le glisser en dernier dans le
rpertoire.
25
Ds que le fichier GO est plac, le traitement des fichiers lis dmarre automatique.
26
Ds que les dclarations sont traites, vous retrouvez les rponses (ACRF, Notifications.)
dans les rpertoires respectifs :
Le rcpiss ou ACRF est un message qui prouve que nous avons reu votre fichier et
que celui-ci rpond aux conditions.
Un rcpiss positif signifie que votre fichier peut tre trait. Dans ce cas, vous
recevrez aussi une notification, plus tard, dans le mme rpertoire, avec le rsultat du
contrle du contenu de votre dclaration.
27
Nous glissons les ACRF vers notre PC
Une fois que les fichiers ont t copis sur notre ordinateur nous devons les
supprimer sur le serveur SFTP.
Ensuite, les fichiers peuvent tre ouverts et traits sur notre ordinateur mme.
Pour SFTP, les fichiers de rceptions sont mis votre disposition dans les rpertoires
OUT, OUTTEST ou OUTTEST-S sur notre serveur.
Le but est que vous copiez les fichiers qui sont sur notre serveur vers un
endroit sur votre PC. Ensuite, une fois copi, vous supprimez les fichiers des
rpertoires OUT sur notre serveur.
Etant donn que nous devons prvoir de lespace pour tous les expditeurs, nous ne
pouvons pas garder les fichiers disposition de manire indtermine.
28
10. Annexe: Gnrer un fichier de signature avec OpenSSL :
Attention :
Cette procdure ne convient PAS aux certificats qui se trouvent sur une carte didentit
lectronique (eID) ou une carte Isabel. Dans la pratique, cette procdure ne peut tre
utilise que pour des certificats mis par Globalsign et Certipost.
Pour crer un fichier de signature avec OpenSSL il faut d'abord installer ce software sur le
PC sur lequel vous allez crer le fichier de signature.
Via un moteur de recherche, vous pouvez rechercher trs simplement OpenSSL.
Aprs l'installation, le mieux est que vous fabriquiez un rpertoire sur votre PC dans
lequel vous installerez votre certificat (format .pfx place ou .p12) et votre fichier de
dclaration (FI).
Nous allons crer un fichier .pem, un fichier .key et un fichier de signature (FS).
Nous choisissons dans notre exemple de donner le nom dmfa, au fichier .pem et au
fichier .key. Cette dnomination est un libre choix. Vous pouvez choisir le nom vous-
mme et mme si vous choisissez le nom dmfa vous pouvez lutiliser pour signer les
fichiers pour les autres applications.
29
Il est important de taper dans DOS les commandes correctes et les bons liens vers les
rpertoires.
1. Ouvrez une fentre dos. Allez sur Start et cliquez sur Run
2.
3. Tapez cmd et cliquez sur ok
4. Ensuite vous devez aller vers C-prompt (c--d une ligne ou vous navez que C:\>)
Pour y arriver vous devez taper plusieurs fois cd.. suivi de la touche [ENTER]
C:\>
5. Ouvrez le rpertoire OpenSSL via la commande cd openssl puis cliquez sur [ENTER]
C:\>cd openssl
30
5. Ouvrez le sous-rpertoire bin via la commande cd bin puis cliquez sur [ENTER]
C:\OpenSSL>cd bin
C:\OpenSSL\bin>openssl
OpenSSL>
Aprs ce prompt vous devez introduire la commande pour crer le fichier .pem.
Attention, vous devez ici utiliser votre certificat format .pfx ou .p12 et non pas la cl
publique du certificat (.cer).
Votre fichier.pem est cr et plac dans le rpertoire o votre certificat et votre fichier de
dclaration sont placs.
OpenSSL> pkcs12 -in C:\DEMOSIGN\certif.pfx -passin pass:ww123 -out
C:\DEMOSIGN\dmfa.pem -clcerts nokeys
MAC verified OK
31
8. Vous pouvez maintenant crer votre fichier .key
Vous introduisez la commande suivante dans le prompt OpenSSL :
pkcs12 -in Localisation de votre rpertoire\votre certificat-passin pass:Mot de passe
de votre certificat-passout pass:mot de passe que vous choisissez pour votre .KEY -out
Localisation de votre rpertoire\Nom de votre fichier.KEY puis cliquez sur [ENTER]
Votre fichier.key est cr et plac dans le rpertoire o votre certificat, votre fichier de
dclaration et votre fichier .pem sont placs.
Chaque fois que vous voulez envoyer un fichier FI, vous devez crer sur base du fichier FI
avec les fichiers .pem et .key un fichier FS.
Vous pouvez utiliser les fichiers .pem et .key pendant toute la validit du certificat (voir
Expiration Date de votre certificat). Une fois que votre certificat est prim, vous devez
charger un nouveau certificat pour le canal et vous devez crer des nouveaux fichiers
.pem et .key.
32
9. Vous pouvez maintenant crer votre fichier de signature
Votre fichier FS est cr dans le rpertoire avec votre certificat et votre fichier de
dclaration.
Attention: ds que vous avez cr votre fichier FS vous ne pouvez plus changer votre
fichier FI. Si vous modifiez encore votre fichier FI vous devez recrer un nouveau fichier
FS.
33
10. Les adaptations manuelles de votre fichier FS
Avant denvoyer votre fichier, il y a encore quelques adaptations manuelles faire dans le
fichier FS.
Vous ouvrez le fichier FS avec un diteur de texte comme Textpad ou Notepad.
Vous supprimez la premire ligne (-----DBUT PKCS7----- ) ainsi que la dernire ligne (--
---END PKCS7-----).
Attention : le fichier FS ne peut pas contenir de lignes vierges la fin du texte
(supprimez ventuellement le retour chariot).
34
Voici le rsultat de votre fichier FS
35
11. Questions
Le centre de contact peut vous fournir de laide et des informations lors de louverture de
votre canal SFTP.
Accessible au:
( 02/545.50.78
: batch@eranova.fgov.be
Heures d'ouverture :
De lundi jusqu'au vendredi, sauf les jours fris
Ouvert de 7h 20h
Votre gestionnaire de dossier lONSSAPL peut vous fournir de laide et des informations
lors de louverture de votre canal SFTP. Vous pouvez galement vous adresser au:
( 02/239.14.07
: dmfappl@onssapl.fgov.be
36