Connettiti a Salesforce

Per connettere Salesforce con App Studio

1. In App Studio, nel pannello di navigazione, scegli Connettori nella sezione Gestisci. Verrai indirizzato a una pagina che mostra un elenco di connettori esistenti con alcuni dettagli su ciascuno.

2. Scegli + Crea connettore.

3. Scegli Salesforce dall'elenco dei tipi di connettore per aprire la pagina di creazione del connettore.

4. Prendi nota dell'URL di reindirizzamento, che utilizzerai per configurare Salesforce nei passaggi seguenti.

5. Il passaggio successivo è creare un'app connessa in Salesforce. In un'altra scheda o finestra, accedi alla tua istanza Salesforce.

6. Nella casella Ricerca rapida, cerca App Manager e seleziona App Manager.

7. Scegli Nuova app connessa.

8. In Nome app connessa e Nome API, inserisci un nome per la tua app. Non deve necessariamente corrispondere al nome della tua app App Studio.

9. Fornisci le informazioni di contatto necessarie.

10. Nella sezione API (Abilita impostazioni OAuth), abilita Abilita impostazioni OAuth.

11. In Callback URL, inserisci l'URL di reindirizzamento che hai annotato in precedenza da App Studio.

12. In Selected OAuth Scopes, aggiungi gli ambiti di autorizzazione necessari dall'elenco. App Studio può interagire con le API REST di Salesforce per eseguire operazioni CRUD su cinque oggetti: account, casi, contatti, lead e opportunità. Si consiglia di aggiungere l'accesso completo (completo) per garantire che l'app App Studio disponga di tutte le autorizzazioni o gli ambiti pertinenti.

13. Disabilita l'opzione Richiedi Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows. PKCE non è supportato da App Studio.

14. Abilita Require Secret for Web Server Flow e Require Secret for Refresh Token Flow per seguire le migliori pratiche di sicurezza.

15. App Studio supporta entrambi i seguenti flussi di autenticazione:

    • Client Credentials Flow: ideale per le interazioni tra server in cui l'applicazione agisce per conto proprio senza l'interazione dell'utente. Ad esempio, elencare tutte le informazioni sui lead per un team di dipendenti temporanei che non hanno accesso a Salesforce.

    • Authorization Code Flow: adatto per applicazioni che agiscono per conto di un utente, come l'accesso ai dati personali o le azioni. Ad esempio, elenca i lead di ciascun responsabile delle vendite di loro provenienza o di proprietà per svolgere altre attività tramite questa app.

    • Per il flusso delle credenziali del cliente:

      1. Abilita Abilita flusso di credenziali del cliente. Rivedi e conferma il messaggio.

      2. Salva l'app.

      3. È necessario selezionare un utente di esecuzione, sebbene non vi sia alcuna interazione con l'utente nel flusso. Selezionando un utente di esecuzione, Salesforce restituisce i token di accesso per conto dell'utente.

         1. In App Manager, dall'elenco delle app, scegli la freccia dell'app App Studio e scegli Gestisci.

         2. Scegli Modifica politiche

         3. In Client Credentials Flow, aggiungi l'utente appropriato.

    • Per il flusso del codice di autorizzazione, abilita Abilita codice di autorizzazione e flusso di credenziali

16. Salesforce fornisce un Client ID e un Client Secret, che devono essere utilizzati per configurare il connettore in App Studio nei passaggi seguenti.

    1. In App Manager, scegli la freccia dell'app App Studio e scegli Visualizza.

    2. Nella sezione API (Abilita impostazioni OAuth), scegli Gestisci i dettagli del consumatore. Questo potrebbe inviare un'email per una chiave di verifica, che devi inserire per la conferma.

    3. Annota la Consumer Key (ID cliente) e il Consumer Secret (Client Secret).

17. Tornando in App Studio, configura e crea il tuo connettore compilando i seguenti campi.

18. In Nome, inserisci un nome per il tuo connettore Salesforce.

19. In Descrizione, inserisci una descrizione per il tuo connettore Salesforce.

20. In URL di base, inserisci l'URL di base per la tua istanza Salesforce. Dovrebbe assomigliare a questo:https://hostname.salesforce.com/services/data/v60.0, sostituendolo hostname con il nome della tua istanza Salesforce.

21. Nel metodo di autenticazione, assicurati che OAuth 2.0 sia selezionato.

22. In OAuth 2.0 Flow, seleziona il metodo di autenticazione OAuth e compila i campi correlati:

    • Seleziona il flusso di credenziali del cliente da utilizzare nelle applicazioni che agiscono per proprio conto, per le integrazioni da sistema a sistema.

      1. In Client ID, inserisci la Consumer Key ottenuta in precedenza da Salesforce.

      2. In Client secret, inserisci il Consumer Secret, ottenuto in precedenza da Salesforce.

      3. Nell'URL del token di accesso, inserisci l'endpoint del token OAuth 2.0. Dovrebbe assomigliare a questo:https://hostname/services/oauth2/token, sostituendolo hostname con il nome della tua istanza Salesforce. Per ulteriori informazioni, consulta la documentazione di Salesforce OAuth Endpoints.

      4. Scegli Verifica connessione per testare l'autenticazione e la connessione.

    • Seleziona Flusso di codice di autorizzazione da utilizzare nelle applicazioni che agiscono per conto dell'utente.

      1. In Client ID, inserisci la Consumer Key ottenuta in precedenza da Salesforce.

      2. In Client secret, inserisci il Consumer Secret, ottenuto in precedenza da Salesforce.

      3. In URL di autorizzazione, inserisci l'endpoint di autorizzazione. Dovrebbe assomigliare a questo:https://hostname/services/oauth2/authorize, sostituendolo hostname con il nome della tua istanza Salesforce. Per ulteriori informazioni, consulta la documentazione di Salesforce OAuth Endpoints.

      4. Nell'URL del token di accesso, inserisci l'endpoint del token OAuth 2.0. Dovrebbe assomigliare a questo:https://hostname/services/oauth2/token, sostituendolo hostname con il nome della tua istanza Salesforce. Per ulteriori informazioni, consulta la documentazione di Salesforce OAuth Endpoints.

23. In Operazioni, seleziona le operazioni di Salesforce che il tuo connettore supporterà. Le operazioni in questo elenco sono predefinite e rappresentano attività comuni all'interno di Salesforce, come la creazione, il recupero, l'aggiornamento o l'eliminazione di record da oggetti comuni.

24. Scegli Crea. Il connettore appena creato verrà visualizzato nell'elenco Connettori.