Vai al contenuto principale
English
Help Desk

Come accedere e configurare lo spazio FTP/SFTP di magnews

Aggiornato

Questa guida spiega come utilizzare e autenticarsi allo spazio FTP/SFTP del tuo account magnews, usato per importare, esportare e gestire in modo sicuro i file all’interno di una struttura organizzata di cartelle e sottocartelle. Puoi strutturare i file in modo efficiente – ad esempio archiviando quelli già processati o separando gli attivi dai backup – per una gestione dei dati più chiara e sicura.

Dove trovare lo spazio FTP/SFTP

Trovi la sezione FTP/SFTP in Impostazioni → FTP → Esplora file.
Da qui puoi creare cartelle e sottocartelle per organizzare i tuoi file in modo ordinato.
Per accedere alla sezione e gestire i file, sono necessari permessi specifici, abilitati dal tuo referente account o dall’Help Desk di magnews.

FTP_cartelle.png

Prerequisiti di autenticazione

  1. Permessi utente
    Assicurati che l’utente disponga del permesso FTP/SFTP:
    • Vai in Impostazioni → Utenti e sicurezza → Utenti
    • Seleziona il tuo utente
    • Nella scheda Permessi, verifica che l’opzione FTP/SFTP sia abilitata
  2. Credenziali FTP/SFTP
    Vai in Impostazioni → FTP → Informazioni: qui trovi i dettagli di accesso al tuo FTP:
    • Server: sftp-mn1.mag-news.it:2222
    • Nome utente: quello mostrato a schermo
    • Password: la password del tuo utente

Per esempio:

FTP_info.png

Accesso allo spazio FTP con username e password

Apri un client FTP/SFTP (es. FileZilla) oppure usa il terminale.

Parametri di connessione:

  • Server: sftp-mn1.mag-news.it:2222
  • Nome utente: quello indicato nelle credenziali FTP/SFTP (vedi paragrafo precedente)
  • Password: la password del tuo utente

Una volta connesso, puoi esplorare le cartelle disponibili nel tuo account, ad esempio:

  • import → per caricare file di contatti o contenuti da usare in piattaforma
  • export → per scaricare file generati dalle esportazioni

Accesso allo spazio FTP con certificato digitale di tipo Client Application (OAuth 2.0)

Oltre all’autenticazione tradizionale con username e password, magnews consente l’accesso allo spazio SFTP tramite un certificato digitale Client Application (OAuth 2.0) o una chiave SSH per connessioni più sicure e automatizzate.

Per configurare l’autenticazione tramite Client Application (OAuth 2.0):

  1. Vai in Impostazioni → Web service → Certificati digitali
  2. Clicca su Nuovo certificato digitale
  3. Inserisci un Nome: un’etichetta visibile solo in magnews
  4. Seleziona Client Application (OAuth 2.0) come Tipo di certificato
  5. Definisci il Nome visualizzato: questo valore viene mostrato agli utenti nel form di richiesta di autorizzazione
  6. Definisci la OAuth redirect URI (necessaria solo se il certificato è usato da una web application)
  7. Clicca Crea per generare il certificato

Dopo la creazione, nella stessa pagina sono visibili i dettagli di Application ID e Secret key.

Certificato_digitale_nuovo_dettagli_ENG.png

Funzioni di utilità

Nella sezione Funzioni di utilità trovi:

  • Token location URL: l’indirizzo usato per scambiare parametri e ottenere un access token o utilizzare un refresh token
  • Informazioni sul token: un link con i dettagli del token
  • Durata del token: definisce per quante ore il token rimane valido
  • Ottieni access token: pulsante per ottenere subito un access token OAuth 2.0
Certificato_digitale_funzioni_utilità_ENG.png

Ottenere un access token

Una volta creato il certificato digitale, puoi ottenere immediatamente un access token. 
Clicca Ottieni access token per visualizzare i dettagli del token. 
Puoi modificarne la durata (default: quattro ore) o revocarlo istantaneamente (tramite il pulsante Revoca accesso).

Access_token_ENG.png

Lunghezza del client e del token

Alcuni client hanno un limite di lunghezza della password inferiore al numero di caratteri del token. 
In questo caso, il client potrebbe restituire un errore di “credenziali non valide”. 
Se riscontri questo problema, contatta l’Help Desk per assistenza.

Accesso allo spazio FTP con certificato digitale e chiave SSH

Per configurare l’autenticazione basata su chiave SSH:

  1. Vai in Impostazioni → Web service → Certificati digitali
  2. Clicca su Nuovo certificato digitale
  3. Inserisci un Nome: un’etichetta visibile solo in magnews
  4. (Opzionale) Inserisci un ID certificato: usato se il certificato deve essere referenziato da un’app installata su magnews
  5. Seleziona una delle seguenti opzioni in base al tuo caso d’uso:
    • Chiave SSH pubblica (Per consentire l’accesso al servizio SFTP della piattaforma) → scegli questa opzione se devi accedere allo spazio SFTP di magnews
    • Chiave SSH privata (Per accedere a server SFTP remoti) → scegli questa opzione se devi connetterti a un server remoto esterno
  6. Incolla nel campo Contenuto del certificato la chiave SSH pubblica generata sul sistema (server o client) da cui vuoi connetterti allo spazio SFTP di magnews
  7. Seleziona l’utente associato al certificato. È consigliato usare un utente amministratore tecnico, creato appositamente per scopi di integrazione (ad es. per caricare automaticamente file nello spazio FTP del tuo account magnews)

Questo metodo di autenticazione consente connessioni sicure e senza password, ideali per integrazioni automatizzate o application server che comunicano direttamente con magnews.

Configurare un server FTP remoto

Se vuoi collegare un server FTP esterno (non ospitato su magnews):

  1. Vai in Impostazioni → FTP → FTP remoti
  2. Clicca su Nuovo server
  3. Definisci i parametri richiesti:
    • Nome server: nome descrittivo utile per una facile identificazione
    • Chiave identificativa: identificativo tecnico univoco
    • Tipo di server: SFTP, FTP o FTPS
    • Hostname: l’indirizzo (host) del server a cui connettersi
    • Porta: (di default è 22)
    • Nome utente per l’accesso: specifica l’utente autorizzato
    • Autenticazione tramite:
      • Password: inserisci la password dell’utente
      • Certificato: seleziona il certificato da utilizzare

Una volta salvato, il server remoto sarà disponibile come origine o destinazione per i file gestiti con magnews.

Troubleshooting

  • Errore di login: verifica che il permesso FTP/SFTP sia attivo e che le credenziali siano corrette. Se l’errore persiste, prova a reimpostare la password o contatta il tuo referente account.
  • Connessione rifiutata: verifica con il tuo team IT che le connessioni verso il server sftp-mn1.mag-news.it:2222 siano consentite.
  • Accesso non disponibile: contatta il tuo referente account o l’Help Desk per verificare l’accesso allo spazio FTP di piattaforma e i permessi associati al tuo utente.
  • Access token: ricorda che nel campo User name dovrai scrivere oauth.
  • Token OAuth scaduto: se utilizzi l’autenticazione con certificato digitale di tipo Applicazione Client (OAuth 2.0), verifica la durata del token nella sezione Funzioni di utilità e rigenera l’access token, oppure imposta un refresh automatico.
  • Chiave SSH non riconosciuta: controlla che la chiave pubblica SSH incollata nel campo Contenuto del certificato sia completa e formattata correttamente e che la chiave privata corrispondente sia installata nel sistema da cui esegui la connessione.
  • Errore di autenticazione via certificato: se l’accesso tramite certificato o chiave fallisce, assicurati che il certificato sia associato all’utente corretto e che non sia stato revocato in Impostazioni → Web service → Certificati digitali.