Entering Sensitive Data
This guide explains how to securely enter and update Tax File Numbers (TFN) and Director Identification Numbers (DIN) for individuals in StructureGram.
Understanding the Input Process
When you enter a TFN or DIN, StructureGram follows a secure process to protect your data:
- You enter the full number in a standard form field
- The data is encrypted immediately when you save the record
- Only the encrypted version is stored in the database
- The last 3 digits are saved separately for display purposes
- The original number is never stored in plain text
This all happens automatically - you don't need to do anything special except enter the number correctly.
Entering Data in Individual Forms
Creating a New Individual
When creating a new individual with sensitive data:
- Navigate to Individuals from the main menu
- Click "Add Individual" to open the creation form in the slide-out panel
- Fill in required fields (First Name, Last Name, Sex)
- Scroll to the Sensitive Information section
- Enter the TFN and/or DIN as needed:
- TFN: Enter 8 or 9 digits (spaces optional, e.g., "123456789" or "123 456 789")
- DIN: Enter 15 digits (spaces optional, e.g., "123456789012345" or "123 456 789 012 345")
- Click "Create & Close" to create the individual (or Create & Add Another to start the next one)
The numbers you entered are immediately encrypted before being stored.
Updating Existing Individuals
To update sensitive data for an existing individual:
- Find the individual using search or browse pages
- Click to view the individual's details
- Click "Edit" to open the editing form in the slide-out panel
- You'll see masked values like "*** *** 789" for existing data
- To change a value:
- Click the lock icon next to the field to reveal the current value
- The full number displays for 30 seconds
- Edit the number as needed
- The new value is encrypted when you save
- Click "Save" to update the individual
Input Format and Validation
TFN (Tax File Number)
Format: 8 or 9 digits (older TFNs have 8)
- Can be entered with or without spaces; anything that isn't a digit is dropped as you type, and the field formats the number for you
- System accepts:
876543210,876 543 210or the 8-digit371 186 29 - The wrong number of digits shows the error "TFN must be 8 or 9 digits"
- A number that fails the ATO check-digit test shows the warning "TFN does not pass check-digit validation". You can still save it, but check it for a typo first
Examples:
- ✅
876 543 210(9 digits) - ✅
371 186 29(8 digits) - ⚠️
123 456 789(right length, but fails the check-digit test) - ❌
1234567(too short)
DIN (Director Identification Number)
Format: 15 digits total (5 groups of 3)
- Can be entered with or without spaces; anything that isn't a digit is dropped as you type
- System accepts:
123456789012345or123 456 789 012 345 - The wrong number of digits shows an error
Examples:
- ✅
123456789012345 - ✅
123 456 789 012 345 - ❌
12345678901234(must be 15 digits)
What Happens When You Save
When you click "Save" on a form containing TFN or DIN data:
1. Data Transmission (Encrypted)
- Your data travels over a secure HTTPS connection
- The connection is encrypted using TLS (the same security used by banks)
- No one can intercept or read the data in transit
2. Server-Side Encryption
- The server receives your data over the secure connection
- The TFN/DIN is immediately encrypted using AES-256-GCM encryption
- The last 3 digits are extracted and stored separately for UI display
- The original plain text number is never written to the database
3. Database Storage
- Only the encrypted version is stored in the database
- The last 3 digits are stored in plain text (e.g., "789")
- The encrypted data looks like random characters to anyone viewing the database directly
4. Confirmation
- You'll see a success message
- The form closes or updates to show the masked value
- The individual's record now shows "*** *** 789" instead of the full number
Security Features During Data Entry
Visual Indicators
When working with sensitive fields, you'll see:
- 🔒 Lock Icon: Indicates the field contains encrypted data
- Masked Display: Shows "*** *** [last 3 digits]" when viewing
- Tooltip Information: Hover over the lock icon to learn about encryption
- Auto-hide Timer: Revealed values automatically hide after 30 seconds
Data Entry Form
<img src="/images/help/sensitive-data-entry.png" alt="Sensitive data entry form showing masked TFN field" />The form includes:
- Clear labels for TFN and DIN fields
- Format hints (e.g., "Optional - Must be 8 or 9 digits if provided" or "Optional - Must be exactly 15 digits if provided")
- Lock icons indicating encryption protection
- Validation to ensure correct format
Common Scenarios
Scenario 1: Entering a New TFN
Task: You need to add a TFN for a new individual.
Steps:
- Create or edit the individual
- Locate the "Tax File Number (TFN)" field
- Type the 8- or 9-digit number (with or without spaces)
- Complete other required fields
- Click "Create & Close" for a new individual, or "Save" when editing
Result: The TFN is encrypted and stored securely. You'll see "*** *** [last 3 digits]" when viewing the record.
Scenario 2: Updating an Incorrect DIN
Task: You discover an incorrect DIN needs to be corrected.
Steps:
- Open the individual's edit form
- Find the "Director Identification Number (DIN)" field showing "*** *** *** *** 345"
- Click the lock icon to reveal the full current value
- Verify the current number and identify the error
- Enter the correct 15-digit DIN
- Click "Save"
Result: The new DIN is encrypted and stored, replacing the old value.
Scenario 3: Adding Missing Sensitive Data
Task: An individual record exists but is missing TFN/DIN data.
Steps:
- Navigate to the individual's detail page
- Click "Edit" to open the form
- The TFN and DIN fields will be empty
- Enter the missing data as needed
- Click "Save"
Result: The new sensitive data is encrypted and added to the record.
Data Entry from Diagrams
You can also enter sensitive data through the diagram inspector:
- Open an Ownership or Family Tree diagram
- Click on an individual in the diagram
- The inspector panel opens on the right side
- Scroll to the Sensitive Information section
- Enter or update TFN/DIN as needed
- Click "Save" at the bottom of the inspector. Save and Cancel appear once you change something; Cancel puts the fields back as they were
The same encryption and security processes apply when entering data through the diagram inspector.
Removing a Stored TFN or DIN
A stored TFN or DIN is shown masked (for example "*** *** 789") and is kept unless you change the field. To remove it:
- Open the record for editing, or select the individual in a diagram to open the inspector
- Empty the field: reveal the number with the lock icon and delete its digits, or type in the field and delete what you typed
- In the diagram inspector, the field now reads Saving removes the TFN (or Saving removes the DIN)
- Click Save to remove it, or Cancel to keep the stored number
Until you edit it, a stored number is never changed by saving other fields: the inspector notes "TFN is only saved when edited".
Best Practices for Data Entry
✅ DO:
- Double-check numbers before saving - encrypted data is hard to verify later without revealing it
- Use the reveal function to verify existing data before making changes
- Enter data in a secure location where others can't see your screen
- Empty the field and save if you need to remove a TFN/DIN (see Removing a Stored TFN or DIN)
❌ DON'T:
- Copy and paste from unsecured sources - ensure your clipboard is cleared afterward
- Leave the entry form open unattended with sensitive data visible
- Enter dummy or test data - only enter real, verified numbers
- Share your screen while entering sensitive data
Troubleshooting
"Invalid TFN format" Error
Problem: The system won't accept your TFN.
Solutions:
- Ensure you're entering 8 or 9 digits
- Remove any hyphens, spaces, or other characters (the system will format it for you)
- Check for typos or missing digits
"Invalid DIN format" Error
Problem: The system won't accept your DIN.
Solutions:
- Ensure you're entering exactly 15 digits
- Remove any hyphens or special characters
- Verify you have 5 groups of 3 digits
Can't See the Sensitive Data Fields
Problem: The TFN/DIN fields aren't visible in the form.
Solutions:
- Check the entity type: a DIN is recorded only for an Individual. Companies, trusts, partnerships and SMSFs have a TFN field but no DIN
- Scroll down in the form - sensitive fields are typically near the bottom
- Ensure you have permission to view/edit sensitive data in your organization
Revealed Data Won't Stay Visible
Problem: When you reveal a TFN/DIN, it hides too quickly.
Solutions:
- This is by design - revealed data automatically hides after 30 seconds for security
- Click the lock icon again to reveal the data for another 30 seconds
- If you need to reference the number, consider writing it down temporarily (then destroy the note when done)
Audit and Compliance
Every time you enter or update sensitive data:
- An audit record is created automatically
- The record includes:
- Your user ID
- The timestamp
- The action taken (created or updated)
- Organization administrators can review these audit logs
- This helps with compliance reporting and security monitoring
You don't need to do anything special - the audit trail is automatic.
Need Help?
If you encounter any issues entering or updating sensitive data:
- Check this guide for common solutions
- Contact your organization administrator for permission issues
- Reach out to support if you believe there's a system problem
Remember: Take your time when entering sensitive data. It's better to verify carefully than to have to reveal and correct it later.