1 Introduction
1.1 About This Manual
This document presents detailed information on the integration of ATIPXpress and Veritone, including the integration architecture and step-by-step instructions to enable the integration.
Before enabling the ATIPXpress 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.
Note: Images used in this document reflect a FOIAXpress environment, however all steps and details also apply for ATIPXpress.
1.2 Veritone Integration Architecture for Video Redactions
The following diagram depicts the integration between the ATIPXpress application server and the Veritone Redact application.
Introduction
2 Enabling Veritone Integration for ATIPXpress
The following sections explain how to configure ATIPXpress 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
The Project Manager and Veritone should first set up Veritone Redact app account access. It is important to ensure that the customer has an active Veritone organization account, as this account will be used by ATIPXpress for redacting the media files.
Casepoint must coordinate with you (the customer) and Veritone to provision your account, which may require multiple meetings to gather all necessary information to set up the account in Veritone.
All users that need to perform media redactions must have an active user account associated with this organization account.
2.2 Whitelist Veritone’s IP Addresses in ATIPXpress Environment
The IT/System Administrator and Veritone must whitelist Veritone’s IP addresses in the FX environment.
The Veritone Redact application will need to call the ATIPXpress Media Redactions API to read the video media file data as well as to update ATIPXpress with redacted media file information.
The ATIPXpress scheduler service will read the redacted media file from the Veritone server.
Follow the steps below to ensure the ATIPXpress Media Redactions API is accessible to the Veritone Redact application.
Allow the https (port 443) traffic from Veritone to the ATIPXpress application server.
Whitelist the Veritone public IP addresses in your 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.3 Whitelist ATIPXpress IP Addresses in Veritone Cloud Environment
After the customer’s Veritone Redact App has been activated, the IT/System Administrator, Project Manager, and Veritone can whitelist ATIPXpress IP addresses in the Veritone Cloud environment.
Coordinate with the Veritone team to make sure that ATIPXpress Scheduler service job can access the Veritone Redact application web service to get the redacted medial file and redactions audit log file (.CSV file). The Veritone team will whitelist IP address ranges to make sure that ATIPXpress Scheduler can access their URL/API without any issue.
Ensure the users’ (proxy server/gateway) IP addresses are whitelisted in Veritone.
Provide Veritone with the following information:
The public IP ranges for all the end-users at the customer (who will be using Redact), for whitelisting on the Veritone ingress firewall (to allow login and accessing Redact site).
The base URL for the ATIPXpress server hosting the media being sent to Redact, for whitelisting on the Veritone egress firewall (HTTP GET request from Veritone's servers).
2.4 Provide ATIPXpress Media Redaction API Endpoint to Veritone
The IT/System Administrator, Project Manager, and Veritone will provide ATIPXpress media redaction API endpoint information to Veritone for sending the redacted file back from Veritone to ATIPXpress (HTTP POST request from user workstation). Ensure it is configured correctly in the ATIPXpress application server:
Add the bold text below to the end of your ATIPXpress URL:
https://<FQDN>/ATIPXpress/apiex/MediaFile/SubmitRedactedMediaInfo
Note: <FQDN> above is the Fully Qualified Domain Name, or the complete website address for the ATIPXpress application.
2.5 Enable Media Redaction Feature License in ATIPXpress
The ATIPXpress Application Admin User/BA should enable the media redaction feature license within the ATIPXpress application.
1. Enable Media Redaction License to the ATIPXpress License Key File and update Licensesusing the new key file.
2. Ensure the Media Redaction feature is enabled in Administration > Features and Licenses > Application Features screen.
2.6 Media Redaction Settings in ATIPXpress Application
The ATIPXpress Application Admin User/BA can configure the Media Redaction settings within the ATIPXpress application.
Configure the Media Redaction Settings in ATIPXpress via the Administration > Document Management > Media Redaction Settings, as shown below.
Redaction Software Application URL: This is the URL for the Veritone Redact app, which will be provided by the Veritone team and may vary for different customers.
Redaction Software Vendor: Input "Veritone" in this field. As of now, ATIPXpress only integrates with Veritone as a third-party media redaction software.
Supported File Formats: Input the file extensions for the media file formats 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.
ATIPXPRESS Integration URL: This is the ATIPXpress application URL.
Signed URL Expiry Time (minutes): Enter the expiration time 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. A longer time potentially alleviates timeouts between the application and Veritone but overly long durations (e.g., greater than one day) can result in security vulnerabilities. By default, this value is set to 60 minutes.