How to Configure Your Elastic Target with App Authentication

The following topics describe how to create an Elasticsearch Target in Connectivity Hub.

Prerequisites

Add the Elasticsearch Target

Before you can add your Target, you must install BA Insight Connectivity Hub.

• A Target is a set of configuration options used by your Content Source (that identify which search engine content is written to).
  • Multiple Content Sources can point to the same Target
  • For more about Targets, see What is a Target?
• Add at least 1 Target per search engine
  • 1 Target: If you use the same crawl options across all Content Sources, use 1 Target per search engine
  • Multiple Targets: If you use various crawl options across all Content Sources, use multiple Targets per search engine
• If you use Elasticsearch, your Target points to the entire elastic cluster
• 1 Content Source = 1 index in your search engine (Elastic, MS Search, etc.)
  • You cannot map 2 Content Sources to the same index
• Connectivity Hub automatically names the indices based on the Content Source names

To add the Elasticsearch Integration target, follow these steps:

1. Go to the Connectivity Hub Target page.
   
2. Select New > Target.
   
3. The Load Target page appears.
   
4. Select the generic Elastic Target.
   
   
   
   
5. Select the Target Info tab.
   Enter the following information:
   1. Title (required): Specify a name.
   2. Target Information (required): Auto-populates. Enter BAInsight.ElasticSearch.ConnectorsExtension.ElasticTarget.
      

      
      

6. Select the Custom Settings tab.
   
   
   

   1. Elastic index URL(required): Enter your URL in the format:
      http(s)://[server_name]:[port_number]
      

      1. Connectivity Hub attempts to connect to the index in this address [index_name]. If the index does not exist, Connectivity Hub creates it.

      2. To define the fields you want to see in your index use the Metadata page and set the Active, Refinable, Searchable, and Exact match settings for your metadata.

      3. The fields are automatically created in your index, based on these settings.

      4. If you need to query against the specific property, mark it as Active and Searchable

      5. If you only care about the value of the property and only need to query against the content of the property, then mark is Active and Full text indexable

   2. Application ID:

      1. Enter App IDs from Azure App 

   3. AppSecret Key:

      1. Enter Secret Key from Azure AppTenant ID

   4. Tenant:

      1. Enter Tenant ID from Azure

      2. Example: contoso.onmicrosoft.com

   5. Azure Scope:

      1. Enter Azure Scope

      2. Example: https://contoso.com/.default

   6. Microsoft Login Endpoint:

      1. Enter Microsoft login endpoint

      2. Example: https://login.microsoft.com

   7. If you need to use the property as a refiner check both:

      1. Active

      2. Refinable (See the graphic below).
         
         
         

7. Click Save.
   

8. Click Connect.
   

9. The Elastic schema is created automatically.

How to Group All Non-refinable/Non-searchable Properties

You can group all non-refinable/non-searchable properties from Connectivity Hub in a bulk property in Elastic by setting the Active and Full text index property on your metadata:

After indexing, all values are found under the ElasticBulkValues property.

How to Run a Full Target Update Job

After you add a target, you must run an Full Target Update job.

To update the target after you have run a Full Target Update job, run a Incremental Target Update job.

To run a Full Target Update job, follow these steps:

1. Go to the Connectivity Hub Tasks page.
   
   
   
2. Click New and the Edit Job page appears.
   
   
   
3. In the Scope drop-down field, select the Content Source for which to run the full target update.
   
   
   
4. Select Target Full Update from the Job drop-down list.
   
   
   

5. Click Create.
   

6. Logs- See these logs after you run a job:

   • Full

   • Incremental

   • Target Update