Skip to main content

Security & Permissions

Department menu → Security and Permissions is where administrators decide who can do what: create calls, add people, see phone numbers, see locations on the map, manage records, adjust inventory … It also hosts the audit log, 2FA enforcement, the department security policy, SSO / SCIM and Advanced Data Protection.

Security and permissions

Permission levels​

Every permission is set to one of four levels. Changes take effect at the member's next login.

LevelWho is allowed
EveryoneAll department members.
Department adminsDepartment administrators and the managing user.
Department + group adminsAlso group/station administrators — usually limited to their own group (e.g. adding users to their group only).
Admins + selected rolesAdministrators plus members holding the roles you tick.

Some visibility permissions have a Group only option that restricts what a member sees to their own group.

The permissions​

People, calls and everyday modules​

PermissionDefaultControls
Who can add users / remove usersDept adminsAdding and removing personnel; group admins are limited to their group.
Who can create / delete / close callsEveryoneManual call creation, deletion and closing.
Who can add data to callsEveryoneNotes, images and files on calls.
Who can create trainingsDept adminsTraining module authoring.
Who can add documents / create calendar entries / create notesEveryoneContent creation in those modules.
Who can add log entries / delete log entriesEveryone / Dept adminsLegacy Logs module (until Records activation).
Who can create shiftsDept adminsShift creation and editing.
Who can view personal infoEveryoneEmail addresses, phone numbers and other PII of other members.
Who can see the location of personnel / unitsEveryoneMap markers and app locations; use Group only to limit to the viewer's group.
Who can send messagesEveryoneIn-system mail.
Who can view users / view unitsEveryoneRestrict the roster and unit list to the viewer's group.
Who can view / edit / delete contactsEveryoneThe Contacts module (members who cannot view contacts cannot attach them to calls).
Use calendar syncEveryoneSubscribe to the department calendar from an external calendar app.
Dispatch app login / Command app loginEveryoneWho may sign in to the Dispatch and Incident Command apps.

Workflows​

PermissionDefault
Create / edit workflowsDept admins
Manage workflow credentialsDept admins
View workflow runsDept admins

Inventory, checklists, work orders​

PermissionDefault
Adjust inventoryEveryone
Transfer inventory / Issue and return inventorySame as Adjust inventory
Manage controlled substancesDept admins
Manage checklists / View checklist resultsDept admins
Manage work orders / View other members' work ordersDept admins

Records​

PermissionDefault
Create records · Void or cancel records · Review · Approve · Finalize · Amend finalized · Submit externally · Print and export · ShareVaries (see Records → Permissions)
View restricted sections · View legacy logs · View records from other groups
Manage record definitions · Publish record definitions · Manage record reports · Manage record disclosures · Manage legal holds · Reassign draft records · Manage prevention dataDept admins

Workforce & Business Ops​

All default to department administrators. See the Workforce & Business Ops overview.

PermissionControls
Manage invoicing / View invoicingCreate, edit, send and void invoices, record payments, rate cards and billing profiles / read-only invoices, aging and PDFs.
Manage certifications / View certifications / Manage certification setupOther members' certification records, credits and unit records / the expiry dashboard / types, role requirements and settings. Members always see their own records.
Manage deployments / Approve time reportsDeployments, rosters, equipment, expenses, files and status, and external orders (which also need Create records); see every deployment / approve and void submitted daily time reports. Rostered members always see their own deployments and file time.
Manage bids / Manage contractsBids and the deployment wizard / service contracts, document requirements and compliance documents.
Manage Cal OES MARS reimbursementAgency, F-5, annual rates, agreements, handoff, observed statuses, invoice approval and payment reconciliation. Rostered members prepare their own F-42 and expense drafts without it.
View internal costsAggregate field-cost summaries, resource cost profiles and usage readings (never a person's rate).
Manage workforce and compensation / View workforce compensationEmployer, establishments, workers, employments, compensation profiles, work entries and pay-fact imports / read-only. Values also need a Protected Data Grant.
Manage California pay data reporting / Export California pay data reportsThe CRD report wizard and demographic records / freezing a run and downloading its files. Members always answer their own demographic response.

Advanced Data Protection​

PermissionPurpose
Manage data protection settings · View / edit protected call data · View protected personnel / contact / operational data · Export protected data · Configure protected data delivery · Emergency break-glass accessSee Advanced Data Protection.

Import & Migration​

These two are fixed to department administrators (and the managing user). They are not listed on this screen and cannot be widened to other members or roles.

PermissionControls
Manage Department Import (72, ManageDepartmentImport)Everything in Import & Migration: upload files, match columns and values, fix issues, approve and run imports, roll them back, activate and invite imported people, and grant or revoke Resgrid support access.
Manage Record Imports (73, ManageRecordImports)Reserved for importing third-party incident history into Records and deleting such an import. Kept separate so a configuration import never implies the right to write history into Records; not used by the current release.

Two-factor enforcement​

Require 2FA for admins: Disabled, Department admins + managing user, or … + group admins. You cannot enable it until you and the managing user both have 2FA on your own accounts. Affected members are sent to the setup page at next login.

Audit logs​

Audit Logs lists every significant operation: timestamp, type (DepartmentSettingsChanged, CallAdded, PersonnelRemoved, PermissionChanged …), a description, the acting member, IP address and user agent. Open an entry to see the before / after snapshots.

Audit logs

Department security policy​

/User/Security/SecurityPolicy — compliance controls for the whole department. Quick presets: Government / CUI, Standard enterprise, Minimal.

Security policy

SettingNotes
Require MFA for all membersMembers without MFA are prompted to enrol at next login.
Require SSO — disable password loginNeeds an active SSO configuration and at least one admin who has tested SSO login.
Session timeout (minutes)0 = system default; 480 = 8 h.
Max concurrent sessions per user0 = unlimited; government environments typically use 1.
Allowed IP ranges (CIDR)Logins from outside are denied. Empty = allow all.
Data classification levelUnclassified / CUI / Confidential — for compliance reporting and audit logs.
Password expiration (days) / minimum lengthLocal logins only. Minimum 8; NIST recommends 12+; CUI requires 14+. Complexity (upper, digit, special) is always enforced.

SSO and SCIM​

/User/Security/Sso — add OIDC (Entra ID, Okta, Auth0, Google) or SAML 2.0 configurations, enable SCIM 2.0 provisioning (auto-create, auto-disable, keep names/emails in sync) and copy the mobile app discovery URL. Full guides: SSO overview, SSO setup, SCIM provisioning.

SSO

API keys​

/User/Security/ApiKeys (the API Keys button on the Security page) — keys that let another system call the Resgrid API for the department without a member's login. Department admins only; creating or revoking a key asks for a fresh second factor, so the admin needs two-factor sign-in set up first.

API keys

  • Create a key: a name (what it is for), what it may do (scopes: read calls, create calls including pending and scheduled ones, update and dispatch calls, close calls, read reference data, read units), when it expires (30 days to 2 years) and, optionally, the IP addresses or CIDR ranges it may be used from.
  • The key (rgk_…) is shown once, right after it is created. Copy it into the other system then; it cannot be shown again.
  • The list shows each key's prefix, scopes, created, expiry and last used time, and its status (Active, Expired, Revoked). Revoke stops a key at once.
  • A department can hold up to 25 active keys. Creating and revoking keys is audit-logged.

How an integration uses a key, the endpoints each scope opens and the error codes: API authentication → Department API keys.

Setup examples​

DepartmentRecommended permission changes
Volunteer fireCreate calls → Admins + Officers; Delete calls → Dept admins; View personal info → Everyone (members need each other's numbers); 2FA for admins.
Career fire / EMSCreate/close calls → Admins + Dispatcher role; View personal info → Admins + Officers; personnel locations Group only; MFA for all; session timeout 720.
SAR / CERTCreate calls → Team leaders; Add documents → Everyone; View unit locations → Everyone.
Emergency managementCreate calls → EOC manager + Operations role; Manage workflows → IT role; data classification CUI; IP ranges for the EOC network if desired.
Security companyView users / units → Group only (clients must not see each other); View contacts → Admins + Site leads; SSO with the corporate IdP; Require SSO.
IndustrialGovernment/CUI preset if regulated; Manage controlled substances → Safety role; audit log reviewed monthly.

Technical reference​

ItemValue
ControllerSecurityController (Index, Audits, ViewAudit, Sso, SsoNew, SsoEdit, ScimSetup, SecurityPolicy, ApiKeys, CreateApiKey, RevokeApiKey)
API keysTable DepartmentApiKeys (migration M0265): name, key prefix, keyed HMAC-SHA256 hash of the key (never the key), scopes, allowed IP ranges, created, expires, last used, revoked. IDepartmentApiKeysService; API scheme DepartmentApiKey (header X-Resgrid-ApiKey) runs only on actions marked [DepartmentApiKeyScope]. Config: SecurityConfig.DepartmentApiKeyPepper (blank = derived from the encryption key), DepartmentApiKeyMaxLifetimeDays (730), DepartmentApiKeyMaxActivePerDepartment (25), DepartmentApiKeyMaxFailuresPerAddress / DepartmentApiKeyFailureWindowMinutes (20 per 10 min). Audit types DepartmentApiKeyCreated, DepartmentApiKeyRevoked.
ActionsSetPermission?type=&level=, SetPermissionData?type= (role ids), GetRolesForPermission?type=, GetAuditLogsList
ModelPermission (PermissionType, Action 0–3, LockToGroup, Data = role ids); PermissionTypes enum; AuditLog
CachePermission changes raise SecurityRefreshEvent to invalidate the authorization matrix; Resgrid.Console --SecurityRefresh refreshes it manually
PoliciesEverything here requires IsUserDepartmentAdmin()