Per collegare Salesforce a magnews e consentire lo scambio sicuro dei dati, è necessario registrare un’applicazione in Salesforce. Questa configurazione permette a magnews di accedere alle informazioni tramite autenticazione sicura, senza condividere password utente.
In questa guida vedrai come creare una External Client App in Salesforce e come configurarla correttamente per completare l’integrazione con magnews.
Prima di iniziare: recupera il Redirect URI da magnews
Prima di configurare Salesforce, è necessario recuperare da magnews l’indirizzo di Redirect URI, che dovrà essere inserito durante la creazione dell’app.
Dal menù Connect > Salesforce > Configurazione clicca su Impostazioni del certificato digitale Server e annota il valore indicato nel campo Redirect URI da configurare.
Questo indirizzo rappresenta l’endpoint a cui Salesforce invierà la risposta di autorizzazione dopo l’autenticazione.
Crea una External Client App in Salesforce
La configurazione viene eseguita direttamente in Salesforce. I passaggi possono variare leggermente in base agli aggiornamenti dell’interfaccia, ma la logica rimane invariata.
1. Accedi alla configurazione delle App
Accedi a Salesforce e clicca su Imposta (icona ingranaggio).
Nella barra di ricerca della configurazione, digita App Manager (o Gestore App).
Seleziona New External Client App (oppure Nuova External Client App nella versione italiana).
2. Configura le informazioni principali
- App Name: inserisci
magnews - API Name: lascia quello proposto automaticamente oppure inserisci
magnews - Contact Email: inserisci un indirizzo email valido
3. Abilita l’autenticazione OAuth
Nella sezione dedicata all’autenticazione:
- Attiva l’opzione Enable OAuth Settings
- Nel campo Callback URL incolla il Redirect URI copiato da magnews
L’URL avrà un formato simile a:https://be-mn1.mag-news.it/be/oauth/client
4. Seleziona gli ambiti (OAuth Scopes)
Aggiungi i seguenti ambiti OAuth:
- Manage user data via APIs (api)
- Perform requests at any time (refresh_token, offline_access)
5. Crea l’app e annota le chiavi
Clicca su Create.
Una volta completata la creazione, vai in Settings > OAuth Settings e clicca su Consumer Key and Secret.
Copia i valori generati (Client ID e Client Secret) e inseriscili nel certificato digitale magnews, nello stesso punto in cui hai recuperato il Redirect URI, nei rispettivi campi magnews ClientID e Chiave segreta.