SFTP – Instructions de configuration

TABLE DES MATIÈRES

• SFTP – Instructions de configuration
  • Hébergement et authentification
  • Configuration
  • Fréquence et planification
  • Rapports et gestion des erreurs
    • FAQ connexes
  • Comment créer une clé SSH publique pour le serveur SFTP
    • Format
    • Modèle
    • Création de clés SSH
    • Clé d’exemple
  • Instructions pour des types d’enregistrements spécifiques

Hébergement et authentification

Nous hébergeons votre dossier SFTP sur un serveur SFTP dédié (via AWS). Chaque client dispose d’un compte utilisateur unique avec un accès direct à son dossier SFTP spécifique. Nous prenons en chargel’authentification par clé. Par conséquent, vous devrez créer une paire de clés publique-privée et saisir la clé publique dans le champClé publique lors de la configuration de votre dossier. La clé doit être au formatopenSSH RSA. Pour créer les clés, consultezComment créer une clé SSH publique pour le serveur SFTPci-dessous.

Configuration

1. Saisissez la clé publique que vous avez créée dans le champClé publique. Vous pouvez également modifier le champ Nom d’utilisateur. La valeur du champ Nom d’utilisateur doit commencer par une lettre, un chiffre ou un trait de soulignement et comporter entre 3 et 100 caractères. Elle peut contenir des lettres, chiffres, traits de soulignement, arobase (@), points (.) et traits d’union (-).

2. Copiez les valeursNom d’utilisateur,URL du domaine Spotnana etNuméro de port dans un endroit sécurisé, car elles seront nécessaires plus tard à l’équipe de votre organisation qui configurera l’envoi de fichiers vers le nouveau dossier créé.
   Remarque : Une fois la configuration du dossier SFTP terminée, ces valeurs seront de nouveau accessibles sousGérer.

3. Saisissez l’adresse ou les adresses courriel où vous souhaitez recevoir les rapports sur vos téléversements de fichiers dans le champNotification SFTP par courriel. Pour plus de détails, consultezRapports et gestion des erreursci-dessous.

4. Cliquez surConnecter.

Une fois qu’une clé publique a été ajoutée, le statut initial seraNon vérifié. Ce statut sera affiché dans l’OBT jusqu’à ce qu’un fichier soit effectivement reçu dans le dossier. Le fichier envoyé peut être un fichier test de votre choix ou un véritable flux RH ou fichier de champ personnalisé (seuls les fichiers dans des formats pris en charge seront traités). De plus, si la clé publique est modifiée par la suite, le statut sera réinitialisé àNon vérifié jusqu’à la réception du prochain fichier.

Pour supprimer votre dossier SFTP, cliquez surDéconnecter. Cela supprimera votre dossier SFTP. Si vous devez le configurer de nouveau plus tard, vous devrez saisir à nouveau toutes les informations décrites ci-dessus depuis le début.

Fréquence et planification

Vous déterminez la planification et la fréquence des téléversements de fichiers. Nous utilisons le déclencheur de création d’objet de fichier pour lancer le traitement. Cela signifie qu’aussitôt que vous déposez un fichier dans votre dossier sur notre serveur SFTP, notre application commence à traiter le téléversement.

Pour des recommandations sur la fréquence et la planification propres à chaque type d’enregistrement (par exemple, utilisateurs, champs personnalisés, entités juridiques), consultez la section Fréquence et planification dans les instructions SFTP pour chaque type d’enregistrement.

Rapports et gestion des erreurs

Nous recueillons des informations sur vos fichiers téléchargés afin de générer un rapport interne après chaque envoi. Ce rapport est ensuite envoyé à l’adresse courriel que vous avez indiquée lors de la configuration.SFTP email notificationPour chaque fichier téléchargé, le rapport comprendra les informations suivantes :

• toutes les raisons pour lesquelles un téléversement de fichier a échoué (mauvais format, noms de colonnes manquants, etc.).

• toutes les raisons pour lesquelles une ligne dans un fichier n’a pas pu être téléversée. Nous n’effectuons pas de mises à jour partielles et la ligne échouera si une erreur survient dans une colonne précise ou si un champ requis est manquant pour cette ligne.

• le statut du téléversement (en attente, réussi, échoué).

Vous pouvez utiliser le contenu de ce fichier pour résoudre les erreurs. Si vous ne parvenez pas à corriger l’erreur, communiquez avec l’assistance technique.

FAQ connexes

1. Acceptons-nous un fichier incrémentiel qui ne contient que les enregistrements à mettre à jour ou à ajouter ?

   • Oui

2. Le fichier que vous téléversez (que ce soit par SFTP ou par téléversement manuel) doit-il inclure les colonnes optionnelles même si vous ne les utilisez pas ?

   • Non

Comment créer une clé SSH publique pour le serveur SFTP

Suivez les instructions ci-dessous pour créer la clé SSH publique à nous transmettre.

Format

• Type : chaîne de caractères

• Contraintes de longueur : longueur maximale de 2048 caractères.

Motif

 ^ssh-rsa\s+[A-Za-z0-9+/]+[=]{0,3}(\s+.+)?\s*$

Création de clés SSH

Pour créer des clés SSH, exécutez la commande suivante dans l’invite de commandes sous Windows ou dans le terminal sous macOS, Linux ou UNIX :

ssh-keygen -t rsa -b 4096 -f key_name

Où

• -t correspond au type de chiffrement

• -b correspond à la longueur de la clé (en bits)

• -f correspond au nom de la clé

Clé d’exemple

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDDJB9oBRPrBegMDPEQo+HmNDb/jKUJL6q2kQpNNMDjNps9mhhwJ1dP/lOavMitBPAndeXlwaNEm2XbGaSrZtD/tbQTX1HQjP6pacy+Alf8kYBm5QFfl/Z6lGC8qHys10fpRXgYE7UhdSv6VyRqt1gELGFQwVBZ2kJJuBGJF1IRywwvG/h68B8iWU1+6KEWYQoUcT45r3j3otnx4NhhzpTiNgDbMk0ix+kar4/IstobRLcb7rt7FoUerTLNrVDi69DqbsGY5LN+NM8jVx0sPQLRC/ruil8pTHP3k4rDCc7a80+sH4sUTW+mHc7MTqbi/CcyyFAD8h7p6WqxEydOaJjMnvqAbE17BOj0TSxv3HMohTf3skzE7PbzVcjIfHTpFPGxmJkghAYAMi5l9VvAs91IpVylxjqPss3xQQJIZEmQdG2k7zk/UpsUFlmaOj6lCHRicFKCixKekzzm3nFuJvDEklurtydOQjZ8WkPzTSJfZBdKMuMUi0SQ9m9ZAw99t0=

Instructions pour des types d’enregistrements spécifiques

Pour obtenir des instructions détaillées sur le téléversement de certains types d’enregistrements via SFTP, veuillez consulter les sujets suivants selon le type d’enregistrement :

• Flux RH (utilisateurs)
• Champs personnalisés
• Bureaux
• Entités juridiques