FlightIQ User Guide

FlightIQ helps administrators and developers inspect, compare, copy, migrate, and maintain PingOne DaVinci configuration across environments. It is organized around Identity, Orchestration, and Tools workspaces, with shared source and destination selectors across the top of the app.

Use this overview as the entry point for first-time setup, daily use, migration, and domain guides.

Home

Start with this page when you need the overall map of the guide. The left navigation is organized into setup content first, then product usage content.

Initial Setup

Use these guides before expecting domain data to load:

  1. First-Time FlightIQ Setup: use the startup configuration page shown when no tenant apps are configured.
  2. PingOne Worker App Configuration: create and configure the PingOne app used for backend API access.
  3. PingOne User Auth App Configuration: create and configure the OIDC login app used by FlightIQ users.
  4. Worker App Setup: enter and test backend API credentials in FlightIQ.
  5. User Authentication Setup: enter and test login app settings in FlightIQ.

The worker app and login app are different PingOne applications. The worker app lets the backend read and write PingOne and DaVinci artifacts. The login app signs users into FlightIQ.

Using the App

After initial setup, select an Org Root, source environment, and destination environment or repository target. Then open the workspace for the domain you want to inspect, compare, copy, or migrate.

Core usage guides:

  • FlightIQ Director: run guided DaVinci flow migrations, upgrades, dependency resolution, naming, versioning, aliases, and final execution.

Identity domains:

Orchestration domains:

Home

The Home workspace is the starting hub. Use it to move into the major FlightIQ areas.

Identity

Identity workspaces focus on PingOne identity artifacts:

  • Notification Templates
  • Forms
  • Attributes
  • Certificates

Orchestration

Orchestration workspaces focus on DaVinci artifacts:

  • Flows
  • Applications
  • Connectors
  • Variables

Tools

Tools contains specialized utilities:

  • NodeIQ for focused node editing and custom HTML previews.
  • RBAC Explorer for reviewing role and access behavior when enabled.

ReplaceIQ is available inside Flow Inspector rather than as a standalone sidebar tool.

Shared Table Workflows

Most FlightIQ workspaces use the same table patterns:

  • Use the workspace header search to narrow rows.
  • Clear search and filters if a table looks unexpectedly empty.
  • Click a row to open details or an editor.
  • Use row checkboxes for multi-select copy, delete, backup, or bulk actions.
  • Review source and destination panes together when comparing or copying artifacts.
  • Confirm match indicators before copy, upgrade, delete, revert, or bulk operations.

External Repositories

FlightIQ can work with local folders, GitHub, and Bitbucket when enabled in Settings > External Integrations.

Repository targets can appear alongside PingOne environments in the source and destination selectors. Repository operations follow the selected provider at runtime, so GitHub credentials are not used for Bitbucket operations and Bitbucket credentials are not used for GitHub operations.

Configure repository settings before selecting a repository target:

  • Provider enabled state
  • Repository owner or workspace
  • Repository name
  • Branch
  • Base path
  • Access token
  • Optional token expiry date
  • Commit message template

Safety Checklist

Before running copy, upgrade, delete, revert, migration, or bulk operations:

  1. Confirm the selected Org Root.
  2. Confirm source and destination environments.
  3. Clear filters if selected row counts seem unexpected.
  4. Review match indicators and destination names.
  5. Export backups where available.
  6. Resolve all blocking issues.
  7. Review final confirmation modals before executing.

Troubleshooting

No Data Appears

Confirm:

  • An Org Root is selected.
  • The source environment is selected.
  • Backend API credentials test successfully.
  • Search and filters are cleared.
  • Your user has access to the selected environment and domain.

API Returns 401 or 403

Check:

  • Worker app client ID and client secret.
  • Tenant environment ID.
  • User access assignments if RBAC mode is enabled.
  • Whether the selected user or worker app has the required PingOne roles.

Repository Actions Are Disabled

Check:

  • The provider is enabled in External Integrations.
  • Required repository settings are saved.
  • Local folder access has been granted for Local Repository.
  • Token has not expired for GitHub or Bitbucket.

UI State Looks Stale

Refresh the browser tab. FlightIQ stores selected workspace, environment choices, labels, and some settings locally so the app can restore context between sessions.