us-cbp / gtas

Global Travel Assessment System | A passenger data screening and analysis system for enhancing global security

Resources

• [How to Install Complete GTAS Environment with Docker in 25 min] (https://youtu.be/vR9ihvtP5BA)
• [How to Install Core GTAS, start-to-finsih] (https://youtu.be/Jj1WeVz5Cpo)
• [How to Install Neo4j Integration] (https://youtu.be/cDXOYdAVTHc)
• Supporting Files on Google Drive

Developed by U.S. Customs and Border Protection for The World Customs Organization

About GTAS

The Global Travel Assessment System (GTAS) is web application for improving border security. It enables government agencies to automate the identification of high-risk air travelers in advance of their intended travel.

The United Nations has called upon members to use Advance Passenger Information (API) and Passenger Name Record (PNR) data for preventing the movement of high-risk travelers, and GTAS was designed to give every country that capability. The World Customs Organization (WCO) has partnered with U.S. Customs and Border Protection (US-CBP) because of the shared belief that every border security agency should have access to the latest tools. US-CBP has made this repository avaialble to the WCO to facilite deployment for its member states.

This belief has become a reality with GTAS in production. It is able to handle the load of a high-volume country, and has successfully identified high-risk travelers. The mission GTAS supports goes beyond combating terrorism and includes;

• Preventing the spread of human health outbreaks
• Protecting wildlife by preventing the transport of illegal animal products
• Finding missing persons
• Fighting drug trade
• Protecting agriculture

Which results in;

• Safer travel
• Expedited Screening of passengers
• Less waiting time at airports

GTAS accomplishes these goals through providing all the necessary decision support system features to (1) receive and store air traveler data (2) provide real-time risk assessment against this data based on your own specific risk criteria and/or watch lists (3) view high risk travelers, their associated flight and reservation information, and possible affiliates

Where is GTAS currently Deployed?

• Maldives | Maldives Customs Service http://www.wcoomd.org/es-es/media/newsroom/2019/july/gtas-go-live-in-maldives.aspx
• Pakistan | Federal Board of Revenue http://www.wcoomd.org/en/media/newsroom/2019/november/pakistan-gtas-implementation.aspx
• Uganda | Uganda Revenue Authority https://www.theeastafrican.co.ke/business/Entebbe-rolls-out-travel-assessment-system/2560-5443676-ly5fciz/index.html

Three other deployments scheduled before JUN 2020

About the code

GTAS is developed in Java and uses open source software components and platforms.

About the data

GTAS parses data provided by airline departure control systems (API) and reservation systems (PNR). Respectively, these messages conform to WCO UN/EDIFACT PAXLST and PNRGOV message formats.

• UN/EDIFACT PAXLST 02B and later
• PNRGOV 11.1 and later

Features

• API and PNR Data Processing
• Criteria Based Risk Assessment
• Watch List Based Risk Assessment
• Identification of partial Watch List matches
• Risk Criteria Management Interface
• Watch List Management Interface
• View Flights and Passengers Interface
• Query Flights and Passengers Interface
• Cloud-Ready
• Case Management for Decision Support
• Free-Text Search
• Customizable Dashboard
• Graph Database (Neo4J)
• Graph Database Rules Engine for Identifying Risk Patterns

Issues

Find a bug or want to request a new feature? Please let us know by submitting an issue. The GTAS team manages all GTAS updates, bugs, and feature additions via GitHub's public issue tracker in this repository. In the spirit of open source software, everyone is encouraged to help improve this project.

Submit Issues

• Before submitting a new issue, check to make sure a similar issue isn't already open. If one is, contribute to that issue thread with your feedback.

• When submitting a bug report, please try to provide as much detail as possible, i.e. a screenshot or gist that demonstrates the problem, the browser you are using, and any relevant links.

Pull Requests

If you'd like to contribute to this project, please make a pull request. We'll review the pull request and discuss the changes.

gtas's Issues

Case Management | Workflow?

Currently, the workflow for assigning dispositions to passengers is simple. Users assign the disposition and it creates a log of comments.

Fix 'enter' key on filter change (flight, pax views)

As a user I would like the enter key to consistently work when updating filters, so I can change the flight and pax views without pressing the update button.

Query Builder | Travel Agency City

UI Bug | Hits are icons only

The current workaround for CBP workstations is to add the GTAS site to the list of trusted sites
We need to limit the usage of icons representing watchlist and rule hits

Fix main menu bar so that it doesn't wrap

As a user I want to use the main toolbar without items wrapping, so I can use the website on smaller screens.

Can we think about a different approach than buttons? It would be nice to group some of the options together into dropdowns. We're running out of space to add additional buttons.

New Feature | Whitelist [#72]

For diplomats, VIPs - might be embarrassing to send them to secondary

License allows change, the source file headers say otherwise

The license (LICENSE.md) terms are unequivocally confusing, the license allows changes as long as the source file headers are unaltered, however these same headers stipulate that the source code is copyrighted.

It would be beneficial to all potential contributors if you could explicitly spell out whether this code is property of CBP, UNISYS corp, or the public domain?

I would suggest a thorough legal review of your licensing scheme.

Flights View | Clickable sort up to three slices

Please add the ability to sort up to three way, prioritizing by the order the columns are clicked, and describe the current sorting / filtering below the toolbar, with the ability to turn off a slice by clicking it

Passenger Details | Travel History

We don't really have the ability to view the travel history for an individual traveler. This will be solved by the data warehouse utility that we haven't fully planned out yet.

Case Management | Disposition Status Lists | Front End

Maintain a list of disposition statuses in GTAS that can be modified on front end

Name Origin | New Feature

Think about including the ability to query a first name or last name and get statistics about its origin

Partner Country Data Sharing

Query Builder | Add PNR ID field

This field is missing

Fix language display issues

As a user, I'd like to view all of the languages without issues on my browser.

For example, w/ French:

Ad hoc query UI

Initial front-end for ad hoc query. Consists of

• single search input
• buttons for executing search on passengers or flights
• ui grid for displaying results. Refer to existing query builder search results.

Flights View | Export to Excel function

At the time of the gap analysis, this functionality wasn't available, and the .pdf report was unusable.

Query Builder | Support Cases

Once the Cases hotlist has been developed, we'll need to add the ability to build queries based on the fields we create.

Flights | Menu Bar | Int'l/Domestic/Shared | Back End

Please add the option to quickly filter by international, domestic, and shared flights. We should probably have the shared option disabled until we figure out a plan for sharing data/partner countries

Query Builder | separate citizenship / doc country | back-end

we shouldn't assume that they're one in the same

Query Builder | Dwell time

Add the ability to query / make rules based on layover/dwell time

3 | Passenger | Export to Excel

Please copy the flights export to excel function after it is improved

Ad hoc query services

Angular and REST services for querying elastic search.

File Support | Epic

What file types can we support, where should we include this information?

SITA XML?
COPA XML? (Mexico Specific)
US/EDIFACT APIS?

Query Builder | Phone details

can't query by phone details: City, ID, PNR

Flights View | Separate Columns for Flight No. and Carrier

Flights View | Expand/Collapse funtion

It would be extremely useful to be able to expand on the flight number to expose the manifest, which could be sorted by any of the passenger fields, but default on hit / hit severity

Flights View | Expand/Collapse function

Ad Hoc Query

Create a feature that allows google-style queries on passengers. The motivation is to provide a faster path to the data versus using the existing query builder interface.

Ideally, we want to be able to search on the original raw APIS and PNR data. The goal is to make any data that may have been skipped by the parser available to search on. For instance, the parser skips over ticket numbers (the segment TKT+0062120234536:T:1).

Interpol | New Feature

We should plan out how we could integrate with Interpol. Pie in the sky ideas.

Fix the display issue with the translate filter.

As a user I don't want to see {{'DASHBOARD.TITLE' | TRANSLATE}} on page load.

For example,

Passenger Details | Add the ability to ingest baggage information

Ad Hoc Query Indexer

Epic #41

Modify existing loader to also index the document in ElasticSearch. The index should have the following characteristics:

• allow searching on either passengers or flights
• include the flight id and passenger id from the database
• include the raw PNR or APIS as part of the passenger or flight document

Ad Hoc Query UI

Epic #41

Create the initial UI and supporting angularJS code.

Results should be displayed exactly like the results from the existing query builder -- a list of passengers or flights. From a list of passenger results, the user should be able to access the passenger detail page.

Fix integration tests

As a developer I want to run the integration test suite without errors so I can create additional integration tests.

We have a number of integration tests, but a lot of them fail. Please take stock of what we have and decide which ones should be fixed or deleted. Any integration tests that use the database should use the spring transactional test class, and should assume an empty database (with the possible exception of look up data).

Case Management | Cases Hotlist

Please create a new view just like Flights and Passengers, but for Active Cases. It should be a hotlist of Active Cases

Passenger | hover-over to display hit type / explanation

Show rule name only in the tooltip.

Ad Hoc Query Search Service

Epic #41

Add service for querying ElasticSearch. Should return PassengerVo objects similar to existing QueryBuilder.

Passenger | Timeline Back End Work

Please add a Timeline on the passenger details page.

The Timeline is an audit log that shows the date/time and brief description of the following event types:

• Message ingest/parsing
• Rule Hit
• Case opened
• Disposition status changed/added

Code should be flexible to allow addition of new event types.

There is an existing audit log feature. See AuditActionType for a list of audit events. It uses the audit_log table in the database. Not sure if we can leverage this code because it does not associate a passenger with any of the events.

User Peferences | Save Grid Settings

It would be great to save Grid settings to a profile so that you don't have to apply filters and sorts each login.

Fix formatting issues on flight/pax filters

Some general formatting issues with the current filters on both flight and pax views: (1) origin and dest are too large; (2) direction element doesn't line up; (3) reset and filter buttons are cramped (spread things out more if possible).

Update translate module to a configuration setting

As a user I would like the website to appear in a single language, so I do not have the update the language every time I log in.

The requirements need to be better defined for this module. It's currently implemented so that any user who logs in can change the locale/language. It should instead be a compile-time/configuration setting. The site will be deployed in a single host country so the language will be set once. We need to think about an approach that uses properties in the html files for the different labels, but doesn't require use of the translate filter.

Flights View | Sort Function

It would be great to add a sort function that can support up to three slices.

Flights View | Quick Filter

Case Management | UI Bug

When a user creates a new disposition, the time and the user don't show up after clicking save. A manual refresh fixes it.

Query Builder | Ability to select window of time | Front-End

Administration | Epic

We really need to put -some thought into the administration hierarchy.

• User-Groups management
• Rule-Group management
• Status Management (for cases, should be customizable list that affects the disposition dropdowns)
• Rule Category Management
• System Monitoring

Sonar blocker issues

Please address any blocker issues identified by Sonar.

Passenger Details | Affiliates

This functionality wasn't ready at the time of the gap analysis. We should get together and discuss exactly what we should try to get out of it

Quick Query | New Feature

We should add a quick query function that has:

Name Search - FN/LN/DoB
Doc Search - Doc#/Country Code
Contact Info Search - phone/email/travel agency/TA phone
PNR Search - record locator =

Permission to Upload Data Generator