Get help with FileSafe
Account Set Up & Management
Create and manage your Maya Data Privacy account to access FileSafe.
File Anonymization
Upload a file and anonymize it.
Post Anonymization Options
View the done jobs, and download and/or delete the anonymized file.
Advance Features
Derive data types, create groups , and save utility sets.
Understand Data Types
Get familiar with data types used in FileSafe.
Using Utility Parameters
Set the parameters for anonymization.
Privacy Relevance
Settings for reporting purposes.
Coin System
Get familiar with how coins are consumed while performing the jobs.
API
Connect with FileSafe API
Account Set Up & Management
How to register?
To register, kindly fill out the registration form with the required information. All fields are mandatory.
Kindly double-check the spelling of your email id because it’ll be used for login and password reset.
The password must be at least 8 characters long and should include both lower & upper case characters and at least one number & a symbol.
Kindly read the Terms of Use & Privacy Policy carefully, and if you don’t agree with these terms, don’t click the ‘Sign up’ button.
Clicking the ‘Sign up‘ button confirms that you agree with our terms and begins the registration process.
After successful registration, you will be redirected to the login screen.
How to login?
For login, visit the login page. Kindly provide the email & password you entered at the time of registration. Use reCAPTCHA to confirm that you are a human being. And click the ‘Sign in‘ button to begin the login process.
After successful login, you’ll be redirected to the Dashboard.
How to reset password?
To reset your password, visit the login page and click ‘Forgot Password.’ You can also directly visit https://app.mayadataprivacy.eu/forgotPassword.
This will open the ‘Password Reset’ form, in which you have to fill in the email that you entered at the time of registration and click the ‘Reset‘ button.
If everything goes well, you’ll receive a ‘Password reset successful’ message on the screen.
To retrieve your password, open your email. Look in junk mail also if you don’t find the password in the inbox.
File Anonymization
Upload a file
Use ‘Choose a file‘ button to upload .xlsx or .csv file from your device. To try out our product, you can also use a test file.
The first column of the spreadsheet will be considered a header and used for the field names.
Select Data Types & Utility Parameters
Select data types and utility parameters for each field name.
Save the anonymized file
After selecting the file group, utility set, data types and utility parameters, click the ‘Execute‘ button, which will open a pop-up window in which you’ll have to type in the name of the anonymized file.
Finally, click the ‘Submit‘ button, to start the saving process, which will redirect you to the History page to show you the status of the job.
To check the current status, use the ‘Refresh Button’ at the top-right of the page.
Post Anonymization Options
Download the anonymized file
To download an anonymized file, use the ‘Download‘ button on the History page. The file can only be downloaded when the status is ‘Finished.’
After submitting the name of an anonymized file, you’ll be automatically redirected to the History page.
You can also open the History page by clicking ‘History’ in the side panel.
Delete the anonymized file
To delete an anonymized file, use the ‘Delete‘ button on the History page.
After submitting the name of an anonymized file, you’ll be automatically redirected to the History page.
You can also open the History page by clicking ‘History’ in the side panel.
Put comments for own use
You can put comments for your own use for each job on the History page using the ‘Comment‘ button (shown in the pic below), which will open a pop-up window to enter the comments.
After writing the comments, click the ‘Update‘ button.
See the history of jobs
You can visit the History page to get the details of jobs associated with your account. To visit, click ‘History‘ on the side panel.
The details include job name, job comment, date of job creation, time of job creation, job group, job status, no. of records submitted per job, and no. of records processed per job.
You can download, delete, and put comments on anonymized files here.
Advance Features
Derive data types
Derive data types functionality is a part of Maya Data Utility Engine, which automatically detects the data types present in the uploaded file.
To use the functionality, click the ‘Derive Data Types‘ button shown in the pic.
File Group
File Group represents a collection in which the files anonymized may retain relationships. It is selected from the dropdown shown in the pic at the time of saving anonymization job.
Files anonymized using the ‘Default‘ file group would not retain any relationship.
In the free / trial version, only two groups are available for relationship preservation. Files anonymized using ‘Group – 1‘ or ‘Group – 2‘ would relate to other files anonymized using the same group.
Example: Retaining relationship means, for example, a name John in file_1.csv anonymized using ‘Group – 1’ would be converted to Smith_1 when the utility parameter selected is ‘Name.’ In file_2.csv the name John would also be converted to Smith_1 if the utility parameter selected is ‘Name’ and the file group selected is ‘Group – 1.’
Save Utility Sets
Saving utility sets means preserving the settings of Data Types, Utility Parameters, and Privacy Relevance so that you don’t need to set these every time you upload a file for anonymization.
You can select the setting from the dropdown.
To save a utility set; upload a file, select Data Types, Utility Parameters, & Privacy Relevance; and click the ‘Save as‘ button.
Clicking the button will open a pop-up window in which you need to provide ‘Business Area,’ ‘Industry Area‘ and a Name for saving the prevalent settings in a utility set.
Business Area and Industry Area represent Industry verticals and horizontals respectively. Though only Name is mandatory for saving a utility set.
After completing the Utility Set form, click the ‘Submit‘ button. On successful submission, you’ll receive a message on the screen.
Understand Data Types
A data type is an attribute associated with a piece of data that tells a computer system how to interpret its value. Understanding data types ensures that data is collected in the preferred format and the value of each property is as expected.
Here, we are dealing with text, numbers, and dates representing strings, floating point numerical, and DD-MM-YY date format respectively.
Using Utility Parameters
Text
No Change
When ‘No Change’ is selected, the output will remain the same as the input.
Names
When ‘Names’ is selected, the output will appear as a name of a real person with a numeric suffix at the end.
For example, ‘James’ will be converted to ‘Smyth Taylor_6’ in the output file.
Emails
When ‘Emails’ is selected, the output will appear as a real email id with an extension @dummy1.com at the end so that it can pass the check for structure of email.
For example, ‘Robert@ACCPB.com’ will change to ‘e960bb398@dummy1.com’ in the output file.
Phone
When ‘Phone’ is selected, the output will be a four-digit number.
Consistent Text
When ‘Consistent Text’ is selected, the output will be a consistent text.
Clear Values
When ‘Clear Values’ is selected, the output will be blank.
Number
At present, only Randomization is active. When it is selected, the input number will be replaced by a random number in the output file.
Date
No Change
When ‘No Change’ is selected, the output will remain the same as the input.
Random
When ‘Random’ is selected, the output will be a random date.
Date Same Year
When ‘Date Same Year’ is selected, the output will be a random date of the same year.
Date Adult
When ‘Date Adult’ is selected, the output will be a date of at least 18 years ago.
Consistent Text
When ‘Consistent Date’ is selected, the output will be a consistent date.
Privacy Relevance
Privacy Relevance represents the relevance of the field for reporting purposes. Currently, only two options are available: privacy for individual’s privacy and confidential for organization’s privacy.
Coin System
Coins are the credit which is used to execute records. 1 coin is used in the execution of 1 row in an uploaded spreadsheet.
API
Authentication
Maya FileSafe API is organized around REST and uses JWT for authentication. JWTs are a good way of securely transmitting information between parties because they can be signed, which means you can be sure that the senders are who they say they are. Additionally, the structure of a JWT allows you to verify that the content hasn’t been tampered with.
You can access everything in Maya FileSafe through your access_Token which you can get by creating an account with Maya Data Privacy. For authentication, you need to provide your email and password associated with the Maya Data Privacy account, and in response, you’ll get access_Token.
The contents in the angle brackets should be replaced with appropriate values.
curl -X POST "https://apiprod.mayadataprivacy.eu/mdp/api/authenticate/v2" -H "accept: application/json" -H "Content-Type: application/json" -d "{ \"mail\": \"\", \"password\": \"\"}"
curl -X POST
"https://apiprod.mayadataprivacy.eu/mdp/api/authenticate/v2"
-H "accept: application/json"
-H "Content-Type: application/json"
-d "{
\"mail\": \"\",
\"password\": \"\"
}"
Response of the above request:
The highlighted part is access_Token. You must include this access_Token in the header of each request to the Maya FileSafe API.
Authorization
curl -X HTTPS Request "URL" -H "accept: application/json" -H "Authorization: "
View Done Jobs
In the job details associated with your account, the object jobStatus talks about the status of the job along with the transaction id, file group, and job description.
The contents in the angle brackets should be replaced with appropriate values.
curl -X GET "https://apiprod.mayadataprivacy.eu/mdp/api/myJobs" -H "accept: application/json" -H "Authorization: "
Response:
{
"recordProcessed": 100,
"recordSubmitted": 100,
"transactionId": "7fb36a77-e3d0-4755-8e98-a94da039406b",
"fileGroup": "Default",
"batchJobId": "555871d2-a8fe-4186-a24d-def2fe9ff935",
"batchJobType": "FILE",
"jobStatus": "Finished",
"jobDescription": "date_Date",
"created_at": "2023-02-15T05:24:53.341793Z",
"updatedAt": "2023-02-15T05:24:53.341793Z",
"deletionFlag": true
},
View File Group
The object groupName defines the file group and other objects throw the details of the file like when it was created or updated.
The contents in the angle brackets should be replaced with appropriate values.
curl -X GET "https://apiprod.mayadataprivacy.eu/mdp/api/myFileGrps" -H "accept: application/json" -H "Authorization: "
Response:
[
{
"active": true,
"created_at": "2023-03-20T09:56:42.924665Z",
"updatedAt": null,
"createdBy": "xyz@aaasapgmail.onmicrosoft.com",
"updatedBy": null,
"groupName": "Group - 2",
"groupId": 219
},
{
"active": true,
"created_at": "2023-03-20T09:56:42.917519Z",
"updatedAt": null,
"createdBy": "xyz@aaasapgmail.onmicrosoft.com",
"updatedBy": null,
"groupName": "Group - 1",
"groupId": 220
},
{
"active": true,
"created_at": "2023-03-20T09:56:42.966531Z",
"updatedAt": null,
"createdBy": "xyz@aaasapgmail.onmicrosoft.com",
"updatedBy": null,
"groupName": "Default",
"groupId": 221
}
]
Save a Utility Set
The metaData in the ‘Utility Set Saving‘ request consists of multiple objects, and the curly brackets in it represent one row of the uploaded file.
The contents in the angle brackets should be replaced with appropriate values.
curl -X POST "https://apiprod.mayadataprivacy.eu/mdp/api/file/utilSet" -H "accept: application/json" -H "Authorization: " -H "Content-Type: application/json" -d "{ \"businessArea\": \"\", \"industryArea\": \"\", \"metaData\": [ { \"dataType\": \"\", \"fieldname\": \"\", \"privacyRelevance\": \"\", \"utilityParameter\": \"\" } ], \"utilSetName\": \"\"}"
curl -X POST "https://apiprod.mayadataprivacy.eu/mdp/api/file/utilSet"
-H "accept: application/json"
-H "Authorization: "
-H "Content-Type: application/json"
-d "{
\"businessArea\": \"\",
\"industryArea\": \"\",
\"metaData\":
[ { \"dataType\": \"\",
\"fieldname\": \"\",
\"privacyRelevance\": \"\",
\"utilityParameter\": \"\"
} ],
\"utilSetName\": \"\"
}"
Response:
[
{
"id": 216,
"utilSetName": "string",
"metaData": "[{\"fieldname\":\"Phone_Number\",\"privacyRelevance\":\"Not Relevant\",\"dataType\":\"Number\",\"utilityParameter\":\"Randomization\"}]",
"businessArea": "string",
"industryArea": "string",
"created_at": "2023-03-16T06:20:02.519863Z",
"updatedAt": "2023-03-16T06:20:02.519863Z",
"createdBy": "email@gmail.com",
"updatedBy": "email@gmail.com",
"active": true
}
]
View Saved Utility Sets
The object utilSetName defines the Name of the saved utility set and other objects throw the details of the settings saved along with when it was created or updated.
The contents in the angle brackets should be replaced with appropriate values.
curl -X GET "https://apiprod.mayadataprivacy.eu/mdp/api/file/utilSet" -H "accept: application/json" -H "Authorization: "
Response:
[
{
"id": 213,
"utilSetName": "Test-trial",
"metaData": "[{\"fieldname\":\"Name\",\"privacyRelevance\":\"Personal\",\"dataType\":\"Text\",\"utilityParameter\":\"Names\"}]",
"businessArea": "Test",
"industryArea": "Trial",
"created_at": "2023-03-14T21:35:20.974175Z",
"updatedAt": "2023-03-14T21:35:20.974175Z",
"createdBy": "email@gmail.com",
"updatedBy": "email@gmail.com",
"active": true
},
{
"id": 222,
"utilSetName": "Basic 1",
"metaData": "[{\"fieldname\":\"Pin Code\",\"privacyRelevance\":\"Not Relevant\",\"dataType\":\"Text\",\"utilityParameter\":\"No Change\"}]",
"businessArea": "string",
"industryArea": "string",
"created_at": "2023-03-21T08:19:13.839358Z",
"updatedAt": "2023-03-21T08:19:13.839358Z",
"createdBy": "email@gmail.com",
"updatedBy": "email@gmail.com",
"active": true
}
]
Download Finished File
To download a finished file, you need transactionId of that particular file, which you can get from jobs history.
The contents in the angle brackets should be replaced with appropriate values.
curl -X GET "https://apiprod.mayadataprivacy.eu/mdp/api/download/transaction?transactionId=" -H "accept: application/json" -H "Authorization: " -o
curl -X GET "https://apiprod.mayadataprivacy.eu/mdp/api/download/transaction?transactionId="
-H "accept: application/json"
-H "Authorization: "
-o
Delete Finished File
To delete a finished file, you need transactionId of that particular file, which you can get from jobs history.
The contents in the angle brackets should be replaced with appropriate values.
curl -X DELETE "https://apiprod.mayadataprivacy.eu/mdp/api/deletion/transaction" -H "accept: application/json" -H "Authorization: " -H "Content-Type: application/json" -d "{ \"transactionId\": \"\"}"
curl -X DELETE "https://apiprod.mayadataprivacy.eu/mdp/api/deletion/transaction"
-H "accept: application/json"
-H "Authorization: "
-H "Content-Type: application/json"
-d "{
\"transactionId\": \"\"
}"
Upload & Anonymize Spreadsheet
For file anonymization, file group, utility set, data types and utility parameters are also passed along with the file in the request body.
In response, a job is created which can be viewed in jobs done with other details.
The contents in the angle brackets should be replaced with appropriate values. The curly brackets in metadata represent one row of the uploaded spreadsheet.
curl -X POST "https://apiprod.mayadataprivacy.eu/mdp/api/file" -H "accept: application/json" -H "Authorization: " -H "Content-Type: multipart/form-data" -F "file=@;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" -F "seedFileGroup=" -F "jobDescription=" -F "metadata= [{"fieldName":"","dataType":"","subDataType":"","privacyRelevance":""}]"
curl -X POST
"https://apiprod.mayadataprivacy.eu/mdp/api/file"
-H "accept: application/json"
-H "Authorization: "
-H "Content-Type: multipart/form-data"
-F "file=@;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
-F "seedFileGroup="
-F "jobDescription="
-F "metadata=
[
{
"fieldName":"",
"dataType":"",
"subDataType":"'""'",
"privacyRelevance":"'""'"
}
]"
Example:
curl -X POST
"https://apiprod.mayadataprivacy.eu/mdp/api/file"
-H "accept: application/json"
-H "Authorization: access_Token"
-H "Content-Type: multipart/form-data"
-F "file=@Tr4.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
-F "seedFileGroup=Default"
-F "jobDescription=Tr4"
-F "metadata=
[
{
"fieldName":"CustomerId",
"dataType":"Text",
"subDataType":"'"No Change"'",
"privacyRelevance":"'"Not Relevant"'"
},
{
"fieldName":"PERSON_NAME",
"dataType":"Text",
"subDataType":"Names",
"privacyRelevance":"Personal"
},
{
"fieldName":"Email_ID",
"dataType":"Text",
"subDataType":"Emails",
"privacyRelevance":"Personal"
},
{
"fieldName":"Phone_Number",
"dataType":"Text",
"subDataType":"ConsistentValues",
"privacyRelevance":"Personal"
},
{
"fieldName":"Address_Eircode",
"dataType":"Text",
"subDataType":
"ConsistentValues",
"privacyRelevance":"'"Not Relevant"'"
},
{
"fieldName":"Date_of_Birth",
"dataType":"Date",
"subDataType":"'"Date Same Year"'",
"privacyRelevance":"Personal"
},
{
"fieldName":"CustomerSince",
"dataType":"Date",
"subDataType":"'"Date Adult"'",
"privacyRelevance":"Confidential"
}
]"
Response:
{
"success": true,
"message": "Job Posted",
"blobUrl": "https://scwesteuropemdpdev.blob.core.windows.net/fileuploaddata/70557155-05d8-45bb-88e4-959a29afabf4.xlsx",
"batchJobId": "3d00ba48-d4fc-4eb2-b7ef-167b00733906",
"jobDescription": "jobResponse.getJobGroupId()",
"jobGroupId": "File",
"batchJobType": "Posted",
"jobStatus": "Job_1"
}