Adobe Experience Manager - Amazon Kendra

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à.

Adobe Experience Manager

Nota

Il connettore Adobe Experience Manager rimarrà pienamente supportato per i clienti esistenti fino al 31 maggio 2026. Sebbene questo connettore non sia più disponibile per i nuovi utenti, gli utenti attuali possono continuare a utilizzarlo senza interruzioni. Stiamo continuamente evolvendo il nostro portafoglio di connettori per offrire soluzioni più scalabili e personalizzabili. Per le integrazioni future, consigliamo di esplorare Amazon Kendra Custom Connector Framework [1], progettato per supportare una gamma più ampia di casi d'uso aziendali con una maggiore flessibilità.

Adobe Experience Managerè un sistema di gestione dei contenuti utilizzato per creare contenuti per siti Web o app mobili. Puoi utilizzarlo Amazon Kendra per connetterti alle tue pagine Adobe Experience Manager e ai tuoi contenuti e indicizzarli.

Amazon Kendra supporta Adobe Experience Manager (AEM) come istanza di autore di Cloud Service e istanza di autore Adobe Experience Manager e pubblicazione in locale.

Puoi connetterti Amazon Kendra alla tua fonte di Adobe Experience Manager dati utilizzando la Amazon Kendra console o l'API. TemplateConfiguration

Per la risoluzione dei problemi relativi al connettore di origine dati di Amazon Kendra Adobe Experience Manager, consultaRisoluzione dei problemi relativi alle origini dati.

Funzionalità supportate

Adobe Experience Manageril connettore di origine dati supporta le seguenti funzionalità:

  • mappature dei campi

  • Controllo dell'accesso degli utenti

  • Filtri di inclusione/esclusione

  • Sincronizzazione completa e incrementale dei contenuti

  • OAuth 2.0 e autenticazione di base

  • Virtual Private Cloud (VPC) (Cloud privato virtuale (VPC)

Prerequisiti

Prima di poterla utilizzare Amazon Kendra per indicizzare la tua fonte di Adobe Experience Manager dati, apporta queste modifiche al tuo AWS account Adobe Experience Manager e ai tuoi account.

NelAdobe Experience Manager, assicurati di avere:

  • Accesso a un account con privilegi amministrativi o a un utente amministratore.

  • Hai copiato l'URL dell'Adobe Experience Managerhost.

    Nota

    (On-premise/server) Amazon Kendra verifica se le informazioni sull'endpoint incluse sono le stesse informazioni sull'endpoint specificate nei AWS Secrets Manager dettagli di configurazione dell'origine dati. In questo modo si evita il problema del confuso vicario, ossia un problema di sicurezza in cui un utente non è autorizzato a eseguire un'azione ma lo utilizza Amazon Kendra come proxy per accedere al segreto configurato ed eseguire l'azione. Se successivamente modifichi le informazioni sull'endpoint, devi creare un nuovo segreto per sincronizzare queste informazioni.

  • Hai annotato le credenziali di autenticazione di base del nome utente e della password dell'amministratore.

    Nota

    Ti consigliamo di aggiornare o ruotare regolarmente le credenziali e il segreto. Fornisci solo il livello di accesso necessario per la tua sicurezza. Non è consigliabile riutilizzare credenziali e segreti tra diverse fonti di dati e versioni dei connettori 1.0 e 2.0 (ove applicabile).

  • Facoltativo: credenziali OAuth 2.0 configurate in Adobe Experience Manager (AEM) come servizio cloud o AEM On-Premise. Se utilizzi AEM On-Premise, le credenziali includono l'ID client, il segreto del client e la chiave privata. Se utilizzi AEM come servizio cloud, le credenziali includono l'ID client, il segreto del cliente, la chiave privata, l'ID dell'organizzazione, l'ID tecnico dell'account e l'host (IMS). Adobe Identity Management System Per ulteriori informazioni su come generare queste credenziali per AEM as a Cloud Service, consulta la documentazione. Adobe Experience Manager Per AEM On-Premise, l'implementazione del server Adobe Granite OAuth 2.0 (com.adobe.granite.oauth.server) fornisce il supporto per OAuth le funzionalità del server 2.0 in AEM.

  • Controllato, ogni documento è unico in Adobe Experience Manager e tra le altre fonti di dati che intendi utilizzare per lo stesso indice. Ogni fonte di dati che desideri utilizzare per un indice non deve contenere lo stesso documento in tutte le fonti di dati. IDs I documenti sono globali rispetto a un indice e devono essere univoci per indice.

Nel tuo Account AWS, assicurati di avere:

  • Ha creato un Amazon Kendra indice e, se si utilizza l'API, ha annotato l'ID dell'indice.

  • Hai creato un IAM ruolo per la tua origine dati e, se utilizzi l'API, hai annotato l'ARN del IAM ruolo.

    Nota

    Se modifichi il tipo di autenticazione e le credenziali, devi aggiornare il IAM ruolo per accedere all'ID AWS Secrets Manager segreto corretto.

  • Ha archiviato le credenziali di autenticazione di Adobe Experience Manager in un luogo AWS Secrets Manager segreto e, se si utilizza l'API, ha annotato l'ARN del segreto.

    Nota

    Ti consigliamo di aggiornare o ruotare regolarmente le credenziali e il segreto. Fornisci solo il livello di accesso necessario per la tua sicurezza. Non è consigliabile riutilizzare credenziali e segreti tra diverse fonti di dati e versioni dei connettori 1.0 e 2.0 (ove applicabile).

Se non disponi di un IAM ruolo o di un segreto esistente, puoi utilizzare la console per creare un nuovo IAM ruolo e un Secrets Manager segreto quando connetti l'origine dati di Adobe Experience Manager a. Amazon Kendra Se utilizzi l'API, devi fornire l'ARN di un IAM ruolo e di un Secrets Manager segreto esistenti e un ID di indice.

Istruzioni di connessione

Per connetterti Amazon Kendra alla tua fonte di Adobe Experience Manager dati, devi fornire i dettagli necessari della tua origine Adobe Experience Manager dati in modo che Amazon Kendra possa accedere ai tuoi dati. Se non hai ancora configurato Adobe Experience Manager per Amazon Kendra, consultaPrerequisiti.

Console

Per connettersi Amazon Kendra a Adobe Experience Manager

  1. Accedi a AWS Management Console e apri la Amazon Kendra console.

  2. Dal riquadro di navigazione a sinistra, scegli Indici, quindi scegli l'indice che desideri utilizzare dall'elenco degli indici.

    Nota

    Puoi scegliere di configurare o modificare le impostazioni del controllo dell'accesso degli utenti in Impostazioni dell'indice.

  3. Nella pagina Guida introduttiva, scegli Aggiungi origine dati.

  4. Nella pagina Aggiungi origine dati, scegli Adobe Experience Manager connector, quindi scegli Aggiungi connettore. Se utilizzi la versione 2 (se applicabile), scegli il connettore Adobe Experience Manager con il tag «V2.0".

  5. Nella pagina Specificare i dettagli dell'origine dati, inserisci le seguenti informazioni:

    1. In Nome e descrizione, per Nome dell'origine dati, inserisci un nome per l'origine dati. Puoi includere trattini ma non spazi.

    2. (Facoltativo) Descrizione: immetti una descrizione facoltativa per l'origine dati.

    3. In Lingua predefinita: scegli una lingua per filtrare i documenti per l'indice. Se non diversamente specificato, la lingua predefinita è l'inglese. La lingua specificata nei metadati del documento ha la precedenza sulla lingua selezionata.

    4. In Tag, per Aggiungi nuovo tag, includi tag opzionali per cercare e filtrare le risorse o tenere traccia dei costi. AWS

    5. Scegli Next (Successivo).

  6. Nella pagina Definisci accesso e sicurezza, inserisci le seguenti informazioni:

    1. Fonte: scegli AEM On-Premise o AEM as a Cloud Service.

      Inserisci l'URL dell'host. Adobe Experience Manager Ad esempio, se utilizzi AEM On-Premise, includi il nome host e la porta:. https://hostname:port Oppure, se utilizzi AEM come servizio cloud, puoi utilizzare l'URL dell'autore:. https://author-xxxxxx-xxxxxxx.adobeaemcloud.com

    2. Posizione del certificato SSL: inserite il percorso del certificato SSL archiviato in un bucket. Amazon S3 Lo usi per connetterti ad AEM On-Premise con una connessione SSL sicura.

    3. Autorizzazione: attiva o disattiva le informazioni dell'elenco di controllo degli accessi (ACL) per i tuoi documenti, se disponi di un ACL e desideri utilizzarlo per il controllo degli accessi. L'ACL specifica a quali documenti possono accedere utenti e gruppi. Le informazioni ACL vengono utilizzate per filtrare i risultati della ricerca in base all'accesso dell'utente o del relativo gruppo ai documenti. Per ulteriori informazioni, consulta Filtraggio del contesto utente.

    4. Autenticazione: scegli l'autenticazione di base o l'autenticazione OAuth 2.0. Quindi scegli un AWS Secrets Manager segreto esistente o crea un nuovo segreto per archiviare Adobe Experience Manager le tue credenziali. Se scegli di creare un nuovo segreto, si apre una finestra AWS Secrets Manager segreta.

      Se hai scelto Autenticazione di base, inserisci un nome per il segreto, il nome utente e la password del Adobe Experience Manager sito. L'utente deve disporre dell'autorizzazione di amministratore o essere un utente amministratore.

      Se hai scelto l'autenticazione OAuth 2.0 e utilizzi AEM On-Premise, inserisci un nome per il segreto, l'ID client, il segreto del client e la chiave privata. Se utilizzi AEM come servizio cloud, inserisci un nome per il segreto, l'ID client, il segreto del cliente, la chiave privata, l'ID dell'organizzazione, l'ID tecnico dell'account e l'host Adobe Identity Management System (IMS).

      Salva e aggiungi il tuo segreto.

    5. Virtual Private Cloud (VPC): puoi scegliere di utilizzare un VPC. In tal caso, è necessario aggiungere sottoreti e gruppi di sicurezza VPC.

    6. Identity crawler: specifica se attivare il crawler di identità. Amazon Kendra Il crawler di identità utilizza le informazioni dell'elenco di controllo degli accessi (ACL) per i documenti per filtrare i risultati della ricerca in base all'accesso dell'utente o del gruppo di appartenenza ai documenti. Se disponi di un ACL per i tuoi documenti e scegli di utilizzarlo, puoi anche scegliere di attivare il crawler di identità per configurare il filtraggio Amazon Kendra contestuale dell'utente dei risultati di ricerca. Altrimenti, se il crawler di identità è disattivato, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, in alternativa puoi utilizzare l'PutPrincipalMappingAPI per caricare le informazioni di accesso di utenti e gruppi per il filtraggio del contesto degli utenti.

    7. IAM ruolo: scegli un IAM ruolo esistente o creane uno nuovo IAM per accedere alle credenziali del repository e indicizzare il contenuto.

      Nota

      IAM i ruoli utilizzati per gli indici non possono essere utilizzati per le fonti di dati. Se non sei sicuro che un ruolo esistente venga utilizzato per un indice o una FAQ, scegli Crea un nuovo ruolo per evitare errori.

    8. Scegli Next (Successivo).

  7. Nella pagina Configura le impostazioni di sincronizzazione, inserisci le seguenti informazioni:

    1. Ambito di sincronizzazione: imposta i limiti per la scansione di determinati tipi di contenuto, componenti della pagina e percorsi root e filtra i contenuti utilizzando modelli di espressioni regex.

      1. Tipi di contenuto: scegliete se eseguire la scansione solo delle pagine o delle risorse o di entrambe.

      2. (Facoltativo) Configurazione aggiuntiva: configura le seguenti impostazioni:

        • Componenti della pagina: i nomi specifici dei componenti della pagina. Il Page Component è un componente di pagina estensibile progettato per funzionare con l'editor di Adobe Experience Manager modelli e consente di assemblare i componenti della pagina header/footer e della struttura con l'editor di modelli.

        • Varianti dei frammenti di contenuto: i nomi specifici delle varianti dei frammenti di contenuto. I frammenti di contenuto consentono di progettare, creare, curare e pubblicare contenuti indipendenti dalla pagina in. Adobe Experience Manager Consentono di preparare contenuti pronti per l'uso su più canali. locations/over

        • Percorsi principali: i percorsi principali verso contenuti specifici.

        • Modelli Regex: i modelli di espressioni regolari per includere o escludere determinate pagine e risorse.

    2. Modalità di sincronizzazione: scegli come aggiornare l'indice quando il contenuto della fonte di dati cambia. Quando sincronizzi l'origine dati con Amazon Kendra per la prima volta, tutto il contenuto viene sottoposto a scansione e indicizzato per impostazione predefinita. Se la sincronizzazione iniziale non è riuscita, devi eseguire una sincronizzazione completa dei dati, anche se non scegli la sincronizzazione completa come opzione della modalità di sincronizzazione.

      • Sincronizzazione completa: indicizza di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

      • Sincronizzazione nuova e modificata: indicizza solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra può utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

      • Sincronizzazione nuova, modificata ed eliminata: indicizza solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra può utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

    3. ID del fuso orario: se utilizzate AEM On-Premise e il fuso orario del server è diverso dal fuso orario del connettore o dell'indice Amazon Kendra AEM, potete specificare il fuso orario del server da allineare al connettore o all'indice AEM. Il fuso orario predefinito per AEM On-Premise è il fuso orario del connettore o dell'indice AEM. Amazon Kendra Il fuso orario predefinito per AEM come servizio cloud è l'ora media di Greenwich.

    4. Pianificazione di esecuzione della sincronizzazione, per frequenza: scegli la frequenza con cui sincronizzare il contenuto della fonte di dati e aggiornare l'indice.

    5. Scegli Next (Successivo).

  8. Nella pagina Imposta mappature dei campi, inserisci le seguenti informazioni:

    1. Seleziona uno dei campi di origine dati predefiniti Amazon Kendra generati che desideri mappare all'indice. Per aggiungere campi di origine dati personalizzati, crea un nome di campo indice a cui mappare e il tipo di dati del campo.

    2. Scegli Next (Successivo).

  9. Nella pagina Rivedi e crea, verifica che le informazioni che hai inserito siano corrette, quindi seleziona Aggiungi origine dati. Puoi anche scegliere di modificare le tue informazioni da questa pagina. L'origine dati verrà visualizzata nella pagina Origini dati dopo che l'origine dati sarà stata aggiunta correttamente.

API

Per connettersi Amazon Kendra a Adobe Experience Manager

È necessario specificare un codice JSON dello schema dell'origine dati utilizzando l'TemplateConfigurationAPI. È necessario fornire le seguenti informazioni:

  • Origine dati: specifica il tipo di origine dati come AEM quando usi lo schema TemplateConfigurationJSON. Specificate anche l'origine dati come TEMPLATE quando chiamate l'CreateDataSourceAPI.

  • URL host AEM: specifica l'URL dell'Adobe Experience Managerhost. Ad esempio, se utilizzi AEM On-Premise, includi il nome host e la porta:. https://hostname:port Oppure, se utilizzi AEM come servizio cloud, puoi utilizzare l'URL dell'autore:. https://author-xxxxxx-xxxxxxx.adobeaemcloud.com

  • Modalità di sincronizzazione: specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Quando sincronizzi l'origine dati con Amazon Kendra per la prima volta, tutto il contenuto viene sottoposto a scansione e indicizzato per impostazione predefinita. Se la sincronizzazione iniziale non è riuscita, devi eseguire una sincronizzazione completa dei dati, anche se non scegli la sincronizzazione completa come opzione della modalità di sincronizzazione. Puoi scegliere tra:

    • FORCED_FULL_CRAWLper indicizzare nuovamente tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

    • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra può utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

    • CHANGE_LOGper indicizzare solo contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra può utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • Tipo di autenticazione: specifica il tipo di autenticazione che desideri utilizzare, Basic oppureOAuth2.

  • Tipo AEM: specifica il tipo da Adobe Experience Manager utilizzare, oppure. CLOUD ON_PREMISE

  • Secret Amazon Resource Name (ARN): se desideri utilizzare l'autenticazione di base per AEM On-Premise o Cloud, fornisci un codice segreto che memorizza le credenziali di autenticazione del nome utente e della password. Fornisci l'Amazon Resource Name (ARN) di un AWS Secrets Manager segreto. Il segreto viene archiviato in una struttura JSON con le seguenti chiavi:

    { "aemUrl": "Adobe Experience Manager On-Premise host URL", "username": "user name with admin permissions", "password": "password with admin permissions" }

    Se desideri utilizzare l'autenticazione OAuth 2.0 per AEM On-Premise, il segreto viene archiviato in una struttura JSON con le seguenti chiavi:

    { "aemUrl": "Adobe Experience Manager host URL", "clientId": "client ID", "clientSecret": "client secret", "privateKey": "private key" }

    Se desideri utilizzare l'autenticazione OAuth 2.0 per AEM come servizio cloud, il segreto viene archiviato in una struttura JSON con le seguenti chiavi:

    { "clientId": "client ID", "clientSecret": "client secret", "privateKey": "private key", "orgId": "organization ID", "technicalAccountId": "technical account ID", "imsHost": "Adobe Identity Management System (IMS) host" }
  • IAM ruolo: specifica RoleArn quando chiami CreateDataSource per fornire a un IAM ruolo le autorizzazioni per accedere al tuo Secrets Manager segreto e chiamare il pubblico richiesto APIs per il connettore Adobe Experience Manager e. Amazon Kendra Per ulteriori informazioni, consulta IAM i ruoli per le fonti di dati di Adobe Experience Manager.

Puoi anche aggiungere le seguenti funzionalità opzionali:

  • Virtual Private Cloud (VPC): VpcConfiguration specifica quando si chiama. CreateDataSource Per ulteriori informazioni, consulta Configurazione Amazon Kendra per l'utilizzo di un Amazon VPC.

  • ID del fuso orario: se utilizzate AEM On-Premise e il fuso orario del server è diverso dal fuso orario del connettore o dell'indice Amazon Kendra AEM, potete specificare il fuso orario del server da allineare al connettore o all'indice AEM.

    Il fuso orario predefinito per AEM On-Premise è il fuso orario del connettore o dell'indice AEM. Amazon Kendra Il fuso orario predefinito per AEM come servizio cloud è l'ora media di Greenwich.

    Per informazioni sui fusi orari supportati IDs, consultate Schema Adobe Experience ManagerJSON.

  • Filtri di inclusione ed esclusione: specificate se includere o escludere determinate pagine e risorse.

    Nota

    La maggior parte delle fonti di dati utilizza modelli di espressioni regolari, che sono modelli di inclusione o esclusione denominati filtri. Se si specifica un filtro di inclusione, viene indicizzato solo il contenuto che corrisponde al filtro di inclusione. Qualsiasi documento che non corrisponde al filtro di inclusione non viene indicizzato. Se si specifica un filtro di inclusione ed esclusione, i documenti che corrispondono al filtro di esclusione non vengono indicizzati, anche se corrispondono al filtro di inclusione.

  • Identity crawler: specifica se attivare il crawler di identità. Amazon Kendra Il crawler di identità utilizza le informazioni dell'elenco di controllo degli accessi (ACL) per i documenti per filtrare i risultati della ricerca in base all'accesso dell'utente o del gruppo di appartenenza ai documenti. Se disponi di un ACL per i tuoi documenti e scegli di utilizzarlo, puoi anche scegliere di attivare il crawler di identità per configurare il filtraggio Amazon Kendra contestuale dell'utente dei risultati di ricerca. Altrimenti, se il crawler di identità è disattivato, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, in alternativa puoi utilizzare l'PutPrincipalMappingAPI per caricare le informazioni di accesso di utenti e gruppi per il filtraggio del contesto degli utenti.

  • Mappature dei campi: scegli di mappare i campi delle sorgenti dati di Adobe Experience Manager ai campi indice. Amazon Kendra Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.

    Nota

    Il campo del corpo del documento o l'equivalente del corpo del documento per i documenti è necessario per Amazon Kendra eseguire la ricerca nei documenti. È necessario mappare il nome del campo del corpo del documento nella fonte dati al nome del campo indice_document_body. Tutti gli altri campi sono facoltativi.

Per un elenco di altre importanti chiavi JSON da configurare, consulta lo schema Adobe Experience Manager del modello.