View a markdown version of this page

SharePoint connettore V2.0 - Amazon Kendra
Funzionalità supportatePrerequisitiIstruzioni di connessioneNote

Amazon Kendra non è più aperto a nuovi clienti. Per funzionalità simili a Amazon Kendra, esplora le Knowledge Bases di Amazon Bedrock. Ulteriori informazioni.

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

SharePoint connettore V2.0

SharePoint è un servizio collaborativo per la creazione di siti Web che puoi utilizzare per personalizzare i contenuti Web e creare pagine, siti, raccolte di documenti ed elenchi. Puoi utilizzarlo Amazon Kendra per indicizzare la tua fonte di SharePoint dati.

Amazon Kendra attualmente supporta SharePoint Online and SharePoint Server (2013 e Subscription Edition).

Nota

SharePoint V1.0 SharePointConfiguration connettore/API terminato nel 2023. Ti consigliamo di migrare o utilizzare il SharePoint connettore V2.0 / TemplateConfiguration API.

Per la risoluzione dei problemi relativi al connettore dell'origine Amazon Kendra SharePoint dati, consulta. Risoluzione dei problemi relativi alle origini dati

Funzionalità supportate

Amazon Kendra SharePoint il connettore per origini dati supporta le seguenti funzionalità:

  • Mappature dei campi

  • controllo degli accessi degli utenti

  • Inclusion/exclusion filtri

  • Sincronizzazione completa e incrementale dei contenuti

  • Cloud privato virtuale (VPC)

Prerequisiti

Prima di poterla utilizzare Amazon Kendra per indicizzare l'origine SharePoint dati, apporta queste modifiche ai tuoi account SharePoint . AWS

È necessario fornire le credenziali di autenticazione, che vengono archiviate in modo sicuro e segreto. AWS Secrets Manager

Nota

Ti consigliamo di aggiornare o ruotare regolarmente le credenziali e il segreto. e fornire solo il livello di accesso necessario per motivi di sicurezza. Si sconsiglia di riutilizzare le credenziali e i segreti tra le diverse fonti di dati e le versioni 1.0 e 2.0 dei connettori (ove applicabile).

In SharePoint Online, assicurati di avere:

  • Hai copiato gli URL della tua SharePoint istanza. Il formato per l'URL host inserito è. https://yourdomain.com/sites/mysite L'URL deve iniziare conhttps.

  • Hai copiato il nome di dominio dell'URL della tua SharePoint istanza.

  • Ho notato le tue credenziali di autenticazione di base contenenti il nome utente e la password con le autorizzazioni di amministratore del sito per la connessione a Online. SharePoint

  • Avere disattivato le Impostazioni di sicurezza predefinite nel portale di Azure utilizzando un utente amministrativo. Per ulteriori informazioni sulla gestione delle impostazioni di sicurezza predefinite nel portale di Azure, consulta la documentazione Microsoft su come utilizzare le impostazioni predefinite di enable/disable sicurezza.

  • L'autenticazione a più fattori (MFA) è stata disattivata nel tuo SharePoint account, in modo da non impedirne la scansione dei Amazon Kendra contenuti. SharePoint

  • Se si utilizza un tipo di autenticazione diverso dall'autenticazione di base: è stato copiato l'ID tenant dell'istanza. SharePoint Per informazioni su come trovare l’ID tenant, consulta Trovare l’ID tenant di Microsoft 365.

  • Se devi migrare all'autenticazione degli utenti nel cloud con Microsoft Entra, consulta la documentazione Microsoft sull'autenticazione cloud.

  • Per l'autenticazione OAuth 2.0 e l'autenticazione con token di aggiornamento OAuth 2.0: Ho preso nota delle credenziali di autenticazione di base contenenti il nome utente e la password che usi per connetterti a SharePoint Online e l'ID client e il segreto client generati dopo la registrazione con Azure AD. SharePoint

    • Se non utilizzi ACL, hai aggiunto le seguenti autorizzazioni:

      Microsoft Graph SharePoint

      • Notes.Read.All (Applicazione): leggi tutti i taccuini OneNote

      • Sites.Read.All (Applicazione): legge gli elementi in tutte le raccolte siti

      • AllSites.Read (Delegato): legge gli elementi in tutte le raccolte siti
      Nota

      Note.Read.All e Sites.Read.All sono obbligatori solo se si desidera eseguire la scansione OneNote dei documenti.

      Se desideri eseguire la scansione di siti specifici, l'autorizzazione può essere limitata a siti specifici anziché a tutti i siti disponibili nel dominio. È possibile configurare l'autorizzazione Sites.Selected (Applicazione). Con questa autorizzazione API, è necessario impostare l'autorizzazione di accesso su ogni sito in modo esplicito tramite l'API Microsoft Graph. Per ulteriori informazioni, consulta il blog di Microsoft sulle Sites.Selected autorizzazioni.

    • Se utilizzi ACL, hai aggiunto le seguenti autorizzazioni:

      Microsoft Graph SharePoint

      • Group.Member.Read.All(Applicazione): leggi tutte le appartenenze ai gruppi

      • Notes.Read.All (Applicazione): leggi tutti i taccuini OneNote

      • Sites.FullControl.All(Delegato): necessario per recuperare gli ACL dei documenti

      • Sites.Read.All (Applicazione): legge gli elementi in tutte le raccolte siti

      • User.Read.All (Applicazione): legge i profili completi di tutti gli utenti

      • AllSites.Read (Delegato): legge gli elementi in tutte le raccolte siti
      Nota

      GroupMember.Read.All e User.Read.All sono obbligatori solo se Identity Crawler è attivato.

      Se desideri eseguire la scansione di siti specifici, l'autorizzazione può essere limitata a siti specifici anziché a tutti i siti disponibili nel dominio. Si configura l'autorizzazione Sites.Selected (Applicazione). Con questa autorizzazione API, è necessario impostare l'autorizzazione di accesso su ogni sito in modo esplicito tramite l'API Microsoft Graph. Per ulteriori informazioni, consulta il blog di Microsoft sulle Sites.Selected autorizzazioni.

  • Per App-Only l'autenticazione di Azure AD: chiave privata e ID client generati dopo la registrazione SharePoint con Azure AD. Nota anche il certificato. X.509

    • Se non utilizzi ACL, hai aggiunto le seguenti autorizzazioni:

      SharePoint

      • Sites.Read.All (Applicazione): obbligatorio per accedere agli elementi e agli elenchi in tutte le raccolte di siti
      Nota

      Se si desidera eseguire la scansione di siti specifici, l'autorizzazione può essere limitata a siti specifici anziché a tutti i siti disponibili nel dominio. L'utente configura l'autorizzazione Sites.Selected (Applicazione). Con questa autorizzazione API, è necessario impostare l'autorizzazione di accesso su ogni sito in modo esplicito tramite l'API Microsoft Graph. Per ulteriori informazioni, consulta il blog di Microsoft sulle Sites.Selected autorizzazioni.

    • Se utilizzi ACL, hai aggiunto le seguenti autorizzazioni:

      SharePoint

      • Sites.FullControl.All(Applicazione): necessario per recuperare gli ACL dei documenti
      Nota

      Se desideri eseguire la scansione di siti specifici, l'autorizzazione può essere limitata a siti specifici anziché a tutti i siti disponibili nel dominio. L'utente configura l'autorizzazione Sites.Selected (Applicazione). Con questa autorizzazione API, è necessario impostare l'autorizzazione di accesso su ogni sito in modo esplicito tramite l'API Microsoft Graph. Per ulteriori informazioni, consulta il blog di Microsoft sulle Sites.Selected autorizzazioni.

  • Per SharePoint App-Only l'autenticazione: ho preso nota dell'ID SharePoint cliente e del segreto client generati durante la concessione dell'autorizzazione ad SharePoint App Only e dell'ID client e del segreto client generati al momento della registrazione SharePoint dell'app con Azure AD.

    Nota

    SharePoint App-Only L'autenticazione non è supportata per la versione SharePoint 2013.

    • (Facoltativo) Se stai eseguendo la scansione di OneNote documenti e utilizzando Identity crawler , hai aggiunto le seguenti autorizzazioni:

      Microsoft Graph

      • GroupMember.Read.All(Applicazione): leggi tutte le appartenenze ai gruppi

      • Notes.Read.All (Applicazione): leggi tutti i taccuini OneNote

      • Sites.Read.All (Applicazione): legge gli elementi in tutte le raccolte siti

      • User.Read.All (Applicazione): legge i profili completi di tutti gli utenti
    Nota

    Non sono richieste autorizzazioni API per la scansione delle entità utilizzando l'autenticazione e l'autenticazione di base. SharePoint App-only

In SharePoint Server, assicurati di avere:

  • Hai copiato gli URL della tua SharePoint istanza e il nome di dominio dei tuoi SharePoint URL. Il formato per l'URL host inserito è. https://yourcompany/sites/mysite L'URL deve iniziare conhttps.

    Nota

    (On-premise/server) Amazon Kendra controlla se le informazioni sull'endpoint incluse sono le stesse informazioni sull'endpoint specificate nei dettagli di configurazione dell'origine dati. AWS Secrets Manager Questo aiuta a proteggersi dal confuso problema sostitutivo, che è un problema di sicurezza in cui un utente non dispone dell'autorizzazione per eseguire un'azione ma la 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.

  • L'autenticazione a più fattori (MFA) è stata disattivata nel tuo SharePoint account, in modo da non impedirne Amazon Kendra la scansione dei contenuti. SharePoint

  • Se utilizzi l'autenticazione per il controllo degli SharePoint App-Only accessi:

    • Ha copiato l'ID SharePoint cliente generato al momento della registrazione dell'app solo a livello di sito. Il formato dell'ID cliente è ClientId @TenantId. Ad esempio, ffa956f3-8f89-44e7-b0e4-49670756342c@888d0b57-69f1-4fb8-957f-e1f0bedf82fe.

    • Ha copiato il segreto del SharePoint cliente generato al momento della registrazione dell'app solo a livello di sito.

    Nota: poiché gli ID client e i segreti client vengono generati per singoli siti solo quando registri l'autenticazione SharePoint Server for App Only, per l'autenticazione solo SharePoint app è supportato un solo URL del sito.

    Nota

    SharePoint App-Only L'autenticazione non è supportata per la versione SharePoint 2013.

  • Se si utilizza un ID e-mail con dominio personalizzato per il controllo degli accessi:

    • Ho annotato il valore del tuo dominio email personalizzato, ad esempio: "». amazon.com

  • Se utilizzi l'ID e-mail con il dominio ottenuto dall'autorizzazione IDP, hai copiato:

    • LDAP Server Endpoint (endpoint del server LDAP che include protocollo e numero di porta). Ad esempio: ldap://example.com:389.

    • LDAP Search Base (base di ricerca dell'utente LDAP). Ad esempio: CN=Users,DC=sharepoint,DC=com.

    • Nome utente LDAP e password LDAP.

  • Credenziali di autenticazione NTLM configurate o credenziali di autenticazione Kerberos configurate contenenti un nome utente (nome utente dell'account) e una password (password dell'SharePoint account). SharePoint

Nel tuo, assicurati di Account AWS avere:

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

  • Ha creato un IAM ruolo per l'origine dati e, se si utilizza l'API, ha annotato l'ARN del IAM ruolo.

    Nota

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

  • Hai archiviato le tue credenziali di SharePoint autenticazione in modo AWS Secrets Manager segreto e, se utilizzi l'API, hai annotato l'ARN del segreto.

    Nota

    Ti consigliamo di aggiornare o ruotare regolarmente le credenziali e il segreto. e fornire solo il livello di accesso necessario per motivi di sicurezza. Ti sconsigliamo di riutilizzare le credenziali e i segreti tra diverse fonti di dati e tra le versioni 1.0 e 2.0 dei connettori (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 nuovo Secrets Manager segreto quando connetti l'origine SharePoint dati a. Amazon Kendra Se utilizzi l'API, devi fornire l'ARN di un IAM ruolo e un Secrets Manager segreto esistenti e un ID di indice.

Istruzioni di connessione

Per connetterti Amazon Kendra alla tua fonte di SharePoint dati, devi fornire i dettagli delle tue SharePoint credenziali in modo da Amazon Kendra poter accedere ai tuoi dati. Se non hai ancora configurato SharePoint per Amazon Kendra SeePrerequisiti.

Console: SharePoint Online

Per connetterti Amazon Kendra a SharePoint Online

  1. Accedi Console di gestione AWS 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 di controllo dell'accesso utente in Impostazioni dell'indice.

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

  4. Nella pagina Aggiungi origine dati, scegli SharePoint connettore, quindi scegli Aggiungi connettore. Se usi la versione 2 (se applicabile), scegli il SharePoint connettore con il tag V2.0 "».

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

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

    2. (Facoltativo) Descrizione: inserisci una descrizione opzionale per l'origine dati.

    3. Nella lingua predefinita: scegli una lingua per filtrare i documenti per l'indice. Salvo diversa indicazione, 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. Metodo di hosting: scegli SharePoint online.

    2. URL del sito specifici per il tuo SharePoint repository: inserisci gli URL dell'host. SharePoint Il formato per gli URL host che inserisci è. https://yourdomain.sharepoint.com/sites/mysite L’URL deve iniziare con il protocollo https. Separa gli URL con una nuova riga. È possibile aggiungere fino a 100 URL.

    3. Dominio: inserisci il SharePoint dominio. Ad esempio, il dominio nell'URL https://yourdomain.sharepoint.com/sites/mysite èyourdomain.

    4. 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 gruppo ai documenti. Per ulteriori informazioni, vedere Filtraggio del contesto utente.

      Puoi anche scegliere il tipo di ID utente, se il nome principale dell'utente o l'email dell'utente recuperata dal portale di Azure. Se non lo specifichi, l'email viene utilizzata per impostazione predefinita.

    5. Autenticazione: scegli l'autenticazione di base, OAuth 2.0, Azure AD, l'autenticazione o App-Only l'autenticazione con SharePoint App-Only token di aggiornamento OAuth 2.0. Puoi scegliere un AWS Secrets Manager segreto esistente per archiviare le tue credenziali di autenticazione o crearne uno segreto.

      1. Se si utilizza l'autenticazione di base, il segreto deve includere un nome, un nome SharePoint utente e una password segreti.

      2. Se si utilizza l'autenticazione OAuth 2.0, il segreto deve includere l'ID SharePoint tenant, il nome segreto, il nome SharePoint utente, la password, l'ID client di Azure AD generato al momento della registrazione SharePoint in Azure AD e il segreto client di Azure AD generato al momento della registrazione in Azure AD. SharePoint

      3. Se si utilizza App-Only l'autenticazione di Azure AD, il segreto deve includere l'ID SharePoint tenant, il X.509 certificato autofirmato di Azure AD, il nome segreto, l'ID client di Azure AD generato al momento della registrazione SharePoint in Azure AD e la chiave privata per autenticare il connettore per Azure AD.

      4. Se usi SharePoint App-Only l'autenticazione, il tuo segreto deve includere l'ID SharePoint tenant, il nome segreto, l'ID SharePoint client che hai generato quando hai registrato App Only a livello di tenant, il segreto SharePoint client generato quando ti registri per App Only a livello di tenant, l'ID client di Azure AD generato quando ti registri SharePoint in Azure AD e il segreto client di Azure AD generato quando ti registri SharePoint ad Azure AD.

        ClientID@TenantIdIl formato dell'ID client è. SharePoint Ad esempio, ffa956f3-8f89-44e7-b0e4-49670756342c@888d0b57-69f1-4fb8-957f-e1f0bedf82fe.

      5. Se si utilizza l'autenticazione con token di aggiornamento OAuth 2.0, il segreto deve includere l'ID SharePoint tenant, il nome segreto, l'ID client Azure AD univoco generato al momento della registrazione SharePoint in Azure AD, il segreto client di Azure AD generato al momento della registrazione ad Azure AD, il token di aggiornamento generato per la connessione SharePoint a. Amazon Kendra SharePoint

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

    7. 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) dei documenti per filtrare i risultati della ricerca in base all'accesso dell'utente o del gruppo 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 Amazon Kendra filtro del contesto utente dei risultati di ricerca. Altrimenti, se l’identità del crawler è disattivata, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, puoi in alternativa utilizzare l'PutPrincipalMappingAPI per caricare le informazioni di accesso di utenti e gruppi per il filtraggio del contesto utente.

      Puoi anche scegliere di eseguire la mappatura dei gruppi locali o la mappatura dei gruppi di Azure Active Directory.

      Nota

      La mappatura dei gruppi AD è disponibile solo per OAuth 2.0, token di aggiornamento OAuth 2.0 e autenticazione solo app. SharePoint

    8. IAM ruolo: scegli un IAM ruolo esistente o crea un nuovo IAM ruolo per accedere alle credenziali del repository e ai contenuti dell'indice.

      Nota

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

    9. Scegli Next (Successivo).

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

    1. In Ambito di sincronizzazione, scegli tra le seguenti opzioni:

      1. Seleziona entità: scegli le entità da sottoporre a scansione. È possibile scegliere di eseguire la scansione di tutte le entità o di qualsiasi combinazione di file, allegati, collegamenti, pagine, eventi , commenti ed elenchi di dati.

      2. Nella configurazione aggiuntiva, per i modelli di espressione regolare delle entità: aggiungi modelli di espressione regolare per collegamenti , pagine ed eventi per includere entità specifiche invece di sincronizzare tutti i tuoi documenti.

      3. Schemi regex: aggiungi modelli di espressioni regolari per includere o escludere i file in base al percorso del file, al nome del file, al tipo di file, al nome della OneNote sezione e al nome della OneNote pagina invece di sincronizzare tutti i tuoi documenti. Puoi aggiungerne fino a 100.

        Nota

        OneNote la scansione è disponibile solo per l'autenticazione OAuth 2.0, il token di aggiornamento OAuth 2.0 e l'autenticazione App Only. SharePoint

    2. Per la modalità di sincronizzazione, scegli come aggiornare l'indice quando il contenuto dell'origine dati cambia. Alla prima sincronizzazione dell’origine dati con Amazon Kendra , per impostazione predefinita vengono sincronizzati tutti i contenuti.

      • Sincronizzazione completa: sincronizza tutti i contenuti indipendentemente dallo stato di sincronizzazione precedente.

      • Sincronizzazione di documenti nuovi o modificati: sincronizza solo i documenti nuovi o modificati.

      • Sincronizzazione documenti nuovi, modificati o eliminati: sincronizza solo i documenti nuovi, modificati ed eliminati.

    3. Nella pianificazione dell'esecuzione della sincronizzazione, per Frequenza: scegli la frequenza con cui sincronizzare il contenuto dell'origine dati e aggiornare l'indice.

    4. Scegli Next (Successivo).

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

    1. Campi di origine dati predefiniti: seleziona tra i campi dell'origine dati predefiniti Amazon Kendra generati che desideri mappare al tuo indice.

    2. Aggiungi campo: per aggiungere campi di origine dati personalizzati per creare un nome di campo indice a cui mappare e il tipo di dati del campo.

    3. Scegli Next (Successivo).

  9. Nella pagina Rivedi e crea, verifica che le informazioni inserite 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 è stata aggiunta correttamente.

Console: SharePoint Server

Per connettersi Amazon Kendra a SharePoint

  1. Accedi Console di gestione AWS 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 di controllo dell'accesso utente in Impostazioni dell'indice.

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

  4. Nella pagina Aggiungi origine dati, scegli SharePoint connettore, quindi scegli Aggiungi connettore. Se usi la versione 2 (se applicabile), scegli il SharePoint connettore con il tag V2.0 "».

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

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

    2. (Facoltativo) Descrizione: inserisci una descrizione opzionale per l'origine dati.

    3. Nella lingua predefinita: scegli una lingua per filtrare i documenti per l'indice. Salvo diversa indicazione, 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. Metodo di hosting: scegli il SharePoint server.

    2. Scegli SharePoint la versione: scegli SharePoint 2013 o SharePoint (edizione in abbonamento).

    3. URL del sito specifici per il tuo SharePoint repository: inserisci gli URL dell'host. SharePoint Il formato per gli URL host che inserisci è. https://yourcompany/sites/mysite L’URL deve iniziare con il protocollo https. Separa gli URL con una nuova riga. È possibile aggiungere fino a 100 URL.

    4. Dominio: inserisci il SharePoint dominio. Ad esempio, il dominio nell'URL https://yourcompany/sites/mysite è yourcompany

    5. Posizione del certificato SSL: inserisci il Amazon S3 percorso del file del certificato SSL.

    6. (Facoltativo) Per il proxy Web: immettete il nome host (senza il https:// protocollo http:// or) e il numero di porta utilizzato dal protocollo di trasporto degli URL dell'host. Il valore numerico del numero di porta deve essere compreso tra 0 e 65535.

    7. 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 gruppo ai documenti. Per ulteriori informazioni, vedere Filtraggio del contesto utente.

      Per SharePoint Server puoi scegliere tra le seguenti opzioni ACL:

      1. ID e-mail con dominio da IDP: l'ID utente si basa sugli ID e-mail i cui domini sono stati recuperati dal provider di identità (IDP) sottostante. Fornisci i dettagli della connessione IDP nel tuo Secrets Manager account segreto come parte dell'autenticazione.

      2. ID e-mail con dominio personalizzato: l'ID utente si basa sul valore del dominio e-mail personalizzato. Ad esempio, "amazon.com". Il dominio e-mail verrà utilizzato per creare l’ID e-mail per il controllo degli accessi. Devi inserire il tuo dominio email personalizzato.

      3. Dominio\ Utente con dominio: l'ID utente è costruito utilizzando un formato Dominio\ ID utente. È necessario fornire un nome di dominio valido. Ad esempio: per "sharepointuser" costruire il controllo degli accessi.

    8. Per l'autenticazione, scegli l' SharePoint App-Only autenticazione, l'autenticazione NTLM o l'autenticazione Kerberos. Puoi scegliere un AWS Secrets Manager segreto esistente per archiviare le tue credenziali di autenticazione o crearne uno.

      1. Se si utilizza l'autenticazione NTLM o l'autenticazione Kerberos, il segreto deve includere un nome, un nome SharePoint utente e una password segreti.

        In caso di utilizzo di ID e-mail con dominio di IDP, inserisci anche:

        • LDAP Server Endpoint: endpoint del server LDAP, inclusi protocollo e numero di porta. Ad esempio: ldap://example.com:389.

        • Base di ricerca LDAP: base di ricerca dell'utente LDAP. Ad esempio: CN=Users,DC=sharepoint,DC=com.

        • Nome utente LDAP: il nome utente LDAP.

        • Password LDAP: la tua password LDAP.

      2. Se si utilizza SharePoint App-Only l'autenticazione, il segreto deve includere un nome segreto, l'ID SharePoint cliente generato al momento della registrazione dell'App Only a livello di sito, il segreto SharePoint client generato al momento della registrazione ad App Only a livello di sito.

        Il formato dell'ID SharePoint cliente èClientID@TenantId. Ad esempio, ffa956f3-8f89-44e7-b0e4-49670756342c@888d0b57-69f1-4fb8-957f-e1f0bedf82fe.

        Nota: poiché gli ID client e i segreti client vengono generati per singoli siti solo quando si registra l'autenticazione SharePoint Server for App Only, è supportato un solo URL del sito per SharePoint l'autenticazione App Only.

        In caso di utilizzo di ID e-mail con dominio di IDP, inserisci anche:

        • Endpoint del server LDAP: endpoint del server LDAP, inclusi protocollo e numero di porta. Ad esempio: ldap://example.com:389.

        • Base di ricerca LDAP: base di ricerca dell'utente LDAP. Ad esempio: CN=Users,DC=sharepoint,DC=com.

        • Nome utente LDAP: il nome utente LDAP.

        • Password LDAP: la tua password LDAP.

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

    10. 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) dei documenti per filtrare i risultati della ricerca in base all'accesso dell'utente o del gruppo 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 Amazon Kendra filtro del contesto utente dei risultati di ricerca. Altrimenti, se l’identità del crawler è disattivata, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, puoi in alternativa utilizzare l'PutPrincipalMappingAPI per caricare le informazioni di accesso di utenti e gruppi per il filtraggio del contesto utente.

      Puoi anche scegliere di eseguire la mappatura dei gruppi locali o la mappatura dei gruppi di Azure Active Directory.

      Nota

      La mappatura dei gruppi AD è disponibile solo per l'autenticazione App Only. SharePoint

    11. IAM ruolo: scegli un ruolo esistente o crea un nuovo IAM IAM ruolo per accedere alle credenziali del repository e indicizzare i contenuti.

      Nota

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

    12. Scegli Next (Successivo).

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

    1. In Ambito di sincronizzazione, scegli tra le seguenti opzioni:

      1. Seleziona entità: scegli le entità da sottoporre a scansione. È possibile scegliere di eseguire la scansione di tutte le entità o di qualsiasi combinazione di file, allegati, collegamenti, pagine , eventi ed elenchi di dati.

      2. Nella configurazione aggiuntiva, per i modelli di espressione regolare delle entità: aggiungi modelli di espressione regolare per collegamenti , pagine ed eventi per includere entità specifiche invece di sincronizzare tutti i tuoi documenti.

      3. Schemi regex: aggiungi modelli di espressioni regolari per includere o escludere i file in base al percorso del file Nome del file Tipo di file, nome della OneNote sezione e nome della OneNote pagina invece di sincronizzare tutti i tuoi documenti. Puoi aggiungerne fino a 100.

        Nota

        OneNote la scansione è disponibile solo per l'autenticazione solo SharePoint tramite app.

    2. Modalità di sincronizzazione: scegli come 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. È necessario eseguire una sincronizzazione completa dei dati se la sincronizzazione iniziale non è riuscita, anche se non si sceglie la sincronizzazione completa come opzione della modalità di sincronizzazione.

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

      • Nuova sincronizzazione modificata: indicizza solo i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi 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 puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

    3. In Sync run schedule, per Frequenza: scegli la frequenza con cui sincronizzare il contenuto dell'origine dati e aggiornare l'indice.

    4. Scegli Next (Successivo).

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

    1. Campi di origine dati predefiniti: seleziona tra i campi dell'origine dati predefiniti Amazon Kendra generati che desideri mappare al tuo indice.

    2. Aggiungi campo: per aggiungere campi di origine dati personalizzati per creare un nome di campo indice a cui mappare e il tipo di dati del campo.

    3. Scegli Next (Successivo).

  9. Nella pagina Rivedi e crea, verifica che le informazioni inserite 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 è stata aggiunta correttamente.

API

Per connettersi Amazon Kendra a SharePoint

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

  • Origine dati: specificare il tipo di origine dati utilizzato SHAREPOINTV2 quando si utilizza lo schema TemplateConfiguration JSON. Specifica inoltre l'origine dati come TEMPLATE quando chiami l'CreateDataSourceAPI.

  • Metadati degli endpoint del repository: specifica la fine dell'tenantIDdomainistanza. siteUrls SharePoint

  • 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. È necessario eseguire una sincronizzazione completa dei dati se la sincronizzazione iniziale non è riuscita, anche se non si sceglie la sincronizzazione completa come opzione della modalità di sincronizzazione. Puoi scegliere tra:

    • FORCED_FULL_CRAWLper indicizzare di nuovo 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 puoi 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 i contenuti nuovi e modificati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra puoi utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

  • Identity crawler: specifica se attivare il crawler Amazon Kendra di identità. Il crawler di identità utilizza le informazioni dell'elenco di controllo degli accessi (ACL) dei documenti per filtrare i risultati della ricerca in base all'accesso dell'utente o del gruppo 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 Amazon Kendra filtro del contesto utente dei risultati di ricerca. Altrimenti, se l’identità del crawler è disattivata, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, puoi in alternativa utilizzare l'PutPrincipalMappingAPI per caricare le informazioni di accesso di utenti e gruppi per il filtraggio del contesto utente.

    Nota

    L'Identity Crawler è disponibile solo se impostato su. crawlAcl true

  • Proprietà aggiuntive del repository: specificare:

    • (Per Azure AD) s3bucketName e s3certificateName che usi per archiviare il tuo certificato autofirmato di Azure AD. X.509

    • Tipo di autenticazione (auth_Type) che usi, seOAuth2,,OAuth2App,OAuth2Certificate, BasicOAuth2_RefreshToken, NTLM e. Kerberos

    • Versione (version) utilizzata, indipendentemente dal fatto che Server siaOnline. Se si utilizzaServer, è possibile specificare ulteriormente l'annuncio onPremVersion 2013 oSubscriptionEdition.

  • Secret Amazon Resource Name (ARN): fornisci l'Amazon Resource Name (ARN) di un Secrets Manager segreto che contiene le credenziali di autenticazione che hai creato nel tuo account. SharePoint

    Se usi SharePoint Online, puoi scegliere tra l'autenticazione Basic, OAuth 2.0, Azure AD e App Only. App-only SharePoint Di seguito è riportata la struttura JSON minima che deve essere segreta per ogni opzione di autenticazione:

    • Autenticazione di base

      {
    "userName": "SharePoint account user name",
    "password": "SharePoint account password"
}

    • Autenticazione OAuth 2.0

      {
    "clientId": "client id generated when registering SharePoint with Azure AD",
    "clientSecret": "client secret generated when registering SharePoint with Azure AD",
    "userName": "SharePoint account user name",
    "password": "SharePoint account password"
}

    • Autenticazione Azure AD App-Only 

      {
    "clientId": "client id generated when registering SharePoint with Azure AD",
    "privateKey": "private key to authorize connection with Azure AD"
}

    • SharePoint App-Onlyautenticazione 

      {
    "clientId": "client id generated when registering SharePoint for App Only at Tenant Level",
    "clientSecret": "client secret generated when registering SharePoint for App Only at Tenant Level",
    "adClientId": "client id generated while registering SharePoint with Azure AD",
    "adClientSecret": "client secret generated while registering SharePoint with Azure AD"
}

    • autenticazione con token di aggiornamento OAuth 2.0 

      {
    "clientId": "client id generated when registering SharePoint with Azure AD",
    "clientSecret": "client secret generated when registering SharePoint with Azure AD",
    "refreshToken": "refresh token generated to connect to SharePoint"
}

    Se si utilizza SharePoint Server, è possibile scegliere tra SharePoint App-Only autenticazione, autenticazione NTLM e autenticazione Kerberos. Di seguito è riportata la struttura JSON minima che deve essere segreta per ogni opzione di autenticazione:

    • SharePoint App-Onlyautenticazione 

      {
    "siteUrlsHash": "Hash representation of SharePoint site URLs",
    "clientId": "client id generated when registering SharePoint for App Only at Site Level",
    "clientSecret": "client secret generated when registering SharePoint for App Only at Site Level" 
}

    • SharePoint App-Onlyautenticazione con dominio dall'autorizzazione IDP 

      {
    "siteUrlsHash": "Hash representation of SharePoint site URLs",
    "clientId": "client id generated when registering SharePoint for App Only at Site Level",
    "clientSecret": "client secret generated when registering SharePoint for App Only at Site Level",
    "ldapUrl": "LDAP Account url eg. ldap://example.com:389",
    "baseDn": "LDAP Account base dn eg. CN=Users,DC=sharepoint,DC=com",
    "ldapUser": "LDAP account user name",
    "ldapPassword": "LDAP account password"
}

    • (solo server) autenticazione NTLM o Kerberos 

      {
    "siteUrlsHash": "Hash representation of SharePoint site URLs",
    "userName": "SharePoint account user name",
    "password": "SharePoint account password"
}

    • (Solo server) Autenticazione NTLM o Kerberos con dominio proveniente dall'autorizzazione IDP 

      {
    "siteUrlsHash": "Hash representation of SharePoint site URLs",
    "userName": "SharePoint account user name",
    "password": "SharePoint account password",
    "ldapUrl": "ldap://example.com:389",
    "baseDn": "CN=Users,DC=sharepoint,DC=com",
    "ldapUser": "LDAP account user name",
    "ldapPassword": "LDAP account password"
}

  • IAM ruolo: specifica RoleArn quando chiami CreateDataSource per fornire a un IAM ruolo le autorizzazioni per accedere al tuo account Secrets Manager segreto e per chiamare le API pubbliche richieste per il connettore e. SharePoint Amazon Kendra Per ulteriori informazioni, consulta IAM Ruoli per SharePoint le origini dati.

Puoi anche aggiungere le seguenti funzionalità opzionali:

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

  • Filtri di inclusione ed esclusione: puoi specificare se includere o escludere determinati file e altri contenuti OneNotes.

    Nota

    La maggior parte delle origini 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.

  • Mappature dei campi: scegli di mappare i campi dell'origine SharePoint dati ai campi dell'indice. Amazon Kendra Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.

    Nota

    Il campo relativo al corpo del documento o l'equivalente del corpo del documento è obbligatorio per poter Amazon Kendra effettuare la ricerca nei documenti. È necessario associare il nome del campo del corpo del documento nell'origine 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 SharePoint del modello.

Note

  • Il connettore supporta le mappature dei campi personalizzate solo per l'entità Files.

  • Per tutte le versioni SharePoint del server, il token ACL deve essere in minuscolo. Per e-mail con dominio da IDP e ID e-mail con ACL di dominio personalizzato, ad esempio:. user@sharepointuser.com Per Dominio\ Utente con ACL di dominio, ad esempio:. sharepoint2013\user

  • Quando gli Access Control Lists (ACL) sono abilitati, l'opzione «Sincronizza solo contenuti nuovi o modificati» non è disponibile a causa delle limitazioni delle SharePoint API. Si consiglia invece di utilizzare le modalità “Sincronizzazione completa” o “Sincronizzazione dei contenuti nuovi, modificati o eliminati” oppure di disabilitare le ACL se è necessario utilizzare questa modalità di sincronizzazione.

  • Il connettore non supporta la modalità di registro delle modifiche/la sincronizzazione dei contenuti nuovi o modificati per il SharePoint 2013.

  • Se il nome di un’entità contiene un carattere %, il connettore ignorerà questi file a causa delle limitazioni dell’API.

  • OneNote può essere scansionato dal connettore solo utilizzando un ID tenant e con OAuth 2.0, token di aggiornamento OAuth 2.0 o autenticazione solo app attivata per la versione online. SharePoint SharePoint

  • Il connettore esegue la scansione della prima sezione di un OneNote documento utilizzando solo il nome predefinito, anche se il documento viene rinominato.

  • Il connettore esegue la ricerca per indicizzazione dei collegamenti nelle edizioni SharePoint Online e Subscription solo se Pagine e File sono selezionati come entità da sottoporre a scansione oltre ai collegamenti.

  • Il connettore esegue la scansione dei link nel SharePoint 2013 se Links è selezionato come entità da sottoporre a scansione.

  • Il connettore esegue la scansione degli allegati e dei commenti degli elenchi solo quando List Data è selezionato anche come entità da sottoporre a scansione.

  • Il connettore esegue il crawling degli allegati degli eventi solo quando anche Eventi è selezionato come entità da sottoporre a crawling.

  • Per la versione SharePoint online, il token ACL sarà in lettere minuscole. Ad esempio, se il nome principale dell'utente è MaryMajor@domain.com nel portale di Azure, il token ACL nel SharePoint connettore lo sarà. marymajor@domain.com

  • In Identity Crawler for SharePoint Online and Server, se desideri eseguire la scansione dei gruppi annidati, devi attivare la scansione locale e quella dei gruppi AD.

  • Se usi SharePoint Online e il nome principale dell'utente nel tuo portale di Azure è una combinazione di lettere maiuscole e minuscole, l' SharePoint API lo converte internamente in lettere minuscole. Per questo motivo, il Amazon Kendra SharePoint connettore imposta l'ACL in lettere minuscole.