Connessioni sicure agli ambienti remoti

Ultimo aggiornamento: 13 marzo 2025

Creato per:

  • Sviluppatore

Secure Shell (SSH) è un protocollo comune utilizzato per accedere in modo sicuro ai server e ai sistemi remoti. È possibile utilizzare SSH per accedere agli ambienti remoti per gestire l’applicazione Adobe Commerce e accedere ai registri degli ambienti remoti. Adobe supporta solo connessioni FTP sicure (sFTP) tramite la chiave pubblica SSH. Le connessioni FTP non sono supportate.

Generare una coppia di chiavi SSH

Crea una coppia di chiavi SSH in ogni computer e area di lavoro che richiede l’accesso al codice sorgente e agli ambienti del progetto. La chiave SSH consente di connettersi a GitHub per gestire il codice sorgente e connettersi ai server cloud senza dover fornire costantemente nome utente e password. Per ulteriori istruzioni sulla creazione di una coppia di chiavi SSH, vedere Connessione a GitHub con SSH.

  • La chiave pubblica è sicura per l'accesso a un sito, SSH e sFTP.
  • La chiave privata rimane privata nella workstation.
CAUTION
Non condividere mai la tua chiave privata. Non aggiungerlo a un ticket, copiarlo in una chat o allegarlo alle e-mail.

Aggiungi una chiave pubblica SSH al tuo account

Dopo aver aggiunto o aggiornato la chiave pubblica SSH all'account Adobe Commerce sull'infrastruttura cloud, ridistribuisci tutti gli ambienti attivi nell'account per installare la chiave.

È possibile aggiungere chiavi SSH all'account utilizzando uno dei seguenti metodi: Cloud CLI o Cloud Console.

CLI

Aggiungere la chiave SSH utilizzando Cloud CLI

  1. Sulla workstation locale, passa alla directory del progetto.

  2. Accedi al progetto:

    magento-cloud login

  3. Aggiungi la chiave pubblica.

    magento-cloud ssh-key:add ~/.ssh/id_rsa.pub
TIP
È possibile elencare ed eliminare le chiavi SSH utilizzando i comandi Cloud CLI ssh-key:list e ssh-key:delete.
Console

Aggiungi la tua chiave SSH utilizzando Cloud Console

Per aggiungere una chiave SSH a un nuovo progetto:

  1. Accedi a Cloud Console.

  2. Fare clic su No SSH key. Questa icona si trova a destra del campo del comando ed è visibile quando il progetto non contiene una chiave SSH.

  3. Copia e incolla il contenuto della chiave SSH pubblica nel campo Chiave pubblica.

  4. Seguire le istruzioni rimanenti.

Per aggiungere una chiave SSH al profilo cloud:

  1. Accedi a Cloud Console.

  2. Nel menu dell'account in alto a destra, fare clic su Profilo personale.

  3. Nella visualizzazione Chiavi SSH, fare clic su Aggiungi chiave pubblica.

  4. Nel modulo Aggiungi una chiave SSH, assegna alla chiave un Titolo e incolla la chiave SSH pubblica nel campo Chiave.

  5. Fai clic su Salva.

Connessione a un ambiente remoto

È possibile connettersi a un ambiente remoto utilizzando CLI magento-cloud o un comando SSH. I comandi CLI magento-cloud possono essere utilizzati solo negli ambienti di integrazione Starter e Pro.

Utilizzare Cloud CLI

Per accedere a un ambiente di integrazione remoto:

  1. Sulla workstation locale, passa alla directory del progetto.

  2. Elencare gli ambienti in tale progetto.

    magento-cloud environment:list -p <project-ID>

  3. Utilizza SSH per accedere all’ambiente remoto.

    magento-cloud ssh -p <project-ID> -e <environment-ID>

Utilizzare un comando SSH

Cloud Console include un elenco di comandi di accesso Web e SSH per ogni ambiente.

Per copiare il comando SSH:

  1. Accedi a Cloud Console.

  2. Selezionare un progetto dall'elenco Tutti i progetti.

  3. Seleziona un ambiente.

  4. Fare clic su SSH.

  5. Nella scheda SSH, fare clic sul pulsante Copia per copiare il comando SSH completo negli Appunti.

  6. Apri un terminale e incolla il comando SSH per creare una connessione.

    ssh abcdefg123abc-branch-a12b34c--mymagento@ssh.us-2.magento.cloud
TIP
Per gli ambienti Pro Staging e Production, il comando SSH potrebbe essere simile al seguente:
ssh <node>.ent-<project-ID>-<environment>-<user-ID>@ssh.<region>.magento.com

sFTP

L’infrastruttura cloud di Adobe Commerce supporta l’accesso agli ambienti utilizzando sFTP (Secure FTP) con autenticazione SSH. Utilizza un client che supporta l’autenticazione della chiave SSH per sFTP e utilizza la tua chiave SSH pubblica. La chiave SSH pubblica deve essere aggiunta all’ambiente di destinazione. Per gli ambienti Starter e gli ambienti di integrazione Pro, puoi aggiungerli tramite Cloud Console.

Le connessioni sFTP di sola lettura sono non supportate; per impostazione predefinita, l'accesso sFTP è fornito con l'autorizzazione scrittura.

Durante la configurazione di sFTP, utilizzare le informazioni del comando dell'ambiente di accesso SSH: <project-id>-<environment-id>--<app-name>@ssh<cloud-host>

  • Nome utente: tutto il contenuto prima di @ nella destinazione di accesso SSH.
  • Password: non è necessaria una password per sFTP. L’accesso sFTP utilizza l’autenticazione con chiave SSH.
  • Host: tutto il contenuto dopo @ nell'accesso SSH.
  • Porta: 22, che è la porta SSH predefinita.
  • SSH chiave privata: se necessario, fornisci la posizione della chiave privata al client sFTP. Per impostazione predefinita, le chiavi private sono archiviate nella directory ~/.ssh.

A seconda del client, potrebbero essere necessarie opzioni aggiuntive per completare l’autenticazione SSH per sFTP. Consulta la documentazione del client selezionato.

Per gli ambienti Starter e gli ambienti di integrazione Pro, è inoltre consigliabile aggiungere un mount per l'accesso a una directory specifica. Aggiungere il mount al file .magento.app.yaml. Per un elenco delle directory scrivibili, vedere Struttura del progetto. Questo punto di montaggio funziona solo in questi ambienti.

Per ambienti di staging e produzione Pro, se non disponi dell'accesso SSH all'ambiente, devi inviare un ticket di supporto Adobe Commerce per richiedere l'accesso sFTP e un punto di montaggio per accedere alla cartella specifica, ad esempio pub/media.

NOTE
Per Pro Staging and Production, se la connessione sFTP è per un utente generico che non deve essere aggiunto al progetto Cloud, è necessario inviare un ticket di supporto Adobe Commerce allegando la chiave public. Non fornire mai la tua chiave SSH privata.