

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Connect a Salesforce
<a name="connectors-salesforce"></a>

Per connettere App Studio a Salesforce e consentire ai builder di accedere e utilizzare le risorse Salesforce nelle applicazioni, devi creare e configurare un'app connessa in Salesforce e creare un connettore Salesforce in App Studio.

**Per connettere Salesforce con App Studio**

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

1. Scegli **\+ Crea connettore**.

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

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

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

1. Nella casella Ricerca rapida, cerca **App Manager** e seleziona **App** Manager.

1. Scegli **Nuova app connessa**.

1. In **Nome app connessa** e **nome API**, inserisci un nome per la tua app. Non deve necessariamente corrispondere al nome dell'app App Studio.

1. Fornisci le informazioni di contatto necessarie.

1. Nella sezione **API (Abilita impostazioni OAuth), abilita Abilita le impostazioni** **OAuth**.

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

1. In Ambiti **OAuth selezionati, 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.

1. Disattiva l'opzione **Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows**. PKCE non è supportato da App Studio.

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

1. App Studio supporta entrambi i seguenti flussi di autenticazione:
   + **Client Credentials Flow**: ideale per le interazioni da server a server in cui l'applicazione agisce per proprio conto senza l'interazione dell'utente. Ad esempio, elenca tutte le informazioni relative ai lead di 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 o le azioni ai dati personali. Ad esempio, elenca i lead di ciascun responsabile delle vendite acquistati o di sua proprietà per eseguire altre attività tramite questa app.
   + Per il flusso delle credenziali del cliente:

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

     1. Salva l'app.

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

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

        1. Scegli **Modifica politiche**

        1. In **Client Credentials Flow**, aggiungi l'utente appropriato.
   + Per il flusso del codice di autorizzazione, abilita **Abilita il codice di autorizzazione e il flusso delle credenziali**

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

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

   1. Nella sezione **API (Abilita impostazioni OAuth)**, scegli **Gestisci i dettagli del consumatore**. Questo potrebbe inviare un'e-mail con una chiave di verifica, che devi inserire per la conferma.

   1. Annota la **Consumer Key** (Client ID) e il **Consumer Secret** (Client Secret).

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

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

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

1. In **Base URL**, inserisci l'URL di base per l'istanza Salesforce. Dovrebbe avere il seguente aspetto:`https://{{hostname}}.salesforce.com/services/data/v60.0`, sostituendolo {{hostname}} con il nome dell'istanza Salesforce.

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

1. In **OAuth 2.0 Flow**, seleziona il metodo di autenticazione OAuth e compila i campi correlati:
   + Seleziona il **flusso di credenziali del client** 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.

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

     1. Nell'**URL del token di accesso**, inserisci l'endpoint del token OAuth 2.0. Dovrebbe avere il seguente aspetto:`https://{{hostname}}/services/oauth2/token`, sostituendolo {{hostname}} con il nome dell'istanza Salesforce. Per ulteriori informazioni, consulta la documentazione di [Salesforce](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_endpoints.htm&type=5) OAuth Endpoints.

     1. Scegli **Verifica connessione per testare l'autenticazione e la connessione**.
   + Seleziona il **flusso del 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.

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

     1. In **URL di autorizzazione**, inserisci l'endpoint di autorizzazione. Dovrebbe avere il seguente aspetto:`https://{{hostname}}/services/oauth2/authorize`, sostituendolo {{hostname}} con il nome dell'istanza Salesforce. Per ulteriori informazioni, consulta la documentazione di [Salesforce](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_endpoints.htm&type=5) OAuth Endpoints.

     1. Nell'**URL del token di accesso**, inserisci l'endpoint del token OAuth 2.0. Dovrebbe avere il seguente aspetto:`https://{{hostname}}/services/oauth2/token`, sostituendolo {{hostname}} con il nome dell'istanza Salesforce. Per ulteriori informazioni, consulta la documentazione di [Salesforce](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_endpoints.htm&type=5) OAuth Endpoints.

1. In **Operazioni, seleziona le operazioni** Salesforce supportate dal connettore. 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.

1. Scegli **Create** (Crea). **Il connettore appena creato verrà visualizzato nell'elenco Connettori.**