How to Setup and Configure the NetDocuments Connector

How to Authorize the Connector

The NetDocuments Connector must be authorized with appropriate permissions for your NetDocuments content. If you are indexing from the European or Australian NetDocuments data centers, follow these instructions in the section below: How to Customize Your NetDocuments Connector.

Use the following steps to grant the NetDocuments connector access to your NetDocuments tenancy:

1. On the server where the NetDocuments Connector is installed, navigate to: http://localhost: number>/OAuth Specifies a process for resource owners to authorize third-party access to their server resources without providing credentials..aspx
   
   • <port number>: This is the port number that you selected during the Connector installation. Default is 2281. 
     If you changed the port number, follow the instructions at How to Customize Your NetDocuments Connector to create your own application
     
2. Click Authorize to start the authorization process.
   

3. Log into NetDocuments using an account that has READ access to all content that you want to crawl.

   Note: This Connector has the same permissions in NetDocuments as the user account that is used to log in here.

   * If multiple instances of the connector are deployed, you must use different user accounts for each connector instance.
   
4. Click Allow.
   
5. If the authorization is successful, a success message displays.
   
6. If the authorization is unsuccessful, ensure you are using the correct user or service account and that account contains the correct permissions. 

Content Configuration Specifics

Index your cabinets:

1. In the connection Connection defines the how Connectivity Hub connects to your Source System (which contains your documents, graphics, etc.,). Your Connection includes identifying elements such as: URL of the BA Insight web service connector you are using, (File Share connector, SharePoint Online connector, etc.), Authentication mode, User Accounts and Credentials, Database information (for database connectors) configuration Repository tab, click Load Available.
   
2. A list of all the cabinets available in selected NetDocs repositories is displayed in the left panel.
   
3. Select the cabinets to index and click >> to add them to the Selected list.
   
4. Run the Datastore Types Load Collects the types of data from your source system. Runs on a set schedule. Requires a log level which logs information job from the Tasks page.

Content Filters

Repository ID Setting

• This is an optional setting used for content filtering.
• If the authorized user is connected to multiple repositories, you can use this filter to specify only the repositories you want the user to crawl.
• By default, the Connector crawls all repositories the user can access.

Cabinet Filter

Specify the Cabinet filter for metadata Provides context with details such as the source, type, owner, and relationships to other data sets. Metadata provides details around the item being crawled by Connectivity Hub. generation and content indexing.

• There is an optional content setting to filter which documents to crawl.
• Specify a comma (,) separated list in order to include a limited set of documents.
• You can also set the minimum and/or maximum document "created" date.
  

Use the following requirements below to specify your content filters:

• One filter per line
• Datetime
  • Can be in any format, however:
    • The ordering of the year, month, and day must match the international settings of your operating system.
  • All times must be specified in UTC.
    

How to Customize Your NetDocuments Connector

This topic describes how to customize your NetDocuments connector to use your own application registration or index from the European or Australian data centers.

• The NetDocuments Connector is pre-configured to work with the Vault (US) Region and comes with the BA Insight application ID for the OAuth authorization process.

If you want to use the connector in a different region or register your own application, follow the instructions below:

1. Log on to the NetDocuments developer portal.
   
   1. If you don't have access to it or do not know what it is, contact NetDocuments.
      
2. Create a new application.
   1. Select the proper region for your application
   2. Use a client type of REST.
   3. Use an application type of Confidential.
   4. Enter the following as the default redirect URL: http://localhost:2281/oauthresult.aspx
      
      1. If you used a different port number or https, change the redirect URL accordingly)
   5. Save the new application and write down the generated ClientId and ClientSecret values.
      
3. Return to the server where the NetDocuments connector is installed.
   1. Edit the web.config file found in <installation directory\WebService 

   2. Change the clientId and clientSecret values as shown below:

      <add key ="clientId" value="enter your client ID here"/><add key ="clientSecret" value="enter your client secret here"/>

4. If you are indexing a NetDocs tenancy from EU or Australia, change the baseUrl path in the web.config file.

   • For more information see the REST API v1 Guide for your region:

   For instance:

   <add key ="baseUrl" value="https://api.eu.netdocuments.com"/>