This page serves as a high level reference guide to what .decimal logs for user interactions with our software. There are 3 different sections detailed here for the use cases of user logging:
Note: This section is applicable to Auth0 user logins only.
Auth0 user logins use the user's email as the user name. If your username is not an email you have a legacy login and this section is not applicable.
.decimal uses Auth0 as its user authentication service. Auth0 logs user actions including:
Note: These logs are not directly accessible by end users, but may be provided by .decimal staff upon request.
See below for example logs for common Auth0 events:
{ "date": "2022-05-11T12:13:02.783Z", "type": "Success Exchange", "client_id": "<REDACTED>", "client_name": "decimal Launcher", "ip": "<REDACTED>", "user_agent": "Electron 5.0.13 / Windows 10.0.0", "hostname": "dotdecimal.us.auth0.com", "user_id": "<REDACTED>", "user_name": "<REDACTED>", "isMobile": false, }
{ "date": "2022-05-11T13:24:10.066Z", "description": "Wrong email or password.", "connection": "decimal", "client_name": "decimal Launcher", "ip": "<REDACTED>", "user_agent": "Electron 5.0.13 / Windows 10.0.0", "details": { "error": { "message": "Wrong email or password." } }, "user_id": "<REDACTED>", "user_name": "<REDACTED>", "isMobile": false }
{ "date": "2022-05-11T13:54:35.190Z", "description": "User (<REDACTED>) attempted 10 consecutive logins unsuccessfully. Brute force protection is enabled for this connection, further attempts are blocked from this IP address for this user.", "connection": "decimal", "connection_id": "<REDACTED>", "client_id": "<REDACTED>", "ip": "<REDACTED>", "user_agent": "Electron 5.0.13 / Windows 10.0.0", "hostname": "dotdecimal.us.auth0.com", "user_id": "", "user_name": "<REDACTED>", "isMobile": false }
Customer Applications include .decimal developed applications used by end clinical users that are downloaded and installed on the customer's local computers. These may include, but are not limited to: p.d, decimal3D, decimal Launcher, and decimal eRT. See each application below for an example activity log.
p.d logs the local user activity and records the following information to its local application database:
Log Item | Description |
---|---|
username | The username/email of the user performing the action |
patientName | An encrypted string for the patient the log entry applies to |
medicalRecordNumber | An encrypted string for the patient's MRN the log entry applies to |
uniquePlanName | An encrypted string for the plan the log entry applies to |
planName | An encrypted string for the plan the log entry applies to |
logDate | The local date time of the log entry |
logEvent | The event that the log entry is for. logEvents include, but are not limited to: -User log in -User log out -Plan Open -Plan Save -Plan Close -Order placed to decimal Direct -Local and DICOM AE file export (e.g.: DICOM) -Patient deletion |
decimal3D logs the local user activity and records the following information to its local application database. This information is exportable from the Advanced menu option within the application.
Log Item | Description |
---|---|
User ID | The username/email of the user performing the action |
Action | The action the user performed (see below for an itemized list) |
Date/Time | The local date time the action was performed. Actions include, but are not limited to: -User log in attempts -User log in success/fail -User log out -View patients list -View patient info (including patient MRN) -Create new scans/contours -Orders placed to decimal Direct (including beam name) -Local and AE file exports (e.g.: DICOM) -Patient deletion |
decimal eRT logs the local user activity and records the following information to its local patient database. This information is exportable from the Organization Configuration → Export Logs block within the application.
Log Item | Description |
---|---|
Hardware ID | Local Windows computer name |
ID | The ID of the corresponding Data Type of the log entry |
Date | The date time of the log entry |
Log Event | The event that was logged. Log Event's include, but are not limited to: -Import Patients -View Patients -Open Patients -Import Courses -Update Course -Create Plans -Update Plans -Clone Plans -Open Plans -Update Organization -Export DICOM files locally -Export DICOM files to AE service -Approve Plans -Order files to decimal Direct -Export Reports |
Data Type | What data caused to the log entry. Data Type's include, but are not limited to: -Application (root level interactions without a specific data to link to) -Organization -Patient -Course -Plan -Export -Order |
Username | The users first and last name that caused the log entry |
Users will interact with the decimal Direct website to perform certain tasks. For each logged interaction in Direct the following is recorded:
Log Item | Description |
---|---|
UserID | Internal .decimal user ID that links to a user |
Log Route | The API route (i.e.: action taken) for the log |
Parameters | The parameters of the action |
TimeStamp | The data time (as Eastern Time) of the action |
See below for the outline of what user interactions are recorded.
A normal user interaction includes any non-elevated user tasks that are performed. Normal user interactions that are logged include:
Log Category | Log Event |
---|---|
Login (legacy non-Auth0 users only) | Login attempt |
Login success/fail | |
Ordering | Order File Upload |
Order Placed | |
User Preferences | Email Notifications Changed |
Password changed (legacy non-Auth0 users only) |
A manager user interaction includes any elevated user tasks that are performed by the site manager within the Management pages. Manager user interactions that are logged include:
Log Event | Captured Data |
---|---|
Site Management | Site Info (address) Update |
Application Management | Version Change |
User Management | User Add |
User Remove | |
User Info Edit | |
User Permissions Edit |
Other .decimal applications that connect to decimal Direct and .decimal logs some integration connections for diagnostic trouble shooting. These interactions include and capture:
Log Event | Captured Data |
---|---|
Application Login | User |
Date Time | |
Site ID | |
Application | |
Website Legacy User Login | User |
Date Time | |
Website Auth0 User Login | User |
Date Time |