Accesso tecnico: collega magnews a sistemi esterni in un solo passaggio

Ad esempio puoi utilizzarli quando:

• un sito web o un e-commerce deve inviare email transazionali tramite magnews

• un CRM o un’applicazione aziendale deve scambiare dati con magnews tramite API

• un processo automatico deve importare o esportare file tramite lo spazio SFTP

• un fornitore o un sistema esterno deve accedere ai servizi di magnews.

Puoi utilizzare un accesso tecnico per:

• API magnews: integrare magnews con applicazioni o sistemi esterni

• Simply SMTP: inviare email transazionali utilizzando magnews come server SMTP

• SFTP: importare o esportare file e dati tramite lo spazio SFTP della piattaforma

• un utente tecnico

• un certificato digitale di tipo OAuth Client  

• un token OAuth

• le credenziali di accesso per i servizi che hai scelto.

Accessi tecnici

Puoi visualizzare tutti gli accessi tecnici nella sezione: Impostazioni → API e integrazioni → Accessi tecnici.

Qui trovi la lista degli accessi tecnici creati nel tuo account. Da qui puoi navigare tra gli elementi collegati:

• Nome: da qui apri il dettaglio 

• Utente tecnico: cliccando qui apri la scheda dell’utente

• Certificato digitale: cliccando qui apri il dettaglio del certificato

• Token: cliccando sulle ultime lettere del token apri la scheda del token.

Se è il primo accesso tecnico, la lista sarà vuota. In alto trovi il pulsante Crea accesso tecnico per crearne uno nuovo.

Come creare un accesso tecnico

Per cosa lo userai?

Seleziona uno o più servizi per cui vuoi generare le credenziali: API magnews, Simply SMTP, SFTP.

Le credenziali generate funzioneranno solo per i servizi selezionati, ma sarà possibile, per un utente con ruolo amministratore, modificare in seguito questi specifici permessi.

Assegna un nome

Inserisci un nome che identifichi l’integrazione. Questo nome sarà utilizzato automaticamente per:

• nome del certificato digitale

• nome del token OAuth di accesso

• nome e nome utente dell'utente tecnico

Potrai trovare questi elementi nelle rispettive sezioni della piattaforma.

Indica un'email

Inserisci l’indirizzo email associato all’utente tecnico che sarà creato. 

Redirect URL

Se stai creando un accesso tecnico per un’applicazione web, potrebbe occorrerti un URL di redirect OAuth. Se al momento non lo conosci, potrai aggiungerlo successivamente modificando il certificato digitale nella sezione API e integrazioni → Certificati digitali.

Riepilogo

Dopo aver creato un accesso tecnico vedi la pagina con il riepilogo e alcune istruzioni.

Il token e il refresh token possono essere copiati con l'iconcina a destra.

Elementi collegati

Se apri "Come accedere" vedrai delle istruzioni. Se apri "Altre informazioni sugli elementi collegati" troverai i riferimenti agli elementi creati.

Token

Il token è disponibile nella sezione: API e integrazioni → Gestione token. Da qui puoi visualizzarlo o revocarlo.

L’access token ha una durata limitata e può scadere. Puoi utilizzare il refresh token per generarne uno nuovo.

Utente tecnico

Quando crei un accesso tecnico, magnews crea automaticamente anche un utente tecnico dedicato all’integrazione. L'utente è visibile nella lista utenti del tuo account e si riconosce dal badge "utente tecnico". Puoi accedere alla sua scheda per visualizzare i dettagli o modificare i permessi se necessario. 

Questo tipo di utente è pensato per essere utilizzato da applicazioni, sistemi esterni o processi automatici, non da persone che accedono alla piattaforma. Per questo motivo ha alcune caratteristiche specifiche:

• è identificato con il flag di account tecnico

• non può accedere al backend di magnews

• la sua password non scade

• non viene sospeso per inattività.

L’utente tecnico viene inoltre configurato automaticamente con i permessi necessari per i servizi che hai selezionato durante la creazione dell’accesso tecnico (API, Simply SMTP, SFTP).

In questo modo puoi utilizzare subito le credenziali generate per configurare l’integrazione.

Come utilizzare un accesso tecnico

Come utilizzare le REST API

Per utilizzare le REST API di magnews, inserisci l’access token nell’header:

Authorization: Bearer {access_token}   

Per come utilizzare il refresh token e per maggiori dettagli consulta la documentazione delle REST API.

Come accedere allo spazio SFTP

Per collegarti allo spazio SFTP utilizza:

• Username: oauth 

• Password: access token

Scopri di più sull'accesso all'FTP con il certificato Client OAuth.

Come utilizzare Simply SMTP

Per inviare email tramite Simply SMTP utilizza le credenziali generate con l’accesso tecnico.

Consulta la guida dedicata per i parametri di configurazione SMTP.