Summary
This article covers what to do to prepare for your upgrade to Policy-based Access Control (PBAC). Before the upgrade, download your access reports to capture a baseline. After the upgrade, re-download and compare them to confirm that access carried over correctly.
Before your upgrade: download your access reports
The one action to take before your upgrade is downloading your access reports. These capture a complete snapshot of your current permissions and serve as your baseline for confirming that access carried over correctly after the upgrade. They are also your first tool for investigating any unexpected differences.
What the reports include
| Report | What it shows |
| Core group details | All groups in your instance, their members, and seat types |
| Access impact | How many workflow configurations, active workflows, and records each group can access |
| Record access | Which specific records each group can access |
| Workflow configuration access | Which groups can access which workflow configurations, and what actions they can take |
| Permissions summary | A full summary of what each group has access to. Available before the upgrade only. This will be replaced by the Access Rules report after the upgrade. |
How to download your access reports
- Go to Company Settings > Groups.
- Select Export group access reports.
- Select all report types.
- Select Export. The reports will be emailed to you.
Save all reports before your upgrade date. You will need them for the post-upgrade comparison.
After your upgrade: re-download and compare
Once your upgrade is complete, re-download the access reports using the same steps above and compare them to your pre-upgrade baseline.
What's new in the post-upgrade reports
You will now see an Access Rules report in place of the Permissions Summary report. This is expected. The Access Rules report shows the Local Access Rules that were automatically created on each group when PBAC was enabled. These are the same permissions your groups had before, now in the new format.
How to compare before and after
For the access impact, record access, and workflow configuration access reports:
- Open the before and after versions side by side.
- The numbers and records listed should be identical across both sets.
- Any difference is worth investigating before closing out your validation.
What a successful validation looks like
- Every group shows the same number of workflow configurations, active workflows, and records it had before the upgrade.
- Specific records accessible to each group are unchanged.
- Workflow configuration access matches the pre-upgrade report.
Optional: test access directly in the product
Some teams prefer to verify access beyond the reports. Common checks to run:
- A user who belongs to one group — confirm they can access only what that group allows.
- A user who belongs to multiple groups — their access should equal the combined total of all groups they belong to.
- Someone who launches a workflow — confirm they still can.
- Someone who accesses completed records — confirm they still can.
- An admin with scoped permissions — confirm they can manage only the groups or users they should.
If something looks different
Access under PBAC is additive. A user's total access equals the combined permissions across every group they belong to. If something looks unexpected, start by checking every group the user is a member of. A rule or policy on another group is often the source.
If you cannot identify the cause, contact Ironclad Support with the affected user, group, resource type, and action.
Next steps
- Organize your permissions with Access Policies after your upgrade — an optional next step for consolidating Local Access Rules into shared policies
- Access Policies — a full overview of how Access Policies work in the product