Administration

Overview

All administrative settings are in the Admin tab, accessible to Jira site administrators only. This page covers execution identity, trigger controls, and security permissions. For other admin features, see the sub-pages below.

Health check

Database maintenance and integrity tools (migrations, duplicate detection, storage usage, data integrity). See Admin Tools - Health Check for details.

Diagnostic logging

Time-limited diagnostic logging for troubleshooting trigger and script execution issues:

  • When enabled, detailed info-level logs are written for all trigger invocations
  • Logs include: trigger invocations, script start/complete events, timing, skip reasons
  • No sensitive data is logged (source code, issue data, PII are excluded)
  • Duration options: 5 minutes to 14 days - auto-disables after the chosen duration
  • Diagnostic logs are written to the Forge runtime log. Contact the app vendor if you need access to raw logs

Configure execution identity

Controls which execution identities are available to scripts.

Mode Description Default
Current User Scripts run with the triggering user’s permissions Always available
Application Scripts run with app-level permissions (Forge impersonation) Off
Pre-configured Users Admin-defined user list for script execution Off
Specific User Search for any Jira user to run as Off

Pre-configured users

When enabled, admins can create a list of users with optional descriptions. Script authors select from this dropdown in the Console or Config tab.

What “Run As Application” means

When a script runs as Application, it uses the Forge app’s own permissions (with impersonation). This gives broader access than any individual user and is independent of who triggered the script. Use this for automated tasks that need system-level access.

Note: If a mode is disabled after scripts are configured to use it, a warning is shown but existing configurations are preserved.

Run As configuration panel


Enable and disable trigger types

Toggle each trigger type on/off globally:

Trigger Type Description
Scheduled Recurring timer triggers
Event Jira event triggers
Async Event Async event triggers
UIM UI Modification triggers
Scripted Fields Custom field computation
Automation Jira Automation action triggers
Rovo Rovo AI Agent script access
Workflow Post Function Workflow transition post functions
Workflow Validator Workflow transition validators
Workflow Condition Workflow transition conditions (Jira Expressions)
Webtrigger Webhook HTTP triggers

Disabled types preserve existing configurations but prevent execution. All toggles are recorded in the audit log.

Event type settings

Fine-grained control over which Jira event types trigger scripts. Only applies to scripts with Event triggers.

  • 32 event types available (issue_created, issue_updated, etc.)
  • 7 core events enabled by default: issue_created, issue_updated, issue_deleted, issue_assigned, comment_created, comment_deleted, comment_mentioned
  • Disable specific event types to reduce unnecessary script executions
  • Changes are recorded in the audit log

Audit trigger type settings

Control which trigger types are logged in the Script Runs Audit:

Trigger Type Default Description
Manual Enabled Console executions
Scheduled Enabled Scheduled trigger runs
Event Enabled Event trigger runs
UIM Enabled UIM trigger runs
Scripted Fields Disabled Custom field computations (high volume)
Async Event Enabled Async event runs
Automation Enabled Automation action runs
Rovo Enabled Rovo action runs
Workflow Post Function Enabled Workflow post function runs
Workflow Validator Enabled Workflow validator runs
Workflow Condition Enabled Workflow condition evaluations
Webtrigger Enabled Webhook trigger runs

Scripted Fields auditing is disabled by default because field computations can produce a high volume of audit entries.


Track script usage

Track where scripts are used across your Jira instance.

Click Collect Information to scan all workflows and custom fields for script references. The usage table shows:

Column Description
Script Script name (or truncated ID if deleted)
Type Usage type - Post Function, Validator, Condition, or Custom Field
Location Workflow name (for workflow rules) or field name (for custom fields)
Version Current (green), Outdated (orange), or - (no version tracking)

Each script also has a Where Used action in the Library context menu.


Manage UI modifications

Manage UI Modification registrations:

  • View all registered UIMs (Jira and JSM separately)
  • Delete specific UIMs by context
  • Re-register all UIMs (recreates registrations for all UIM-triggered scripts)
  • Delete all UIMs

Security and permissions

App scopes

JiBrok Studio for Jira Cloud requires 45 OAuth scopes across 9 categories:

Category Count Features Impersonation
App Internal 4 Storage, UIM registration, GDPR, licensing No
Issue Data 10 Console scripts, triggers, scripted fields, automation Yes
Project Data 3 Project info, components, versions in scripts Yes
Jira Software 4 Boards, sprints, epics Mixed
JSM 1 Service desk request types for UIM config No
JSM Assets/CMDB 7 CMDB objects, schemas, types in scripts Yes
Field/Screen Config 13 Scripted custom fields module No
Rovo 1 Rovo AI agent integration No
Jira Administration 2 UIM registration, project config No

For a detailed explanation of each category and why it’s needed, see Security Overview.

Data and privacy

Personal data stored:

  • Account IDs in run logs, version history, and audit logs

Data retention:

  • Audit run records: rolling (see Limits)
  • Version history: limited per script (see Limits)
  • Settings audit: rolling (see Limits)

GDPR personal data reporting is supported through the Forge platform.


Administration sub-pages


Next steps