Home
Home
German Version
Support
Impressum
25.2 Release ►

Start Chat with Collection

    Main Navigation

    • Preparation
      • Connectors
      • Create an InSpire VM on Hyper-V
      • Initial Startup for G7 appliances
      • Setup InSpire G7 primary and Standby Appliances
    • Datasources
      • Configuration - Atlassian Confluence Connector
      • Configuration - Best Bets Connector
      • Configuration - Box Connector
      • Configuration - COYO Connector
      • Configuration - Data Integration Connector
      • Configuration - Documentum Connector
      • Configuration - Dropbox Connector
      • Configuration - Egnyte Connector
      • Configuration - GitHub Connector
      • Configuration - Google Drive Connector
      • Configuration - GSA Adapter Service
      • Configuration - HL7 Connector
      • Configuration - IBM Connections Connector
      • Configuration - IBM Lotus Connector
      • Configuration - Jira Connector
      • Configuration - JVM Launcher Service
      • Configuration - LDAP Connector
      • Configuration - Microsoft Azure Principal Resolution Service
      • Configuration - Microsoft Dynamics CRM Connector
      • Configuration - Microsoft Exchange Connector
      • Configuration - Microsoft File Connector (Legacy)
      • Configuration - Microsoft File Connector
      • Configuration - Microsoft Graph Connector
      • Configuration - Microsoft Loop Connector
      • Configuration - Microsoft Project Connector
      • Configuration - Microsoft SharePoint Connector
      • Configuration - Microsoft SharePoint Online Connector
      • Configuration - Microsoft Stream Connector
      • Configuration - Microsoft Teams Connector
      • Configuration - Salesforce Connector
      • Configuration - SCIM Principal Resolution Service
      • Configuration - SemanticWeb Connector
      • Configuration - ServiceNow Connector
      • Configuration - Web Connector
      • Configuration - Yammer Connector
      • Data Integration Guide with SQL Database by Example
      • Indexing user-specific properties (Documentum)
      • Installation & Configuration - Atlassian Confluence Sitemap Generator Add-On
      • Installation & Configuration - Caching Principal Resolution Service
      • Installation & Configuration - Mindbreeze InSpire Insight Apps in Microsoft SharePoint On-Prem
      • Mindbreeze InSpire Insight Apps in Microsoft SharePoint Online
      • Mindbreeze Web Parts for Microsoft SharePoint
      • User Defined Properties (SharePoint 2013 Connector)
      • Whitepaper - Mindbreeze InSpire Insight Apps in Salesforce
      • Whitepaper - Web Connector - Setting Up Advanced Javascript Usecases
    • Configuration
      • CAS_Authentication
      • Configuration - Alerts
      • Configuration - Alternative Search Suggestions and Automatic Search Expansion
      • Configuration - Back-End Credentials
      • Configuration - Chinese Tokenization Plugin (Jieba)
      • Configuration - CJK Tokenizer Plugin
      • Configuration - Collected Results
      • Configuration - CSV Metadata Mapping Item Transformation Service
      • Configuration - Entity Recognition
      • Configuration - Exporting Results
      • Configuration - External Query Service
      • Configuration - Filter Plugins
      • Configuration - GSA Late Binding Authentication
      • Configuration - Identity Conversion Service - Replacement Conversion
      • Configuration - InceptionImageFilter
      • Configuration - Index-Servlets
      • Configuration - InSpire AI Chat and Insight Services for Retrieval Augmented Generation
      • Configuration - Item Property Generator
      • Configuration - Japanese Language Tokenizer
      • Configuration - Kerberos Authentication
      • Configuration - Management Center Menu
      • Configuration - Metadata Enrichment
      • Configuration - Metadata Reference Builder Plugin
      • Configuration - Mindbreeze Proxy Environment (Remote Connector)
      • Configuration - Personalized Relevance
      • Configuration - Plugin Installation
      • Configuration - Principal Validation Plugin
      • Configuration - Profile
      • Configuration - Reporting Query Logs
      • Configuration - Reporting Query Performance Tests
      • Configuration - Request Header Session Authentication
      • Configuration - Shared Configuration (Windows)
      • Configuration - Vocabularies for Synonyms and Suggest
      • Configuration of Thumbnail Images
      • Cookie-Authentication
      • Documentation - Mindbreeze InSpire
      • I18n Item Transformation
      • Installation & Configuration - Outlook Add-In
      • Installation - GSA Base Configuration Package
      • JWT Authentication
      • Language detection - LanguageDetector Plugin
      • Mindbreeze Personalization
      • Mindbreeze Property Expression Language
      • Mindbreeze Query Expression Transformation
      • SAML-based Authentication
      • Trusted Peer Authentication for Mindbreeze InSpire
      • Using the InSpire Snapshot for Development in a CI_CD Scenario
      • Whitepaper - AI Chat
      • Whitepaper - Create a Google Compute Cloud Virtual Machine InSpire Appliance
      • Whitepaper - Create a Microsoft Azure Virtual Machine InSpire Appliance
      • Whitepaper - Create AWS 10M InSpire Appliance
      • Whitepaper - Create AWS 1M InSpire Appliance
      • Whitepaper - Create AWS 2M InSpire Appliance
      • Whitepaper - Create Oracle Cloud 10M InSpire Application
      • Whitepaper - Create Oracle Cloud 1M InSpire Application
      • Whitepaper - MMC_ Services
      • Whitepaper - Natural Language Question Answering (NLQA)
      • Whitepaper - SSO with Microsoft AAD or AD FS
      • Whitepaper - Text Classification Insight Services
    • Operations
      • Adjusting the InSpire Host OpenSSH Settings - Set LoginGraceTime to 0 (Mitigation for CVE-2024-6387)
      • app.telemetry Statistics Regarding Search Queries
      • CIS Level 2 Hardening - Setting SELinux to Enforcing mode
      • Configuration - app.telemetry dashboards for usage analysis
      • Configuration - Usage Analysis
      • Deletion of Hard Disks
      • Handbook - Backup & Restore
      • Handbook - Command Line Tools
      • Handbook - Distributed Operation (G7)
      • Handbook - Filemanager
      • Handbook - Indexing and Search Logs
      • Handbook - Updates and Downgrades
      • Index Operating Concepts
      • Inspire Diagnostics and Resource Monitoring
      • Provision of app.telemetry Information on G7 Appliances via SNMPv3
      • Restoring to As-Delivered Condition
      • Whitepaper - Administration of Insight Services for Retrieval Augmented Generation
    • User Manual
      • Browser Extension
      • Cheat Sheet
      • iOS App
      • Keyboard Operation
    • SDK
      • api.chat.v1beta.generate Interface Description
      • api.v2.alertstrigger Interface Description
      • api.v2.export Interface Description
      • api.v2.personalization Interface Description
      • api.v2.search Interface Description
      • api.v2.suggest Interface Description
      • api.v3.admin.SnapshotService Interface Description
      • Debugging (Eclipse)
      • Developing an API V2 search request response transformer
      • Developing Item Transformation and Post Filter Plugins with the Mindbreeze SDK
      • Development of a Query Expression Transformer
      • Development of Insight Apps
      • Embedding the Insight App Designer
      • Java API Interface Description
      • OpenAPI Interface Description
    • Release Notes
      • Release Notes 20.1 Release - Mindbreeze InSpire
      • Release Notes 20.2 Release - Mindbreeze InSpire
      • Release Notes 20.3 Release - Mindbreeze InSpire
      • Release Notes 20.4 Release - Mindbreeze InSpire
      • Release Notes 20.5 Release - Mindbreeze InSpire
      • Release Notes 21.1 Release - Mindbreeze InSpire
      • Release Notes 21.2 Release - Mindbreeze InSpire
      • Release Notes 21.3 Release - Mindbreeze InSpire
      • Release Notes 22.1 Release - Mindbreeze InSpire
      • Release Notes 22.2 Release - Mindbreeze InSpire
      • Release Notes 22.3 Release - Mindbreeze InSpire
      • Release Notes 23.1 Release - Mindbreeze InSpire
      • Release Notes 23.2 Release - Mindbreeze InSpire
      • Release Notes 23.3 Release - Mindbreeze InSpire
      • Release Notes 23.4 Release - Mindbreeze InSpire
      • Release Notes 23.5 Release - Mindbreeze InSpire
      • Release Notes 23.6 Release - Mindbreeze InSpire
      • Release Notes 23.7 Release - Mindbreeze InSpire
      • Release Notes 24.1 Release - Mindbreeze InSpire
      • Release Notes 24.2 Release - Mindbreeze InSpire
      • Release Notes 24.3 Release - Mindbreeze InSpire
      • Release Notes 24.4 Release - Mindbreeze InSpire
      • Release Notes 24.5 Release - Mindbreeze InSpire
      • Release Notes 24.6 Release - Mindbreeze InSpire
      • Release Notes 24.7 Release - Mindbreeze InSpire
      • Release Notes 24.8 Release - Mindbreeze InSpire
      • Release Notes 25.1 Release - Mindbreeze InSpire
      • Release Notes 25.2 Release - Mindbreeze InSpire
    • Security
      • Known Vulnerablities
    • Product Information
      • Product Information - Mindbreeze InSpire - Standby
      • Product Information - Mindbreeze InSpire
    Home

    Path

    Sure, you can handle it. But should you?
    Let our experts manage the tech maintenance while you focus on your business.
    See Consulting Packages

    Dropbox Connector
    Installation and Configuration

    InstallationPermanent link for this heading

    Before installing the Dropbox Online connector, make sure that the Mindbreeze server is installed and the Dropbox connector is included in the license. Use the Mindbreeze Management Center to install or update the connector.

    Plugin installation via Mindbreeze Management CenterPermanent link for this heading

    To install the plug-in, open the Mindbreeze Management Center. Select “Configuration” from the menu pane on the left-hand side. Then navigate to the “Plugins” tab. Under “Plugin Management,” select the appropriate zip file and upload it by clicking “Upload.” This automatically installs or updates the connector, as the case may be. In the process, the Mindbreeze services are restarted.

    Configuring MindbreezePermanent link for this heading

    Configuration of the indexPermanent link for this heading

    Navigate to the "Indices" tab and click on the "Add new index" icon in the upper right corner to create a new index. Select Dropbox as the data source.

    If necessary, change the display name.

    Configuration of the data sourcePermanent link for this heading

    Scroll down to the Data Sources tab. There you can configure the data source according to your needs.

    Section „Dropbox Settings“Permanent link for this heading

    In the "Dropbox Settings" section you can define your dropbox installation to be indexed. The following options are available:

    Setting

    Description

    Admin Email Address

    The email address of the admin user with which the dropbox should be crawled. Only documents to which this admin user has access can be indexed.

    App Credential

    For this setting, you need to create an OAuth2 credential in the Network tab, in which you configure the app key and the app secret of your Dropbox app as the client ID and client secret. Since the Access Token URL in Dropbox is fixed, it does not need to be configured.
    This credential must then be selected here.

    How to create a Dropbox app for the Dropbox crawler is described in the chapter Creating a Dropbox App.

    Access Code

    The access code for the Dropbox app. How to obtain this is described in the chapter Generating an Access Code.

    Access Token Credential
    (Advanced Setting)

    Since Dropbox no longer supports the issuing of long-lived access tokens, it is not recommended to use this option.

    If you still have an old, long-lived access token available, you can configure it here as a password credential.

    Otherwise, you should use the App Credential & Access Code configuration options.

    Maximum Page Size

    Block size of a metadata request.

    Parallel Request Count

    Maximum number of HTTP requests that are sent simultaneously.

    Connection Timeout

    Time in seconds to wait for a response before the API call is aborted.

    File Size Limit

    Maximum size of the files to be downloaded in MB. Files larger than the specified value will not be downloaded or indexed.

    Team Folder Include Pattern (regex)

    Regular Expression, which indicates which team folders should be crawled.

    Folder Include Pattern (regex)

    Regular Expression, which specifies which regular folders should be crawled.

    Team Folder Select Pattern

    Regular Expression, which specifies for which Team Folders the Folder Include Pattern should be applied.

    Use Server Modified Date for Deltacrawl

    (Advanced Setting)

    This option should no longer be changed.

    Creating a Dropbox AppPermanent link for this heading

    Go to https://www.dropbox.com/developers/apps and use the "Create App" button to create a new app.

    When selecting the API, select 'Scoped access' and for the required access type, select 'Full Dropbox'. You can then give the app a name. Finally, click the "Create app" button to create the app.

    Now the permissions for the app need to be adjusted. Navigate to the app and then go to the tab "Permissions".

    The Mindbreeze Dropbox Crawler requires the following permissions:

    • account_info.read
    • files.metadata.read
    • files.content.read
    • sharing.read
    • team_data.member (team_data.governance.write, team_data.governance.read are granted indirectly)
    • members.read
    • groups.read

    You can now find the App Key and App Secret in the Settings tab of the app. These are required for the setting App Credentials in the configuration.

    Generating an Access CodePermanent link for this heading

    Attention: The access code generated in this section is single-use and is only valid for 5 minutes. Therefore, make sure that you perform this step at the end of your configuration so that the crawler/principal resolution service can start in time. Using this code, the crawler/principal resolution service retrieves a long lasting token, which is saved and used from then on.

    Please also note that different services cannot use the same access code.

    To generate the access code, open this URL with the browser:

    https://www.dropbox.com/oauth2/authorize?client_id=<AppKey>&token_access_type=offline&response_type=code

    <AppKey> in the URL must be replaced with the app key of your created app.

    When you open the URL, you will see the following warning:

    This is displayed because you have created your app yourself for this use case only and it therefore has few users. As long as you have entered your app key correctly, there are no concerns here.

    You will then be shown the authorizations that the app requires again. These are the same as those configured above:

    If you click on "Allow", the access code that you need for the setting Access Code will be generated.

    Configuration of the Principal Resolution ServicePermanent link for this heading

    Select "Advanced Settings" to make the following settings.

    In the new or existing service, select the Dropbox Principal Resolution Service option in the Service setting. For more information about additional configuration options and how to create a cache and how to do the basic configuration of a cache for a Principal Resolution Service, see Installation & Configuration - Caching Principal Resolution Service.

    Section „Connection Settings“Permanent link for this heading

    Enter the information about your Dropbox installation in the "Connection Settings" section. For "Admin Email Address" and " App Credential" you can simply make the same entries as in the crawler. How to obtain the “Access Code” is described in the chapter Generating an Access Code. For more information about the setting “Access Token Credential” see the chapter Section “Dropbox Settings”.

    The advanced option "HTTP Dumping Path" is a debug option, where all HTTP requests and responses are stored on the specified path. This should not be configured in production operation.
    With the setting “Add users without verified Email”, you can decide whether users without verified email addresses should be resolved by the Principal Resolution Service. It is not recommended to activate this setting.

    Download PDF

    • Configuration - Dropbox Connector

    Content

    • Installation
    • Configuring Mindbreeze

    Download PDF

    • Configuration - Dropbox Connector