Access Analyzer Debug logs
Summarize
Summary of Access Analyzer Debug Logs
Access Analyzer debug logs provide detailed insights into the evaluation of access controls for specific operations within the ServiceNow platform. These logs are essential for administrators and developers to troubleshoot access issues, optimize security configurations, and ensure appropriate user access to resources.
Show less
Key Features
- Fields in Debug Logs: The logs detail various aspects of access control evaluation, including:
- Name: Identifies the business rule or ACL.
- Applies to: Indicates the level of ACL application (Field, Record, Table).
- Status: Shows the ACL status (Passed, Blocked, Skipped).
- Required ACL roles: Lists roles needed for resource access.
- Role: Details on role status (blocked, passed, skipped).
- Security Attribute: Evaluation result of the security attribute.
- Condition: Evaluation result of the condition.
- Script: Evaluation result of the script.
- Customized: Indicates the presence of customized ACLs.
- Application: Status of the application (Global or Store).
- Evaluation Hierarchy: Access permissions are evaluated in a specific order, including Business Rules, Access Handlers, Data Filtration, and Access Control Lists (ACLs).
- Execution Sequence: The order of execution for determining access involves evaluating inherited ACLs first, followed by wildcard ACLs, allowing for optimized permission checks.
Key Outcomes
Using Access Analyzer debug logs enables customers to:
- Identify and troubleshoot access issues effectively.
- Optimize security configurations based on detailed evaluations.
- Ensure users have the necessary access to perform their functions while maintaining security standards.
Access Analyzer debug logs supply detailed information about the evaluation of access controls for a specific operation. These logs assist administrators and developers in troubleshooting access issues, optimizing security configurations, and ensuring that users have appropriate access to resources within the ServiceNow platform.
Fields in Debug logs
For a given operation, the debug logs show a granular view of how ACLs, business rules, and other security attributes are evaluated.
Following are the fields and their description in the Debug logs:
| Fields | Description |
|---|---|
| Name | Details about the business rule or ACL. You can select the business rule or ACL for more information. |
| Applies to | Indicates the level at which the ACL is applied, for example, Field, Record, or Table. |
| Status | The status of the ACL for the associated role and permission, for example, Passed, Blocked, or Skipped. |
| Required ACL roles | Specifies the roles necessary for access to the resource. |
| Role | Provides details about the status of roles in terms of access control, for example, blocked, passed, or skipped. |
| Security Attribute | The details about the security attribute evaluated as Blocked, Passed, or Skipped for the Access Control. |
| Condition | The details about the condition evaluated as blocked, passed, or skipped for the Access Control. |
| Script | The details about the script evaluated as blocked, passed, or skipped for the Access Control. |
| Customized | Indicates if any customized ACLs are included in the access control. |
| Application | Status of the Application. Global or Store. |
Evaluation hierarchy
Permissions for the selected user, group, or role are evaluated in the following hierarchy:
- Business rule: A business rule is a server-side script that runs when a record is read, inserted, updated, or deleted, or when a table is queried.
- Access Handler: An internal system check using hidden source code on the platform.
- Data Filtration: A data filter is a form of access control designed to work along with the existing Access Control rules (ACLs) on your instance. Data filters support only read operations.
- Access control list (ACL): Rules for access control lists (ACLs) restrict access to specific data by requiring users to pass a set of requirements before they can interact with it. Within an ACL, the following
hierarchy is evaluated:
- Role
- Security Attribute
- Condition
- Script
Access control list evaluation
ACLs for the operations are evaluated in the following order:
- Role
- Security Attribute
- Condition
- Script
Presence of a script
Alert Icon in any status indicates the presence of a script in the ACL. Review highlighted ACLs to understand the final access.
Sequence of execution
The order of execution for determining access in different scenarios is as follows:
- Presence of an inherited or wildcard ACL: During the sequence of execution, the inherited ACLs are evaluated first and then wildcard ACLs.
- If one ACL is passed, the others are skipped: During execution and evaluation of permissions, if one ACL is passed, the other ACLs' execution and evaluations are skipped. They are skipped because overall permissions for the selected operation require only one ACL to access a field, record, or table for an identity.
- Field level ACL and table level ACLs execution: During execution, field level ACLs are executed first, followed by table level ACLs. This provides more granular results when analyzing access for an identity.
- Evaluation in the presence of scripted ACL: When a script is present, the overall access for the operation is passed with an Alert icon to indicate that there's a script in the ACL.