Questa guida passo passo spiega come configurare Salesforce per consentire a BuiltWith di sincronizzare i risultati utilizzando Salesforce Lightning Experience.
È necessario essere un amministratore di sistema Salesforce e l'utente Salesforce che autorizza BuiltWith deve disporre dell'accesso API e delle autorizzazioni per aggiornare i record e i campi che si desidera sincronizzare.
Utilizzate già BuiltWith Salesforce Sync? Se la sincronizzazione funziona correttamente, non è richiesta alcuna azione. Non è necessario modificare le impostazioni di Salesforce o riconnettersi. Le connessioni esistenti continuano a utilizzare la configurazione corrente. L'esecuzione di una normale sincronizzazione non modifica le impostazioni di connessione.
Se desideri abilitare le impostazioni di sicurezza aggiuntive descritte di seguito su una connessione esistente, autenticati nuovamente dalla pagina di configurazione di BuiltWith per Salesforce utilizzando il flusso di connessione aggiornato. Dopo l'autorizzazione, abilita le impostazioni in Salesforce. Le mappature e le impostazioni di sincronizzazione di BuiltWith verranno mantenute. Salesforce potrebbe richiederti di autorizzarti nuovamente dopo una modifica delle policy.
1. Configura la tua app Salesforce Nella configurazione di Salesforce, apri le impostazioni OAuth per l'app che utilizzerai con BuiltWith. A seconda della tua organizzazione Salesforce, potrebbe trattarsi di un'app connessa o di un'app client esterna e le etichette disponibili potrebbero variare. Se Salesforce non offre la possibilità di creare una nuova app connessa, utilizza un'app client esterna con le impostazioni OAuth equivalenti.
Nome dell'app connessa / Nome dell'app client esterna : BuiltWith Hook
Nome API : BuiltWith_Hook
Indirizzo email di contatto : support@builtwith.com
URL dell'immagine del logo : https://builtwith.com/img/salesforce/200x125-bw.webp
URL dell'icona : https://builtwith.com/img/salesforce/32x32-bw.webp
URL informativo : https://kb.builtwith.com/category/salesforce
Descrizione : Hook di integrazione BuiltWith
Inserisci questi dati negli appositi campi.
2. Abilitare OAuth Seleziona
"Abilita impostazioni OAuth" o l'opzione OAuth equivalente.
URL di callback : https://builtwith.com/cb.asmx
Inserisci l'URL di callback esattamente come mostrato.
Aggiungi i seguenti ambiti OAuth:
Accedi al servizio URL di identità (ID, profilo, email, indirizzo, telefono) Accesso completo (completo) Eseguire richieste per tuo conto in qualsiasi momento (refresh_token, offline_access) 3. Imposta le opzioni di sicurezza per una nuova connessione Abilita le seguenti opzioni, ove disponibili:
Richiesta dell'estensione della chiave di prova per lo scambio di codici (PKCE) per i flussi di autorizzazione supportati Richiesta di segreto per il flusso del server Web Richiesta di codice segreto per il flusso di aggiornamento del token Abilita la rotazione del token di aggiornamento BuiltWith supporta PKCE tramite S256 e salva i token di aggiornamento sostitutivi quando Salesforce li emette. Non è più necessario disattivare PKCE per creare una nuova connessione BuiltWith. Le connessioni funzionano anche quando la tua app Salesforce non richiede PKCE o la rotazione dei token di aggiornamento.
4. Connetti BuiltWith Salva le impostazioni della tua app Salesforce e ottieni la Chiave Consumer e il Segreto Consumer. Mantieni il segreto riservato.
Apri la
pagina di configurazione di Salesforce in BuiltWith . Inserisci la chiave consumer, il segreto consumer e il nome host di accesso a Salesforce, quindi seleziona
"Autentica" e completa l'autorizzazione in Salesforce.
Torna a BuiltWith per convalidare i campi di Salesforce e completare la configurazione della sincronizzazione. Se ti stai riconnettendo, le mappature e le impostazioni di sincronizzazione esistenti verranno mantenute.
Polizze di sicurezza opzionali Elenco IP consentiti del token di aggiornamento Per utilizzare
Enforce Refresh Token IP Allowlist , aggiungi tutti e quattro gli indirizzi IPv4 in uscita BuiltWith elencati di seguito prima di abilitare l'impostazione:
15.235.50.228
51.161.84.56
15.235.53.29
15.235.50.223
Se Salesforce richiede un indirizzo di inizio e uno di fine, inserisci lo stesso indirizzo IP in entrambi i campi per ogni voce. Sia l'autorizzazione che l'aggiornamento del token devono provenire da un indirizzo consentito. Dopo aver abilitato l'impostazione, convalida la tua connessione BuiltWith e verifica che una sincronizzazione pianificata vada a buon fine. Contatta support@builtwith.com per configurare le notifiche di cambio IP prima di fare affidamento sulla lista degli indirizzi consentiti.
Scadenza del token di aggiornamento È possibile applicare i criteri di scadenza del token di aggiornamento della propria organizzazione, incluso un criterio di 90 giorni laddove Salesforce lo consenta. Salesforce potrebbe anche applicare un limite di inattività più breve. Quando un token di aggiornamento scade o l'accesso viene revocato, la sincronizzazione non può continuare finché non si esegue nuovamente l'autenticazione dalla pagina di configurazione di BuiltWith su Salesforce. La riconnessione mantiene le mappature di BuiltWith e le impostazioni di sincronizzazione.
DPoP BuiltWith Salesforce Sync al momento non supporta la dimostrazione della prova di possesso (DPoP). Non abilitare il requisito dei token associati a DPoP per questa integrazione.
Documentazione Salesforce Impostazioni OAuth per le app connesse Impostazioni OAuth per le app client esterne Aggiorna il flusso e la rotazione dei token Aggiorna gli elenchi IP consentiti del token Limiti di inattività del token di aggiornamento