Skip to main content
Italiano
Help Desk

How to access and configure the magnews FTP/SFTP space

Updated

This guide explains how to use and authenticate to the FTP/SFTP space of your magnews account, used to securely import, export and manage files in an organized structure of folders and subfolders. You can structure your files efficiently - for example, archiving processed files or separating active ones from backups - for clearer and safer data management.

Where to find the FTP/SFTP space

You can find the FTP/SFTP section under Settings → FTP → File explorer.
From here, you can create folders and subfolders to organize your files in an orderly way.
To access the section and manage files, you need specific permissions, enabled by your account manager or by the magnews Help Desk.

FTP_cartelle_ENG.png

Authentication prerequisites

  1. User permissions
    Make sure the user has the FTP/SFTP permission:
    • Go to Settings → Users and security → Users
    • Select your user
    • In the Permissions tab, check that the FTP/SFTP option is enabled
  2. FTP/SFTP credentials
    Go to Settings → FTP → Information: here you will find your FTP access details:
    • Server: sftp-mn1.mag-news.it:2222
    • Username: the one shown on screen
    • Password: your user password

For example:

FTP_info_ENG.png

Accessing the FTP space using username and password

Open an FTP/SFTP client (e.g. FileZilla) or use the terminal.

Connection parameters:

  • Server: sftp-mn1.mag-news.it:2222
  • Username: the one shown in the FTP/SFTP credentials (see previous paragraph)
  • Password: your user password

Once connected, you can browse the available folders in your account, for example:

  • import → to upload contact or content files to be used in the platform
  • export → to download files generated by exports

Accessing the FTP space with a Client Application (OAuth 2.0) digital certificate

In addition to traditional username and password authentication, magnews allows access to the SFTP space through a Client Application (OAuth 2.0) digital certificate or an SSH Key for more secure and automated connections.

To configure authentication via Client Application (OAuth 2.0):

  1. Go to Settings → Web service → Digital certificates
  2. Click on New digital certificate
  3. Enter a Name: a label visible only in magnews
  4. Select Client Application (OAuth 2.0) as the Certificate type
  5. Define the Display name: this value is shown to users in the authorization request form
  6. Define the OAuth redirect URI (required only if the certificate is used by a web application)
  7. Click Create to generate the certificate

After creating the certificate, the same page will display the details for Application ID and Secret key.

Certificato_digitale_nuovo_dettagli_ENG.png

Utility functions

In the Utility functions section, you can find:

  • Token location URL: the address used to exchange parameters for an access token or to use a refresh token
  • Token information: a link providing details about the token
  • Token duration: defines how many hours the token remains valid
  • Get access token: button to immediately obtain an OAuth 2.0 access token
Certificato_digitale_funzioni_utilità_ENG.png

Getting an access token

Once the digital certificate is created, you can immediately obtain an access token. 
Click Get access token to display token details. 
You can modify its duration (default: four hours) or revoke it instantly (using the Revoke access button).

Access_token_ENG.png

Client and token length

Some clients have a password length limit shorter than the number of characters in the token. 
In this case, the client may return an “invalid credentials” error. 
If you experience this issue, please contact the Help Desk for assistance.

Accessing the FTP space with a digital certificate and SSH key

To configure SSH key-based authentication:

  1. Go to Settings → Web service → Digital certificates
  2. Click on New digital certificate
  3. Enter a Name: a label visible only in magnews
  4. (Optional) Enter a Certificate ID: used if the certificate needs to be referenced by an app installed on magnews
  5. Select one of the following options depending on your use case:
    • Public SSH key (To allow access to the platform’s SFTP service) → choose this if you need to access the magnews SFTP space
    • Private SSH key (To access remote SFTP servers) → choose this if you need to connect to an external remote server
  6. Paste into the Certificate content field the public SSH key generated on the system (server or client) from which you want to connect to the magnews SFTP space
  7. Select the user associated with the certificate. It is recommended to use a technical administrator user, created specifically for integration purposes (e.g. for automatically uploading files to the FTP space of your magnews account)

This authentication method allows secure, password-free connections, ideal for automated integrations or application servers communicating directly with magnews.

Configuring a remote FTP server

If you want to connect an external FTP server (not hosted on magnews):

  1. Go to Settings → FTP → Remote FTP
  2. Click New server
  3. Define the required parameters:
    • Server name: descriptive name for easy identification
    • Key identifier: unique technical identifier
    • Server type: SFTP, FTP or FTPS
    • Hostname: the address (host) of the server to connect to
    • Port: (default is 22)
    • Username for access: specify the authorized user
    • Authentication via:
      • Password: enter the user password
      • Certificate: select the certificate to use

Once saved, the remote server will be available as a source or destination for files managed with magnews.

Troubleshooting

  • Login error: make sure the FTP/SFTP permission is active and credentials are correct. If the error persists, try resetting the password or contact your account manager.
  • Connection refused: check with your IT team that connections to the server sftp-mn1.mag-news.it:2222 are allowed.
  • Access not available: contact your team lead or the Help Desk to verify access to the platform’s FTP space and the permissions associated with your user.
  • Access token: remember that, in the User name field, you need to enter the value oauth.
  • OAuth token expired: if you use Client Application digital certificate authentication (OAuth 2.0), check the token duration in the Utility Functions section and regenerate the access token, or set up automatic refresh.
  • Unrecognized SSH key: Check that the SSH public key pasted into the Certificate Content field is complete and formatted correctly, and that the corresponding private key is installed on the system from which you are connecting.
  • Certificate authentication error: If access via certificate or key fails, make sure that the certificate is associated with the correct user and that it has not been revoked in Settings → Web service → Digital certificates.