Jive Connector and Datasource Configuration

Retrieve content from a Jive instance.

Install the Jive Add-on

The Jive add-on lets you use OAuth to authenticate the Fusion connector to the Jive API. This is a recommended way to use the Jive API. The Jive add-on retrieves a client ID and secret, which are supplied to the Fusion connector. See the Jive product documentation.

If the client ID and secret cannot be retrieved or used, then Basic authentication is used as a fallback.

Install the Jive Add-on
  1. Install the Fusion Jive connector using the Fusion UI.

    1. In the Fusion UI, navigate to Indexing > Datasources.

    2. Click Add.

    3. Follow the UI prompts to install the Jive connector. For more information, see Managing Connectors in the Search Development Guide.

  2. Following the instructions from the Jive product documentation, use the Jive UI to upload the add-on from your Fusion distribution.

    1. On Linux, the Jive add-on is at

      $FUSION_HOME/apps/connectors/connectors-classic/plugins/lucid.jive/assets/lucidworks-jive-addon.zip
    2. On Windows, the Jive add-on is at

      %FUSION_HOME%\apps\connectors\connectors-classic\plugins\lucid.jive\assets\lucidworks-jive-addon.zip

Security Trimming of Results

If security trimming is enabled, the Jive connector uses the visibility field while indexing permission metadata on content. This data is stored in the acl_ss field for each document.

The value of the visibility field determines the permissions assigned to a document. The following table describes how the types of permissions found in the visibility field of a document are used.

Permission type Notes
All

The value stored in the acl_ss field is "all".

People

The document includes a list of users who are authorized to view the content. This list is stored in the acl_ss field as user email addresses.

Place

A request is made to determine the type of group. The group type determines the permissions stored.

Open or Members Only

The value stored in the acl_ss field is "all".

Private or Secret

The value stored in the acl_ss field is the name of the group.

Configuration

Tip
When entering configuration values in the UI, use unescaped characters, such as \t for the tab character. When entering configuration values in the API, use escaped characters, such as \\t for the tab character.