1 Introduction
1.1 About This Manual
This document covers the integration of FOIAXpress and Veritone, a media redaction tool. It includes integration architecture information, as well as step-by-step instructions to enable the integration.
Before enabling the FOIAXpress and Veritone integration for media redactions, it is important to thoroughly review this document. We recommend following the steps in the order presented in this document for successful integration configuration.
1.2 Veritone Integration Architecture
The following diagram depicts the integration between the FOIAXpress application server and the Veritone Redact application server.
2Enabling Veritone Integration for FOIAXpress
The following sections explain how to configure the FOIAXpress and Veritone integration. Please carefully follow the steps outlined below to ensure successful completion of the integration setup.
2.1 Set Up Veritone Redact App Account Access
The first step to configure the integration is to set up Veritone Redact app account access. The customer will need to have an active Veritone organization account, as this account will be used by FOIAXpress for redacting the media files. The Casepoint Project Manager will coordinate with both the customer and Veritone to set up Veritone Redact app account access. All users who need to perform media redactions must have an active user account associated with this organization account.
2.2 Whitelist IP Addresses in FOIAXpress and Veritone
Once Veritone Redact app account access is provisioned, the next step is to whitelist IP addresses in both FOIAXpress and Veritone. The Casepoint IT/System Administrator will whitelist Veritone’s IP addresses in the FX environment, and Veritone will do the same on their side.
2.2.1 Whitelist Veritone’s IP Addresses in FOIAXpress Environment
The Veritone Redact application will need to call the FOIAXpress Media Redactions API to read the video media file data as well as to update FOIAXpress with redacted media file information. The FOIAXpress scheduler service will read the redacted media file from the Veritone server.
The Casepoint IT/System Administrator should follow the steps below to ensure the FOIAXpress Media Redactions API is accessible to the Veritone Redact application.
Allow the https (port 443) traffic from Veritone to the FOIAXpress application server.
Whitelist the Veritone public IP addresses in the ingress firewall:
20.141.71.155
52.245.243.92
13.77.232.218
13.77.227.4
Note: This IP address list may vary from customer to customer, so please make sure to check with the Veritone team.
2.2.2 Whitelist FOIAXpress IP Addresses in Veritone Cloud Environment
Once the customer’s Veritone Redact app has been activated, the Casepoint IT/System Administrator, Casepoint Project Manager can work with Veritone to whitelist FOIAXpress IP addresses in the Veritone Cloud environment. This ensures the FOIAXpress Scheduler service job can access the Veritone Redact application web service to get the redacted media file and redactions audit log file (.CSV file).
Casepoint should provide Veritone with the following information:
The public IP ranges for all customer end users who will be using Redact.
The base URL for the FOIAXpress server hosting the media being sent to Redact, for whitelisting on the Veritone egress firewall (HTTP GET request from Veritone's servers).
2.3 Provide FOIAXpress Media Redaction API Endpoint to Veritone
The Casepoint Project Manager will provide the FOIAXpress media redaction API endpoint information to Veritone. This enables the redacted file to be sent back to FOIAXpress from Veritone (HTTP POST request from user workstation).
Add the bold text below to the end of the customer’s FOIAXpress URL in both the Test and the Production environments:
https://<FQDN>/FOIAXpress/apiex/MediaFile/SubmitRedactedMediaInfo
Note: <FQDN> above is the Fully Qualified Domain Name, or the complete website address for the FOIAXpress application.
2.4 Enable Media Redaction Feature License in FOIAXpress
The FOIAXpress Application Admin User or Casepoint BA should enable the media redaction feature license within FOIAXpress.
Enable Media Redaction License in the FOIAXpress License Key File and update Licenses using the new key file.
Ensure the Media Redaction feature is enabled in Administration > Features and Licenses > Application Features.
2.5 Media Redaction Settings in FOIAXpress Application
The FOIAXpress Application Admin User or Casepoint BA can configure Media Redaction settings within the FOIAXpress application. Navigate to Administration > Document Management > Media Redaction Settings, as shown below.
Configure the fields on this page as follows:
Redaction Software Application URL: Input the URL for the Veritone Redact app.
Proxy: The Casepoint Project Manager should confirm with the customer if they require use of a proxy between FOIAXpress and Veritone. If required, provide the proxy URL here.
Redaction Software Vendor: Input "Veritone" in this field.
Supported File Formats: Input the media file format extensions that are compatible with the Veritone Redact app in this field. If you do not wish to make any changes, you may leave the default values as they are.
FOIAXPRESS Integration URL: Input the FOIAXpress application URL.
Signed URL Expiry Time (minutes): The default expiration time value is set to 60 minutes for the media files’ signed URL in FOIAXpress. This is the time Veritone is allowed access to the application URL to retrieve the media files.
Note: A longer time potentially alleviates timeouts between the application and Veritone, but longer durations (e.g., greater than one day) can result in security vulnerabilities.