Skip to content
Regulit
Set up

Set your first rules in a minute.

Open the app settings in Jira and configure a default behaviour or your first file types. Connect your own cloud storage, if you want to hold files for approval.

No storage needed to start

Before you start

Four things to know before you start.

  • Jira admin or site admin. Without one of these roles, App settings does not appear next to REGULIT.

  • REGULIT starts switched off. A fresh install checks nothing until you turn on the master switch in App Settings.

  • Nothing is retroactive. A rule applies to new uploads. Files that are already attached on work items stay.

  • Storage is optional. Allowed and Blocked work without a storage, Needs approval is shown and handled like Blocked.

In Jira

Configure your settings.

Open Apps in the left sidebar, click the three dots next to REGULIT for Jira and choose App settings. Five tabs appear.

The App Settings tab with the default category option1. Set the defaultSetting for undefined file types covers every type you have not set. It ships as Needs approval, which without storage means removed.
The file type settings, with a category set per type2. Set your file typesOn the File types tab, choose the global context, a file type and a category. A space that needs something else gets an override for that type.
Bonus

3. Switch on the content check.

Without it, REGULIT goes by the type Jira reports and the extension. With it, a file whose extension, declared type and content disagree is caught and flagged.

  • One switch. Content check compares extension, declared type and the first bytes of every file that is not Blocked.
  • One decision. On a content mismatch: on, a disguised file is blocked at once. Off, it goes to review.
  • Your own types. 22 common types are preset. Add more under Create File Types. Your own types are matched on mimetype and extension only.
Adding a mimetype configuration in Regulit
The Create file types sub-tab.

Storage

Your bucket, your account.

Optional. It decides whether a file set to Needs approval can be held and restored.

The storage settings tab in the Regulit app settingsThree providers, one connectorAmazon S3, Google Cloud Storage or Azure Blob Storage. You deploy a small connector in your own cloud, and every request to it is signed.
The approval queue, empty without a storage configurationWithout it, removal is finalFiles still come off the work item, with a comment and a log entry. Needs approval is handled like Blocked, so nothing can be restored.
Before they upload

Tell people the rule, not just the outcome.

Show the rule before the upload, and say why a file went after it.

  • On the portal and on the work item. Show file type overview to users puts the accepted types on the portal and in the Attachment regulations panel.
  • A comment that explains. REGULIT always comments when it removes or holds a file. You choose whether reporter and uploader are mentioned.
  • A banner in your colour. Banner color sets the background of the overview, so it fits your portal.
A service desk request form showing which file types are allowed
The file type banner on a Jira Service Management portal.

The numbers worth knowing.

22 file typesPresetAdd more under Create File Types
50 MBFixed limitLarger files are not read. Under Needs approval they are removed without a copy.

Questions before you install

Do we need cloud storage to start?

No. Allowed and Blocked work without it. Having no storage connected and active, Needs approval is handled like Blocked and nothing can be restored.

What role do we need?

Jira admin or site admin, to install and configure REGULIT.

Is REGULIT active right after install?

No. A fresh install starts switched off and checks nothing until you turn the master switch "'Enable REGULIT functionality" on.

What happens to file types we never configure?

They follow the default setting for undefined file types, which ships as Needs approval. Without storage that means Blocked, so set it before you switch REGULIT on.

We lost the shared secret. Now what?

It is shown only once. Delete the storage configuration and create it again to get a new one, then update your connector.

Does switching REGULIT off delete our settings?

No. It stops the checks. Your file type settings stay as they are.

Start with one file type.

Set the default to Allowed and one type to Blocked in a test space, switch REGULIT on and upload a file. Setting up a storage can wait until you want the approval queue.