Body
Who can use this feature?
- Protected attribute logs are available in TDAdmin.
- License Requirement: Enterprise
- Administrative Access: User must be a Global Administrator with the org-level-admin permission, Can Create/Modify Attribute Protections
The Protected Attribute Access Log and Protected Attribute Configuration Log give you an audit trail for protected custom attributes (PCAs). Use them to see who viewed or edited a PCA value and who changed a PCA’s settings. Each application that supports PCAs (Ticketing, Asset, and Project) has its own set of logs.
In this article, we’ll cover:
Protected Attribute Log Types
| Log Type |
What it records |
Columns |
| Access Log |
Each time a PCA value is viewed or edited |
Date, Type, User, Attribute, Item, Item ID, Old Value, New Value, IP Address |
| Configuration Log |
Changes to a PCA’s settings |
Date, User, Attribute, Change, IP Address |
Where to Find This
Only Global Administrators with the Can Create/Modify Attribute Protections permission can open these logs. Application administrators cannot open them, even for their own application.
You can open the logs for all of an application’s PCAs at once, or for a single attribute.
Open the logs for an application
In TDAdmin, navigate to the log for your application:
- Ticketing applications: Applications > [Ticketing application] > Protected Attribute Access Log or Protected Attribute Configuration Log
- Asset/CI applications (assets and configuration items): Applications > [Asset application] > Custom Attributes > Protected Attribute Access Log or Protected Attribute Configuration Log
- Project applications (issues and risks): Applications > [Project application] > Custom Attributes > Protected Attribute Access Log or Protected Attribute Configuration Log
Open the logs for a single attribute
- In TDAdmin, navigate to the attribute:
- Tickets: Applications > [Ticketing application] > Attributes
- Assets & Configuration Items: Applications > [Asset/CI application] > Custom Attributes > Asset Attributes or Configuration Item Attributes
- Issues & Risks: Applications > [Project application] > Custom Attributes > Issue Attributes or Risk Attributes
- Click the name of the protected attribute.
- Click the Access Log or Configuration Log tab.
The Access Log tab shows the same information as the application-level log for that attribute, without the Attribute column.
Using the Access Log
What creates a log entry
- Clicking the eye icon to display a PCA value creates a View entry.
- Editing a PCA value creates two separate entries with the same date and time: one View entry and one Edit entry.
- Creating an item and filling in a PCA creates an Edit entry with no View entry.
Read the Access Log
Each row in the Access Log is one view or edit of a PCA value, and it includes these columns:
- Date — When the entry was created.
- Type — View when a user displayed the value, or Edit when a user entered or changed it.
- User — The user who viewed or edited the value.
- Attribute — The protected attribute. This column appears only on the application-level log.
- Item — The ticket, asset, configuration item, issue, or risk that holds the value.
- Item ID — The ID of that item.
- Old Value and New Value — The value before and after the entry. These are hidden by default. See Show attribute values.
- IP Address — The IP address the user was working from.
To sort the log, click a column heading. If the results span more than one page, use the page numbers at the bottom of the log.
Filter the log by date
- In the Date fields, enter a start date and an end date.
- Click Search.
Show attribute values
By default, the Old Value and New Value fields show [Hidden] for security purposes.
- Check the Show attribute values checkbox.
- The Old Value and New Value fields display on the screen.
Export the log
Click the To Excel button to export the log to a spreadsheet.
Warning: Selecting Show attribute values is not logged, and exporting To Excel includes the values. Anyone who can open the Access Log can see PCA values this way.
Using the Configuration Log
The Configuration Log records changes to a PCA’s settings. You can sort it, filter it by date, and export it To Excel the same way you use the Access Log. It does not hide any values, and it has no Show attribute values checkbox. When you change more than one setting in a single save, the changes appear together in one entry.
Each row in the Configuration Log is one change to a PCA’s settings, and it includes these columns:
- Date — When the change was made.
- User — The user who made the change.
- Attribute — The protected attribute.
- Change — A description of what changed, such as:
- Created a new protected custom attribute configuration.
- Added group(s) [group name].
- Changed Is PIN Auth Required for Technician from “No” to “Yes”.
- Changed Visibility Duration in Seconds from “0” to “10”.
- IP Address — The IP address the user was working from.