Aiimi Insight Engine Habanero
User GuidesAiimi
  • Introducing Aiimi Insight Engine
  • Architecture
    • Overview and Key Concepts
    • Search Flows
      • Search Flow Types
      • Smart Filtering
      • Query and Prompt Classification
      • Search Algorithms
      • Extractive and Generative Models
    • Hosting Options
    • Architecture and How It Works
      • Agent Servers
        • Security Agent
        • Source Agent
        • Content Agent
        • Enrichment Agent
        • Job Agent
        • OCR Agent
        • Migration Agent
        • Tika Agent
      • Repository
        • Data Node
        • Proxy Node
        • Kibana Node
      • Gateway and User Interface
      • Document and Data Sources
    • Deployment Options
    • Security
      • User Security
      • Data and Document Security
        • Progressive Access
        • Privileged Access
      • Source System Security
      • Firewalling
      • Agent Servers
        • Security Agent
        • Source Agent
        • Content Agent
        • Enrichment Agent
        • Job Agent
        • OCR Agent
        • Migration Agent
        • Tika Agent
      • Repository
      • Gateway (Web Server)
      • Tools & Utilities
  • Installation
    • Elastic and Kibana Install (Windows)
    • Aiimi Insight Engine Installation (Windows)
      • Installation Security
      • Certificates in a Key Vault
      • SAR Configuration
      • CSOM Bridge Set Up
    • AI Services
      • Prerequisites
      • AI Enrichment Service
        • Installation and Setup
        • Enabling Enrichment Steps
        • Using AI Enrichment Steps
        • Performance and Concurrency
      • AI Model Service
        • Installation and Setup
        • Enabling Providers
        • Private Generative AI
        • Azure Open AI
        • Enabling AI History
        • HTML Cleaner Service
      • Configuration of Logging
      • Offline Set-up of Models
      • Using SSL
      • Running as a Service (Windows)
      • Using GPUs
      • AI and Semantic Search Set Up
        • Open & Closed Book AI
        • Semantic Search
          • Vectors for Semantic Search
          • Source Configuration
          • Sentence Transformer Models
          • Enrichment
          • Kibana
          • Final Search Flow
    • Email Threading Upgrade
  • Control Hub
    • Configurations
      • Config Management
      • Security Configurations
        • Security - General
        • Security - Source
          • Active Directory
          • Atlassian
          • Azure Active Directory
          • Builtin Security
          • Miro Security
          • Google Directory
          • Slack Security
        • Security - Sync
        • Security - Agents
        • Security - Scheduling
      • Source Configurations
        • Source - General
        • Source - Source
          • Alfresco Kafka
          • Azure Blob Storage
          • BBC Monitoring
          • Big Query Cataloguer
          • BIM360
          • CSV Data Loader
          • Confluence
          • Content Server
          • Data File Cataloguer
          • Document Store
          • DocuSign
          • Dropbox
          • Exchange 365
          • Filesystem
          • Google Bucket
          • Google Drive
          • Google Vault
          • Jira
          • JSON Data Loader
          • Livelink
          • Microsoft Teams
          • Mimecast
          • Miro
          • ODBC Data Loader
          • PowerBi Cataloguer
          • Reuters Connect
          • ShareFile
          • SharePoint
            • Azure Portal and Azure AD Authentication
          • SharePoint Legacy
          • SQL Server Cataloguer
          • Slack
          • Versioned Document Store
          • Websites
          • XML Data Loader
        • Source - Crawl
        • Source - Agents
        • Source - Schedule
        • Source - Advanced
      • Enrichment Configurations
        • Creating a Pipeline
          • General
          • Steps
            • AccessMiner
            • AI Classification
            • Anonymiser
            • CAD Extractor
            • Checksum
            • Content Retrieval
            • Copy
            • Data Rule Processor
            • Delete
            • Email Extractor
            • Entity Rule Processor
            • External Links
            • Geotag
            • Google NLP Extractor
            • Google Vision Extractor
            • Metrics Calculation
            • Microsoft Vision Extractor
            • OcrRest
            • Office Metadata
            • PCI Extractor
            • REST
            • Set Document Risk
            • Text Cleaner
            • Tika Text Extraction
            • Trie Entity Extractor
            • Update Metadata
          • Filters
          • Agents
          • Schedule
          • Advanced
      • OCR Engine
      • Job Configurations
        • General
        • Job
          • AutomatedSearchJob
          • Command Job
          • ElasticJob
          • Extended Metrics Job
          • File Extractor
          • GoogleVaultSAR
          • Google Drive Last Access Date
          • Nightly Events Processor Job
          • Notifications Processor Job
          • Portal Sync Job
          • Purge Job
          • Text Content Merge Job
        • Output
        • Agents
        • Scheduling
      • Migration Configuration
        • General
        • Filter
        • Metadata Mappings
        • Agents
        • Scheduling
        • Advanced
    • Credentials
      • Create a Credential
      • Find a Credential
      • Edit a Credential
      • Delete a Credential
    • Mappings
      • Entities
        • Group Management
        • Create an Entity
        • Managing Entities
      • Models
        • Create a New Model
        • Find a Model
        • Enable or Disable a Model
      • Vectors
      • Rank Features
    • Featured Links
    • AI Settings
      • Classifications
      • Class
      • Class Rules
      • AI Classification
    • User Settings
    • Stats
      • Data Views
    • Global Settings
      • General
        • Stackdriver
        • Document Recommendations
        • Searchable PDF Storage
        • Versioning
        • Results
        • Marking Useful Results
        • Folder Browsing
        • Cascading Search
        • Search Suggestions
        • Miscellaneous
      • Authentication
      • App Settings
      • Application Access
      • Thumbnails
      • Presets
      • Code of Conduct
      • Metrics
      • Viewer
        • Preview Configurations
        • Redacting Information
        • Watermarking
      • SAR
        • Importing Data For A SAR
        • SAR Disclosure Document Storage
        • Getting SAR data from Google Vault
        • SAR Access
        • SAR File Status
      • Disclosure Portal
        • Disclosure Portal Set Up
        • SARs From The Portal
        • Email Delivery Settings
          • Delivery Settings
          • Brand Settings
          • Customise Emails
        • SMS Delivery Settings
        • Requestor Message Limit
        • Attachment Configuration
        • Password Configuration
        • File Scanner Configurator
      • Collections
      • Visualisations
        • Related Result Connections Diagram
        • Event Timeline
        • Timeline Lens Activity Chart
        • Relationship Map
      • Notifications
      • Map Lens
      • Theming
        • General
        • Layout
        • Site Message
        • Colours
      • User Avatar
      • OData API
      • Uploads
      • Security
    • Search Settings
      • Search Relevancy
        • Core Settings
        • Makers Algorithm
        • Filename Boost Layer
        • Minimum Matching Terms Filter
        • Field Boost
        • Modified Date Boosting
        • Hit Highlighting
        • Why My Search Matched
        • Data Search Strategy
      • Bulk Search
        • Managing a Bulk Search
      • Search Flows
        • Create a Search Flow
          • General
          • Query Classification Step
          • Search Steps
          • Model Steps
      • Filtering
      • Search Performance
      • Related Results
  • API Guides
    • Insight API Guide
      • Swagger Documentation
      • Trying Some Endpoints
      • Search Filter
      • Hits / Items
      • Inspecting REST Calls
    • Data Science API Guide
      • REST Interface
        • Login
        • Datasets
        • Fields
        • Field Statistics
        • Search
        • Scroll
        • Update
      • Python Wrapper
        • Login
        • Datasets
        • Fields
        • Field Statistics
        • Search
        • Query Builders
        • Scroll
        • Scroll Search
        • Update Single Document
        • Bulk Update
    • Creating a Native Enrichment Step
      • Creating an Enrichment Step
        • Creating the Core Classes
        • Extending our Enrichment Step
        • Adding a Configuration Template
        • Adding the Enrichment Step
        • Creating an Enrichment Pipeline
      • Other Tasks
        • Entities, Metadata and Data
        • Accessing the Repository
      • Example Code
      • Troubleshooting
    • Creating a Python Enrichment Step
      • Creating an Enrichment Step
        • Running the Example from Command Line
        • Running the Example
      • Creating Your Own Step
      • Adding or Changing Entities, Metadata
  • whitepapers and explainers
    • From a Billion To One – Mastering Relevancy
    • Methods for Text Summarization
      • Application
      • Technology Methods
      • Commercial Tools
      • Key Research Centres
      • Productionisation
      • Related Areas of Text Analytics
      • Conclusion
      • References
Powered by GitBook
On this page
  • Recommended SharePoint API Application Permissions
  • General
  • Inclusions and Exclusions
  • Crawl Details
  • Advanced Options
  • Meta tag mappings
  1. Control Hub
  2. Configurations
  3. Source Configurations
  4. Source - Source

SharePoint

PreviousShareFileNextAzure Portal and Azure AD Authentication

Last updated 1 month ago

Connect your SharePoint source to Aiimi Insight Engine to make the most of your data. Once you have selected a Source System type more detail will expand to customise this.

Recommended SharePoint API Application Permissions

Sites.FullControl.All - Allows the app full control of all site collections.

  • This allows add, edit and delete operations on ALL site objects.

  • This can add, edit, delete entire site collections and document libraries.

Sites.Selected - Allows the application to access a subset of sites. The specific sites and the permissions granted are configured for each sites granted identities and must use FullControl.

  • This only works if you grant Sites.Selected for the Registered Application used to connect to SharePoint Online. (Application A).

  • You must then use another Azure Registered Application with Graph API Application permissions of Sites.FullControl.All to add the SharePoint application to each sites granted identities. (Application B)

  • This requires the highest level of permissions to change.

Azure Portal Azure AD Authentication

Azure Communication Services (ACS) are being deprecated. Authentication via Azure Portal and Azure AD is the modern way to manage app registration, communication and authentication.

You can use an Azure Registered Application with a certificate to connect to SharePoint Online. This allows for modern API Permission management scopes such as Sites.Selected via the SharePoint API in Azure.

For support setting this up use


General

  1. Authentication Mode - Select the type of authentication to use when connecting to SharePoint.

  2. Tenant ID - Enter the SharePoint online or Azure Registered Application Tenant ID to use.

  3. Client ID - Enter the SharePoint online or Azure Registered Application Client ID to use.

  4. Select Credential (Username & Password) - Choose the credentials to use.

    • For support setting up credentials use

  5. Select Credential - If your SharePoint Online does not have a Username and Password you must use a secret or certificate. Select the matching SecretOnly or Certificate credential for your SharePoint.

    • This will be the Azure Portal/Azure AD Certificate credential if required.

      • For support setting this up use

  6. Site Collection URL - Enter the root URL of the site collection that needs crawling.

    • Formatted https://[site]-admin.sharepoint.com

  7. Site Collection Lists - If your site collections do not match the Site Collect Lists, make sure you update these.

    1. Do not include O365


Inclusions and Exclusions

  1. Sites - Choose the sites within the root collection to crawl.

    • Enter in specific Sites or leave blank to crawl all sites.

  2. Sites to Exclude - If sites need excluding from the Crawl add them to Sites to Exclude.

  3. Excluded libraries - Libraries can be excluded from the Crawl by adding them to the Excluded Libraries list.

    • The default excluded libraries can be removed or edited as needed.

  4. Included libraries - Add specific libraries to crawl. This list overrides any exclusions if there is an overlap.

  5. Permission Groups - Add extra Permission Groups on top of those from the security sync.

    • Allows SharePoint groups in content permissions.

  6. Excluded Permission Groups - Add permission groups to be ignored from every file.


Crawl Details

  1. Page Load Throttling - To reduce timeouts you can change the Page Load Throttling.

    • By changing this you can increase the wait time between Chromium Page loads.

    • Enter the time in MS (2000 ms = 2 seconds).

  2. Owner Content Type Mapping - Enter the content field type name to be uses as the owner of a file.

    • Formatted like SharePoints internal naming conventions. Content_x0020_Owner

  3. Content Limit Per Request - Enter the maximum number of requests that can be made to Sharepoint.

    • By lowering the Content Limit Per Request more requests will run but each run will be quicker.

  4. SharePoint Client Context Timeout - Set a timeout value for all requests made to Sharepoint.

    • Enter a CSOM value into the SharePoint Client Context Timeout.

    • By default this is set to -1.5.

  5. Path to Chromium - If Chromium has been manually deployed enter the full path including chrome.exe.

    • If this field is left black it will be downloaded once.

  6. Path to SharePoint Online (only) Cookie Utility - Enter the path to your preferred cookie authentication utility.

    • This will handle authentication when processing ASPX pages.

    • You must explicitly enter the full path including the .exe.

    • If this field is left blank Default utils install locations will be used.


Advanced Options

  1. Process without Delta Tokens - Check this to NOT use the library delta tokens.

    • This will do a reprocess of the full library at every crawl and can be enabled to sync an index. All documents will be retrieved from the library, regardless of changes. However, only necessary changes will be made to your index.

      • If this is not checked, only the changes since the last change token will be retrieved from the library. Likewise only the necessary changes will be made to your index.

    • To use SharePoint change tokens to enable delta crawls uncheck this option.

  2. Do Permissions Check - Check to test all the document permissions.

  3. Get Permissions In Bulk - Check to gather all document permissions for everything in a library at once.

    • The higher the document count the more memory intensive it will be.

    • Not retrieving the permissions in bulk will mean a permission request for every file indexed. This can get you rate limited by SharePoint if many requests are sent in quick succession.

  4. Build Site Caches - Check to build a cache of all users with access to a site.

    • If unchecked validation will be processed with each document.

  5. Include OneDrives - Check this to process OneDrives and sites.

  6. Do Metadata/Entity Update - Check to reprocess all entity or metadata mappings at crawl.

    • This should only be enabled when a field of column has been deleted.

    • Note files updated will need to go through enrichment again after the crawl.

  7. Generate Edit in Browser Link - Check to generate an Open In browser app as default (SP Online only).

  8. Generate Open in App Link (MS Office docs only) - Check to generate an Open In link as SharePoint does.

    • For example, Open in word on the Users Machine (SP Online).

    • This will override the open in browser option.


Meta tag mappings

  1. You can map the entity fields to meta tags from the web page.

    • Enter the full entity field in the left column. For example, entities.Websites.category.

    • Enter the meta tag name in the right column

  2. You can map the metadata fields to meta tags from the web page.

    • Enter the full metadata field in the left column. For example, metadata.webtype.

    • Enter the meta tag name in the right column

our guide on Azure Portal and Azure AD Authentication.
our guide on managing credentials.
our guide on Azure Portal and Azure AD Authentication.