Secure Internet and SaaS Access (ZIA)
Creating an Exact Data Match Template
Watch a video on Exact Data Match.
Using the Index Tool you can create, modify, or delete an Exact Data Match (EDM) index template.
Creating an EDM Template
To create a new EDM template:
- Go to https://<IP Address of the Index Tool VM> to access the Index Tool. Log in to the Index Tool with your ZIA Admin Portal login credentials.
See image. - In the Exact Data Match Templates dashboard, click Create New Template.
- In the New Exact Data Match Template window:
- Type in a Template Name. After the template is saved, this name appears in Administration > Index Templates within the ZIA Admin Portal.
- Drag and drop a comma-separated values (.csv) file into the window or click Browse to select a file.
- Click Next.
See image.
- Define the fields you want to include in the template:
- From the drop-down menu, select a DATA TYPE for the field.
Be sure to select the type that best matches your data. For example, a field named SSN with sample data from the United States in the format of 123-45-6789 might need the Social Security Number (US) type applied, not Numeric. Also, for all data types, the Index Tool removes leading and trailing spaces in the data after you submit.
The following data types and formats are supported:
- Aadhaar Card Number (India)Close
Supported Format Examples An India-issued 12-digit unique identification (UID) number, where the number can include spaces or hyphens. - 1234-5678-9012
- 123456789012
- 1234 5678 9012
- ABA Bank Routing Number
- AlphabeticalClose
- AlphanumericClose
- Citizen Service Numbers (Netherlands)Close
Supported Format Examples A Netherlands-issued 9-digit citizen service number (BSN), where the number can include spaces or hyphens. - 111222333
- 111 222 333
- 111-222-333
- Company Number (Japan)Close
Supported Format Examples A Japan-issued 13-digit Corporate Number, where the first digit is a checksum number. - 7288275758478
- 6854046373053
- 3952116402622
- Credit Card NumbersClose
- DateClose
- Email AddressClose
Supported Format Examples Any email address using the RFC 5321 Simple Mail Transfer Protocol syntax definition. However, international email addresses (i.e., characters using UTF-8 encoding) are not supported. - jane.doe@zscaler.com
- jdoe47@corp.zscaler.com
- a.b.c@x.y.ru
- a_b_c@x.y.z.de
- Identity Card Number (China)Close
- Identity Card Number (Malaysia)Close
- Identity Card Number (Poland)Close
- Identity Card Number (Thailand)Close
- Individual Taxpayer Registry ID (Brazil)Close
- Medicare Number (Australia)Close
- Multi-alphanumeric IdentityClose
- Multiple AlphanumericClose
- Multi-words AlphabeticalClose
- MyNumber (Japan)Close
- National Document ID (Uruguay)Close
- National Health Service Number (UK)
- National Identification Card Number (Taiwan)Close
- National Identification Number (Chile)Close
- National Identification Number (France)Close
- National Identification Number (Peru)Close
Supported Format Examples A Peru-issued national identity card number (CUI) using an 8-digit number followed by a verification digit. - 25465832-5
- National Identification Number (Spain)Close
Supported Format Examples A Spain-issued national identity card number (DNI) using an 8-digit number and one letter representing the checksum (a-z, A-Z, excluding i, o, u, I, O, U). - 45592283G
- 25621992s
- National Insurance Number (UK)Close
- National Registry Identity Card (Singapore)Close
- NumericClose
- Resident Registration Number (Korea)Close
- Social Insurance Number (Canada)Close
- Social Security Number (Spain)Close
- Social Security Number (Switzerland)Close
- Social Security Number (US)Close
- Standardized Bank Code (Mexico)Close
Supported Format Examples A Mexico-issued 18 digit Standardized Bank Code (CLABE) number. - 102211123456789015
- Tax File Number (Australia)Close
Supported Format Examples An Australia-issued 8 or 9-digit tax file number, where the number can include spaces or hyphens. - 123-456-789
- 123 456 789
- 1234567-8
- Tax Identification Number (Indonesia)Close
- Select the INCLUDE FIELD IN TEMPLATE checkbox.
- Select the PRIMARY FIELD checkbox for the field that you want to designate as the primary criteria for data matching.
You must select at least one primary field, and no more than two. Also, the primary field must be unique for the selected data type.
You can configure EDM to function without primary or secondary fields. To learn more, see Configuring DLP Advanced Settings.
- Click Submit.
See image.
You are redirected back to the Exact Data Match Templates dashboard, and the tool processes the template. If the template was created properly, Completed is shown in the Status column. If the template was not created properly, then Error is shown.
Click on the template row to view the Template Details page. If an error occurred, details about the error are displayed. Be sure to read the Error Detail, which includes a Recommended Action, while troubleshooting the issue.
See image.
When an EDM template is created, it appears on the Index Templates page of the ZIA Admin Portal, where you can view the template's details or delete it. You cannot change the template name after creation. Also, after creation, you cannot update the included fields or the selected primary fields within the template. In order to make these modifications, you must create a new template.
Submitting New EDM Template Data
To submit new data for an EDM template:
- Log in to the Index Tool.
- In the Exact Data Match Templates dashboard, locate the template you want to modify.
- In the Actions column:
- If you need to resubmit data for a template that was processed successfully (i.e., has a Completed status), click the Submit New Data icon. The data types, included fields, and primary fields you originally selected for the template are not updated. You must create a new template to modify the data types and selected fields.
- If you need to resubmit data for a template that did not process successfully (i.e., has an Error status), click the Submit New Data icon or click the Edit Template icon. The ability to edit a template only becomes available if there was an error when you originally submitted the data. If you edit a template, you are able to modify the data types and selected fields to resolve the issue.
See image.
You can also click on the template row and, in the Template Details page that appears, click Submit New Data or Edit Template (if available).
See image.
The selected included fields and primary fields you originally selected for the template are not updated. You must create a new template to modify fields.
- In the Upload File window that appears, drag and drop the .csv file into the window or click Browse to select the file.
- Click Submit.
Scheduling Updates for an EDM
After you have successfully uploaded your template, you can schedule regular updates. You can also choose to receive an Alert if there are any missed updates.
To schedule regular updates for your EDM Template:
- Log in to the Index Tool.
- In the Exact Data Match Templates dashboard, locate the template you want to schedule updates for.
- Perform one of the following actions:
- In the Actions column, click the Schedule icon.
See image. - Click on the template row. The Template Details page appears. In this window, click Create Schedule.
See image.
- In the Schedule Template Update window, select the following:
- File Path: The file path is automatically populated with the location that you uploaded your file to. Ensure that the file is still at this location.
- Status: Select whether to Enable or Disable your schedule
- Repeat: Choose if the update repeats Monthly, Weekly, or Daily.
- Every: If you selected Monthly or Weekly, choose when in the selected period the update repeats. For example, if you selected Weekly, you can choose to have the update happen every Friday.
If you select Monthly, index updates are converted to, and trigger in UTC. It is possible that after being converted, your update may occur between the 29th and 31st UTC. If a month doesn't contain the converted date, that update is skipped.
For example, if you schedule your update to occur on the 28th of every month at 5:00 PM PST, it does not trigger in February since the UTC time is already 1:00 AM February 29 and that date does not exist (excluding leap years). If you schedule your update to occur on the first of every month at 8:00 AM IST, it also does not happen every month. As the UTC time is 3:00 AM on the 31st, it does not occur in February, April, June, September, or November.
Zscaler recommends you schedule your monthly updates to occur between the 2nd and the 27th.
- At: Choose what time the scheduled update happens on.
- Time Zone: Select the time zone your update happens in.
- Update Now: Select to immediately update the template.
See image. - Click Save.
To edit your schedule:
- Log in to the Index Tool.
- In the Exact Data Match Templates dashboard, locate the template whose schedule you want to edit.
- Perform one of the following actions:
- In the Actions column, click the Schedule icon. The Schedule Index Update window appears.
- Click on the template row. The Template Details page appears. Click Edit Schedule. The Schedule Index Update window appears.
- Make your desired changes and click Save.
To delete your schedule:
- Log in to the Index Tool.
- In the Exact Data Match Templates dashboard, locate the template whose schedule you want to delete.
- Perform one of the following actions:
- In the Actions column, click the Schedule icon. The Schedule Index Update window appears.
- Click on the template row. The Template Details page appears. Click Edit Schedule. The Schedule Index Update window appears.
- In the Schedule Index Update window, click Delete in the lower right-hand corner.
To temporarily disable your schedule, set the status to Disable.
Deleting an EDM Template
To delete an EDM template, do one of the following sets of steps:
- Delete from the Exact Data Match Templates Dashboard
- Log in to the Index Tool.
- In the Exact Data Match Templates dashboard, locate the template you want to remove.
- In the Actions column, click the Delete icon.
You can also click on the template row and, in the Template Details page, click Delete Template.
- In the confirmation window that appears, click Delete.
- Go to Administration > Index Templates.
- Locate the template you want to remove and click the View icon.
- In the View Template window, click Delete.
See image. - In the confirmation window that appears, click Confirm.