Authorization Support
Search AI supports API Key-based authentication for communicating with Invision Community. Authentication requires a Base URL pointing to your community instance and an API Key generated from your Invision Community admin panel.Integration Steps
To configure Invision Community as a content source, complete the following steps.- Configure the Invision Community connector in Search AI
- Set up Permissions
- Configure Content Scope
- Schedule Sync
Step 1: Configure the Invision Community Connector in Search AI
Prerequisites - Obtaining an API Key
Before configuring the connector, generate an API key from your Invision Community admin panel:- Log in to your Invision Community admin panel.
- Navigate to System > REST & OAuth > API Keys.
- Create a new API key with read access to forums, topics, and posts.
- Copy the generated API key for use in the connector configuration.
Configuring the Connector
Go to Connectors under the Sources page and select Invision Community. On the Authentication tab, enter the following details and click Connect.
Once successfully authenticated, the status shows as Connected.
Step 2: Set Up Permissions
Go to the Permissions tab to configure access control for the ingested content. The following options are available.- Same users as in the source system (Restricted Access) - Applies RACL-based access control. Permissions are enforced using platform/RACL configuration. The permissions aren’t continuously synced from Invision Community; you must manually update any permission changes in the source system using RACL configuration.
- Everyone (Public Access) - All users get full access to the ingested content, overriding any previous restrictions in the connector.
Automatic permission sync isn’t supported for the Invision Community connector. File attachments within topics or posts aren’t ingested as part of the connector flow.
Step 3: Configure Content Scope
Go to the Content Scope tab under Connector Setup to define which forums and content are ingested.Only content available via the configured API key is ingested. Private or member-restricted forums are synced only if the service account has the appropriate access permissions.
Step 4: Sync Content
After configuring the connector, go to Schedule Sync to initiate and manage content synchronization.- Use the Sync option for an immediate, on-demand sync.
- Enable Schedule Sync to set up automated, recurring syncs.
Content Ingestion
Once the sync is complete, go to the Content tab to review the ingested content. The tab displays the count of files that are Successful, Failed, and Skipped, along with the total number of Accessible Files. Search AI ingests two content types from Invision Community.Forum Topics (Threads)
The following key fields are extracted and indexed for each forum topic.title- The title of the forum topic or thread.content- The body text of the opening post in the thread, made available for search operations.doc_id- A unique identifier for the ingested topic, derived from the topic ID in Invision Community.doc_source_type- Identifies the content type as a forum topic.doc_created_onordoc_updated_on- Timestamps capturing when the topic was created and last updated.url- The URL pointing to the topic in your Invision Community instance.forum- The name of the forum the topic belongs to.author- The username of the member who created the topic.
Posts (Replies)
The following key fields are extracted and indexed for each post within a topic.title- Derived from the parent topic title for context.content- The body text of the individual post or reply.doc_id- A unique identifier for the ingested post, derived from the post ID in Invision Community.doc_source_type- Identifies the content type as a forum post.doc_created_onordoc_updated_on- Timestamps capturing when the post was created and last updated.url- The URL pointing to the specific post within its topic thread.author- The username of the member who authored the post.
File attachments within topics or posts are not ingested as separate documents in the connector flow.
RACL Support
Search AI provides access control support for content ingested from Invision Community. Thesys_racl field is used to enforce access control by associating relevant identifiers with the ingested content, ensuring that users can only access the content they’re authorized to view.
- When RACL is disabled (default), all synced content is publicly available to all users searching the index (permission set to
*). - When RACL is enabled, the connector uses RACL platform configuration to enforce access control. Since automatic permission sync isn’t supported, the Permission Entity APIs must be used to manually associate users with the appropriate permission entities after ingestion.
sys_raclcan include wildcard (*) for publicly available content, or explicit user/group identifiers for restricted forums and content.