Loading
Connessione del servizio di ricerca esterna all'organizzazione Salesforce

Connessione del servizio di ricerca esterna all'organizzazione Salesforce

Creare una configurazione di chiamata autenticata e identificare il provider di ricerca AWS attivo per l'organizzazione Salesforce.

Versioni (Edition) richieste

Autorizzazioni utente necessarie
Per creare credenziali denominate e impostazioni personalizzate: Personalizza applicazione

Prima di iniziare, registrare l'URL di chiamata API gateway e il percorso dell'operazione.

Creazione di una credenziale denominata

Proteggere e semplificare le chiamate API autenticate ai bucket Amazon S3 definendo una credenziale denominata. Per semplificare l'impostazione delle chiamate autenticate, creare una credenziale esterna per specificare un protocollo di autenticazione e quindi specificare una credenziale denominata come endpoint di chiamata.

  1. Creare una credenziale esterna e la relativa entità per specificare i dettagli di come Salesforce autentica le chiamate alle risorse in Amazon Web Services su HTTP utilizzando il protocollo AWS Signature v4.
    Per una maggiore sicurezza, si consiglia di utilizzare STS. Vedere Creazione o modifica di una credenziale esterna AWS Signature v4.
  2. Definire una credenziale denominata per specificare l'URL di un callout endpoint.

    Assicurarsi che l'URL sia in questo formato: https://{api-id}.execute-api.{region}.amazonaws.com/{stage-name}.

    Ad esempio, https://a1b2c3d4e5.execute-api.us-west-2.amazonaws.com/prod. Vedere Creazione di una credenziale denominata.

    Nota
    Nota Quando si configura l'endpoint nella credenziale denominata Salesforce, non includere :443 nell'host. L'inclusione della porta causa una mancata corrispondenza dell'host AWS Signature Version 4 e una risposta 403 SignatureDoesNotMatch.
  3. Utilizzare l'entità per collegare la credenziale esterna a un insieme di autorizzazioni o a un profilo utente in modo che gli utenti possano effettuare chiamate utilizzando la credenziale denominata.

Creazione dell'impostazione personalizzata Ricerca esterna

  1. Da Imposta, nella casella Ricerca veloce, immettere Impostazioni personalizzate e selezionare Impostazioni personalizzate.
  2. Fai clic su Nuova.
  3. Creare un'impostazione personalizzata con i seguenti valori:
    • Etichetta: Configurazione di Ricerca esterna
    • Nome oggetto: ExternalSearchConfig
    • Selezionare il tipo di impostazione personalizzata richiesto dall'implementazione.
  4. Salvare l'impostazione personalizzata.
  5. Creare questi campi.
    Campo Tipo di dati Descrizione
    NamedCredentialName Testo Nome sviluppatore della credenziale denominata
    Percorso operazione Testo Percorso dell'operazione API gateway aggiunto all'URL della credenziale denominata. Esempio: Se l'endpoint API gateway è "https://a1b2c3d4e5.execute-api.us-west-2.amazonaws.com/prod/performsearch", OperationPath è "performsearch"
    SearchProvider Testo Identificatore provider di ricerca: bedrock o kendra. Importante: Assicurarsi di specificare i valori come indicato qui.
    TimeoutSecondi Testo Tempo massimo consentito per la chiamata API gateway
    IsActive Casella di controllo Indica se Salesforce utilizza questa configurazione. Può essere attiva una sola configurazione alla volta.
  6. Utilizzare le etichette dei campi, i nomi API e i tipi di dati richiesti dall'implementazione della ricerca nell'archiviazione esterna.
  7. Creare un record ExternalSearchConfig per il servizio di ricerca e quindi selezionare IsActive.
    Nota
    Nota Mantenere attiva una sola configurazione alla volta. Se più di uno è attivo, il comportamento della ricerca è imprevedibile.
  8. Concedere agli utenti l'accesso alla configurazione di ricerca.
    Vedere Concessione agli utenti dell'accesso alle impostazioni personalizzate.
 
Caricamento
Salesforce Help | Article