FTP API (macOS/OS X)

Pour le transfert de données entre votre ordinateur et le serveur Episerver, un mode chiffré est utilisé : le protocole Secure Copy (SCP). Le SCP protège vos données contre l’accès de tiers pendant le transfert. Pour travailler avec cette méthode chiffrée, vous devez disposer des éléments suivants :

  1. une paire de clés pour s’authentifier sur le serveur Episerver,
  2. un compte utilisateur pour accéder au serveur Episerver,
  3. l’application disponible gratuitement Cyberduck, pour établir une connexion avec le serveur Episerver.

Dans les quatre étapes suivantes, apprenez à configurer et utiliser le transfert de données chiffrées sous macOs (anciennement OS X).

Étape 1 : Créer une paire de clés

Pour créer une paire de clés pour l’authentification sur le serveur Episerver, procédez comme suit sous macOS :

  1. Ouvrez l’application Terminal, qui se trouve dans le répertoire Utilitaires de votre Mac.
  2. Saisissez : ssh-keygen. Confirmez votre saisie en appuyant sur la touche Entrée.

    Il vous sera demandé de choisir un emplacement de stockage et un nom de fichier pour la paire de clés.

  3. Indiquez un emplacement de stockage et un nom de fichier pour la paire de clés. Si vous souhaitez par exemple enregistrer la paire de clés sur votre bureau sous le nom key, procédez comme suit :
    /Users/<Nom de votre dossier Utilisateur>/Desktop/key

    Confirmez votre saisie en appuyant sur la touche Retour.

    Remarque:  Par défaut, le terminal propose le répertoire invisible .ssh dans votre dossier Utilisateur comme emplacement de stockage et le nom de fichier id_rsa. Si vous ne souhaitez apporter aucune modification personnelle, la paire de clés sera automatiquement enregistrée dans le répertoire invisible avec le nom de fichier proposé par défaut (la clé privée est créée sous le nom id_rsa, la clé publique est complétée par .pub). Le nom de fichier complet de la clé publique est alors id_rsa.pub.

    Conseil:  Nous vous recommandons de choisir votre bureau ou un répertoire comme emplacement de stockage, que vous créerez spécialement pour la paire de clés. Ainsi, vous trouverez rapidement la paire de clés sur votre ordinateur une fois les fichiers créés par le terminal.

    Conseil:  Si vous ne connaissez pas le nom de votre dossier Utilisateur, vous pouvez par exemple le trouver dans la barre des menus du Finder macOS en cliquant sur Aller à, puis Dossier Utilisateur. Le Finder s’ouvre alors dans une nouvelle fenêtre, dans laquelle le nom de votre dossier Utilisateur est inscrit dans la barre supérieure.

  4. Si la boîte de dialogue Enter passphrase apparaît, saisissez un mot de passe.

    Conseil:  Veuillez noter : lorsque vous saisissez un mot de passe, votre saisie ne s’affichera pas dans le terminal. Il ne s’agit pas d’une erreur, mais du comportement normal de l’application.

    Remarque:  Notez votre mot de passe. Vous en aurez besoin plus tard lorsque vous établirez une connexion avec le serveur Episerver.

    Il vous sera demandé de confirmer le mot de passe.

  5. Confirmez votre mot de passe et votre saisie en appuyant sur la touche Entrée.

    Vous avez créé avec succès une paire de clés sur votre emplacement de stockage saisi (par exemple, sur votre Bureau). La paire de clés comporte une clé privée et une clé publique. Vous pouvez identifier la clé privée à l’aide de l’extension .pub.

  6. Suite à la création de votre paire de clés, votre empreinte numérique de la clé s’affiche dans la fenêtre du terminal après la remarque The key fingerprint is:. Copiez votre empreinte numérique de la clé (il s’agit de la chaîne de caractères après The key fingerprint is:) dans un document texte et enregistrez-le.

    Vous avez désormais créé trois fichiers : le document texte contenant l’empreinte numérique de la clé, la clé privée et la clé publique.

Étape 2 : Configurer le compte utilisateur pour l’accès SCP

Pour accéder au serveur Episerver, vous avez besoin d’un compte utilisateur. Le service client Episerver le configure pour vous. Pour lui permettre de configurer votre compte utilisateur, procédez comme suit :

  1. Envoyez votre clé publique (le fichier se terminant par .pub) par e-mail à notre service client.
  2. Envoyez votre empreinte numérique de la clé dans un autre e-mail à notre service client.

Attention:  Envoyez toujours votre clé publique et votre empreinte numérique de la clé dans deux e-mails séparés. Pour des raisons de sécurité, vous ne devez jamais envoyer à notre service client les deux fichiers dans le même e-mail.

Une fois votre compte utilisateur configuré, le service client Episerver vous enverra par e-mail les données de votre compte utilisateur.

Étape 3 : Télécharger et installer Cyberduck

Lorsque votre compte utilisateur est configuré pour accéder à SCP sur le serveur Episerver, vous pouvez vous connecter au serveur Episerver à l’aide de l’application gratuite Cyberduck. Pour installer l’application Cyberduck sur votre Mac, procédez comme suit :

  1. Ouvrez le lien https://cyberduck.io.
  2. Pour télécharger la version Mac gratuite de Cyberduck, cliquez sur Download Cyberduck for Mac.

    Le téléchargement de Cyberduck démarre.

  3. Une fois le téléchargement terminé, naviguez dans le dossier Téléchargements dans lequel se trouve Cyberduck.
  4. Déplacez de préférence Cyberduck de votre dossier Téléchargements vers le répertoire dans lequel vous souhaitez l’enregistrer durablement, comme Applications ou Utilitaires.

    L’installation de Cyberduck est réussie.

Conseil:  Sous macOS, Cyberduck n’a besoin d’aucun processus d’installation supplémentaire. Après le téléchargement, l’application est prête à l’emploi.

Étape 4 : Établir une connexion SCP avec le serveur Episerver

Pour établir une connexion chiffrée via SCP avec le secteur Episerver et pour transférer vos données en toute sécurité, procédez comme suit :

  1. Ouvrez l’application Cyberduck.
  2. Cliquez sur le symbole plus en bas à gauche pour créer un nouveau signet pour la connexion avec le serveur Episerver.

    Une nouvelle fenêtre s’ouvre.

  3. Cliquez sur le menu de sélection et sélectionnez le type de connexion SFTP (connexion SSH).
  4. Indiquez dans le champ Nom un nom pour le signet.
  5. Saisissez dans le champ Serveur l’adresse ftpapi.campaign.episerver.net.
  6. Saisissez dans le champ Nom d’utilisateur votre nom d’utilisateur.

    Conseil:  Le service client vous a envoyé votre nom d’utilisateur après la configuration de votre compte utilisateur.

  7. Déroulez le point Options avancées en cliquant sur la flèche située à côté d’Options avancées.
  8. Activez l’option Utiliser l’authentification par clé publique en cochant la case correspondante.

    Une nouvelle fenêtre s’ouvre.

  9. Dans la nouvelle fenêtre, naviguez vers le répertoire dans lequel vous avez enregistré votre clé privée et sélectionnez cette dernière.

    Remarque:  Ne confondez pas la clé privée avec la clé publique. Pour l’option Utiliser l’authentification par clé publique, vous devez renvoyer à votre clé privée.

  10. Confirmez votre sélection en cliquant sur Sélectionner situé en bas à droite de la fenêtre.
  11. Fermez la fenêtre de configuration du signet en cliquant sur la croix rouge en haut à gauche.

    La fenêtre de configuration du signet se ferme. Vos modifications sont automatiquement enregistrées.

  12. Pour établir une connexion avec le serveur Episerver, double-cliquez sur le signet enregistré de la connexion avec le serveur Episerver.
  13. S’il vous est demandé de saisir votre mot de passe, saisissez le mot de passe que vous avez défini lors de la création de la paire de clés.

    Vous avez établi une connexion chiffrée avec le serveur Episerver avec succès et pouvez désormais échanger vos fichiers en toute sécurité.