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. 

Screenshot of Maya Data Privacy Registration Form

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

Utility Parameters set the level of anonymization in the output file. These are governed by algorithms. 

Each data type has its own set of 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\": \"<your email>\", \"password\": \"<your password>\"}"
				
			
				
					curl -X POST 
"https://apiprod.mayadataprivacy.eu/mdp/api/authenticate/v2" 
-H "accept: application/json" 
-H "Content-Type: application/json" 
-d "{ 
      \"mail\": \"<your email>\", 
      \"password\": \"<your 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: <access_Token>" 
				
			

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: <access_Token>"
				
			

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: <access_Token>"
				
			

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: <access_Token>" -H "Content-Type: application/json" -d "{ \"businessArea\": \"<Name Industry Vertical>\", \"industryArea\": \"<Name Industry Horizontal>\", \"metaData\": [ { \"dataType\": \"<Write Data Type>\", \"fieldname\": \"<Write Field Name>\", \"privacyRelevance\": \"<Write Privacy Relevance Option>\", \"utilityParameter\": \"<Write Utility Parameter for Corresponding Field Name>\" } ], \"utilSetName\": \"<Name Utility Set>\"}"
				
			
				
					curl -X POST "https://apiprod.mayadataprivacy.eu/mdp/api/file/utilSet" 
-H "accept: application/json" 
-H "Authorization: <access_Token>" 
-H "Content-Type: application/json" 
-d "{ 
        \"businessArea\": \"<Name Industry Vertical>\",
        \"industryArea\": \"<Name Industry Horizontal>\",
        \"metaData\": 
        [ { \"dataType\": \"<Write Data Type>\",
        \"fieldname\": \"<Write Field Name>\",
        \"privacyRelevance\": \"<Write Privacy Relevance Option>\",
        \"utilityParameter\": \"<Write Utility Parameter for Corresponding Field Name>\" 
        } ], 
        \"utilSetName\": \"<Name Utility Set>\"
    }"
				
			

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:  <access_Token>"
				
			

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=<transactionId-from-jobs-done>" -H "accept: application/json" -H "Authorization: <access_Token>" -o <Name of the File>
				
			
				
					curl -X GET "https://apiprod.mayadataprivacy.eu/mdp/api/download/transaction?transactionId=<transactionId-from-jobs-done>" 
-H "accept: application/json" 
-H "Authorization: <access_Token>" 
-o <Name of the File>
				
			

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: <access_Token>"  -H "Content-Type: application/json" -d "{ \"transactionId\": \"<transactionId-from-jobs-done>\"}"
				
			
				
					curl -X DELETE "https://apiprod.mayadataprivacy.eu/mdp/api/deletion/transaction" 
-H "accept: application/json" 
-H "Authorization: <access_Token>"  
-H "Content-Type: application/json" 
-d "{
      \"transactionId\": \"<transactionId-from-jobs-done>\"
    }"
				
			

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: <access_Token>" -H "Content-Type: multipart/form-data" -F "file=@<Name of the File>;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" -F "seedFileGroup=<Name of File Group>" -F "jobDescription=<Name of the Job>" -F "metadata= [{"fieldName":"<Write Field Name>","dataType":"<Write Data Type>","subDataType":"<Write Utility Parameter>","privacyRelevance":"<Write Privacy Relevance>"}]"
				
			
				
					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=@<Name of the File>;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" 
-F "seedFileGroup=<Name of File Group>" 
-F "jobDescription=<Name of the Job>" 
-F "metadata=
  [ 
   {
   "fieldName":"<Write Field Name>",
   "dataType":"<Write Data Type>",
   "subDataType":"'"<Write Utility Parameter for the Corresponding Field Name>"'",
   "privacyRelevance":"'"<Write Privacy Relevance Option>"'"
  } 
  ]"
				
			

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"
}

				
			

Status and Error Codes Summary