diff --git a/docs/code_form/phileas/99_faq.md b/docs/code_form/phileas/99_faq.md index 38b81bdc..84916458 100644 --- a/docs/code_form/phileas/99_faq.md +++ b/docs/code_form/phileas/99_faq.md @@ -1,59 +1,8 @@ # F.A.Q -## Erreurs de connexion -### Lorsque je veux me connecter, on me dit que ma clé n'est pas protégée -Si, lors d'une connexion SSH, vous obtenez un message similaire à : -```bash -@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ -@ WARNING: UNPROTECTED PRIVATE KEY FILE! @ -@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ -Permissions 0777 for '/home/xx/.ssh/phileas_key' are too open. -It is required that your private key files are NOT accessible by others. -This private key will be ignored. -Load key "/home/xx/.ssh/phileas_key": bad permissions -xxxxx@bastion.phileas.ec-nantes.fr: Permission denied (publickey). -Connection closed by UNKNOWN port 65535 -``` -Cela signifie que les permissons de votre clé privée `phileas_key` sont trop ouvertes, et SSH refusera de l'utiliser pour se connecter à Phileas. Pour régler ce problème, sous Linux, effectuez la commande suivante sur votre clé privée (ajustez l'emplacement de la clé si vous n'avez pas utilisé l'emplacement préconisé) : -```bash -chmod 0600 ~/.ssh/phileas_key -``` -et retentez le SSH. - -### Je n'arrive pas à me connecter, j'ai simplement un message d'erreur "Permission denied" -Cette erreur est malheureusement très générique et peut avoir plusieurs causes différentes. Testez les étapes suivantes avant d'ouvrir un ticket support MesoNET. - -#### Mon certificat est-il invalide ? -Inspectez votre certificat avec la commande : -```bash -ssh-keygen -L -f ~/.ssh/phileas_key-cert.pub -``` -Dans le résultat, vérifiez que la date d'expiration du certificat n'est pas passée (appelé 'Valid' dans le certificat), que le nom d'utilisateur (appelé 'principal') est correct, et que les adresses IP intégrées (appelées 'source-address') correspondent bien à celles que vous avez indiqué sur https://auth.phileas.ec-nantes.fr . **Notez que l'adresse IP 130.66.159.6/32 est nécessaire pour fonctionner, et n'apparaît pas dans la boîte de dialogue de saisie d'adresse**. - -``` -Type: ssh-ed25519-cert-v01@openssh.com user certificate -Public key: ED25519-CERT SHA256:UdLlHCFe008eXtSiSFKAt8DPR6uRDAZRhdwwN7Zvr8g -Signing CA: ED25519 SHA256:S9GJbecpkIwhdEDY1iLOIrZxPZGKqQOJ9eP+sWfqVec (using ssh-ed25519) -Key ID: "pbondial@ec-nantes.fr-external" -Serial: 2712428235499462096 -Valid: from 2024-11-13T15:48:33 to 2024-12-13T15:49:03 -Principals: - pbondial@ec-nantes.fr -Critical Options: - source-address 130.66.120.1/32,130.66.159.6/32 -Extensions: - permit-X11-forwarding - permit-agent-forwarding - permit-port-forwarding - permit-pty -``` - -#### Ma configuration SSH est-elle bonne ? -Vérifiez que votre bloc de configuration SSH relatif à Phileas ne comporte pas d'erreur (pas de chemin de clé erroné, pas de modification du nom d'utilisateur, etc.) - -#### Je n'arrive toujours pas à me connecter -Ouvrez un ticket de support MesoNET pour Phileas. - +## Erreurs sur le portail Phileas +### Mon répertoire home n'existe pas +Vous vous êtes connecté trop tôt. Une fois la première connexion effectuée, patientez environ 20 minutes avant de tenter d'accéder à Phileas. ## Erreurs de Slurm ### Je n'arrive pas a soumettre de jobs, j'ai une erreur d'account ou de partition @@ -73,4 +22,4 @@ Exemple d'erreur avec curl : curl: (56) Received HTTP code 403 from proxy after CONNECT ``` -Cette erreur indique que le domaine que vous souhaitez joindre n'a pas été explicitement autorisé à être contacté depuis Phileas. Vous pouvez ouvrir un ticket de support en indiquant clairement quel nom de domaine vous souhaitez autoriser, et pour quelle utilité. \ No newline at end of file +Cette erreur indique que le domaine que vous souhaitez joindre n'a pas été explicitement autorisé à être contacté depuis Phileas. Vous pouvez ouvrir un ticket de support en indiquant clairement quel nom de domaine vous souhaitez autoriser, et pour quelle utilité. diff --git a/docs/code_form/phileas/access/02_ssh_terminal.md b/docs/code_form/phileas/access/02_ssh_terminal.md new file mode 100644 index 00000000..675ee2cb --- /dev/null +++ b/docs/code_form/phileas/access/02_ssh_terminal.md @@ -0,0 +1,52 @@ +# Accéder via SSH + +:::info +Cette méthode d'accès est préconisée pour les enseignants, chercheurs, et toute autre personne étant habituée à la connexion SSH avec son PC. Pour tout autre utilisateur, nous recommandons __très fortement__ d'utiliser le Shell disponible [directement sur le portail](./portal/05_cluster.md) +::: + + +Sur Phileas, inutile de gérer des clés SSH. Toute connexion avec SSH se fait via une authentification via le Web. Ainsi, sans aucune configuration de votre côté, vous pouvez simplement faire : + +```bash +ssh :Login@warpgate.phileas.ec-nantes.fr + +# Exemple +ssh pbondial@ec-nantes.fr:Login@warpgate.phileas.ec-nantes.fr +``` + +En remplaçant `` par votre nom d'utilisateur de la fédération Renater (ou votre nom d'utilisateur IAM local). __Le suffixe `:Login` est nécessaire. + + +:::info +Vous pouvez également ajouter ce bloc dans votre configuration SSH : + +``` +Host Phileas + Hostname warpgate.phileas.ec-nantes.fr + User :Login +``` + +Pour ensuite vous connecter avec `ssh Phileas`. + +::: + +Une fois la commande lancée, vous verrez un lien de connexion apparaître et une clé de sécurité : + +``` +[pablo@pcici02:~]$ ssh pbondial@ec-nantes.fr:Login@warpgate.phileas.ec-nantes.fr +Warpgate authentication +----------------------------------------------------------------------- +Please verify the SSH authentication request in your browser. +https://warpgate.phileas.ec-nantes.fr/@warpgate#/login/474e9734-87b8-4b10-ae8d-bb83ca46b231 + +Make sure you're seeing this security key: A D D 6 +----------------------------------------------------------------------- + +(pbondial@ec-nantes.fr:Login@warpgate.phileas.ec-nantes.fr) Press Enter when done: +``` + +Cliquez sur le lien pour vous authentifier, vérifiez que vous voyez bien la même clé de sécurité : + +![Modifier les fichiers](/img/phileas/warpgate_code.png) + +Et cliquez sur _approve_. De retour dans votre terminal, appuyez sur la touche _Entrée_ et vous serez connecté. diff --git a/docs/code_form/phileas/access/ssh_transfers/index.md b/docs/code_form/phileas/access/ssh_transfers/index.md deleted file mode 100644 index 2b954208..00000000 --- a/docs/code_form/phileas/access/ssh_transfers/index.md +++ /dev/null @@ -1,20 +0,0 @@ -# Transferts de gros fichiers - -:::danger - -Cette page est réservée aux utilisations très précises de Phileas qui ne pourraient pas s'effectuer avec le portail. Un exemple -potentiel serait le transfert de données > 2Go vers ou depuis Phileas. Pour __toutes__ les autres utilisations, [nous vous demandons d'utiliser le portail Web](../portal/01_initial_access.md) - -::: - - -Pour transférer des fichiers volumineux, le portail web n'est pas adapté. Pour effectuer des transferts, il faut passer par SSH. Vous avez à votre disposition une page vous permettant de demander un accès SSH temporaire : https://auth.phileas.ec-nantes.fr/if/user/#/settings - -Sur cette page de paramètres, cliquez simplement sur _Save_ et vous reçevrez un email avec les informations de connexion que vous pourrez utiliser. Suivez les instructions décrites dans l'email pour continuer. - -Le token que vous reçevrez est __individuel__ et vous permettra de vous connecter en SSH pour faire quelques tests simples, et de transférer vos données. Vous pourrez également utiliser n'importe quel client de transfert de fichier SSH (FileZilla, WinSCP, etc.) pour envoyer/rapatrier vos fichiers. - - -:::info -Ne soyez pas étonnés, votre nom d'utilisateur ressemblera à `ticket-2bc56f594b7fc05c7f480d79acb1c025e8dc181f461c3603187dad3fb093eb65` , mais il correspond bien à votre utilisateur sur Phileas. -::: diff --git a/static/img/phileas/warpgate_code.png b/static/img/phileas/warpgate_code.png new file mode 100644 index 00000000..1500cc37 Binary files /dev/null and b/static/img/phileas/warpgate_code.png differ