Skip to main content
Version: 1.0.0

Tenant Administration Setup

Use this guide before opening the platform to operational users. The setup order matters because users, roles, organization structure, and workflows are reused by every module.

1. Setup Principle

Configure structure first, then operate records.

If users start creating risks, assessments, policies, incidents, or audits before roles and workflows are stable, records may have the wrong owner, wrong approval path, or incomplete reporting data.

2. What to Configure First

OrderSetup AreaWhy It Comes First
1Enabled modulesDetermines which roles, workflows, templates, and reports are needed.
2Departments and job positionsUsed by ownership, workflow routing, reporting, and user profile context.
3Roles and permissionsControls what each user can view, create, edit, approve, export, or delete.
4UsersUsers should be invited after role and organization structure exists.
5WorkflowsApproval routes require users, roles, and owners.
6Templates and settingsReusable defaults reduce inconsistent records.
7Frameworks and module baselinesNeeded before assessments, controls, and compliance reporting.
8Operational module rolloutStart business usage only after access and approval behavior is tested.

3. Users

User records are the identity foundation for ownership, tasks, approvals, assignments, comments, and audit trail.

User Fields Administrators Should Confirm

FieldWhy It Matters
NameAppears in assignments, approvals, and reports.
EmailUsed for login, notifications, and task routing.
RoleControls permissions.
DepartmentSupports reporting, ownership, and workflow context.
Job PositionSupports organization structure and responsibility context.
Manager / Reporting RelationshipUseful for escalation and approval design where enabled.
StatusInactive users should not receive new ownership or approval assignments.

User Setup Flow

  1. Create departments and job positions.
  2. Create roles.
  3. Invite or create users.
  4. Assign role, department, job position, and manager.
  5. Confirm user status is active.
  6. Assign module responsibilities such as risk owner, compliance owner, auditor, policy owner, or incident manager.
  7. Test login and access with a pilot user before inviting all users.

User Governance Rules

  • Do not assign records to inactive users.
  • Review users when someone changes department or job position.
  • Remove or downgrade access when a user no longer needs administrator rights.
  • Keep at least two tenant administrators to avoid access dependency on one person.

4. Roles and Permissions

Roles define what a user can do. Keep roles practical and aligned with real responsibilities.

RoleTypical Access
Tenant AdministratorSetup, users, roles, workflows, templates, and full administration.
GRC ManagerCross-module oversight, reports, approvals, and management review.
Compliance OwnerFrameworks, assessments, evidence, findings, and compliance reporting.
Risk OwnerRisk register, treatment, actions, evidence, and reassessment.
AuditorAudit planning, findings, evidence review, and audit reports.
Policy OwnerPolicies, exceptions, acknowledgements, and change requests.
Incident ManagerIncidents, issues, response, and remediation tracking.
Third-Party OwnerVendor/third-party profiles, reviews, files, and related risks.
Asset OwnerAsset records, ownership, criticality, and linked risks.
Privacy OwnerProcessing activities, DSAR, PIA, consent, transfers, and data flows.
Training CoordinatorCourses, campaigns, surveys, and role requirements.
Executive ViewerRead-only dashboards and reports.

Permission Design Rules

  • Separate create/update permissions from approve permissions.
  • Restrict delete permissions to administrators or module managers.
  • Give export permissions only to users who are allowed to handle report data.
  • Avoid one broad role for all operational users.
  • Use read-only roles for executives and auditors who should not change records.

5. Organization Structure

Create departments, job positions, and reporting relationships before assigning ownership.

Used by:

  • risk and control ownership
  • assessment assignment
  • policy acknowledgement targeting
  • workflow routing
  • reports and dashboards
  • audit and accountability history

Recommended flow:

  1. Create departments.
  2. Create job positions.
  3. Add users to departments and positions.
  4. Confirm managers or reporting lines where used.
  5. Review structure quarterly or when the organization changes.

6. Workflows

Workflows control review and approval. They should be configured only after roles and users are ready.

Workflow Concepts

ConceptMeaning
TriggerThe module event that starts the workflow, such as submit assessment or approve policy.
StepA review or approval stage.
AssigneeUser, role, owner, or function responsible for the step.
DecisionApprove, reject, send back, or complete depending on module.
Workflow StatusIndicates whether the item is waiting, approved, rejected, or completed.

Workflow Setup Flow

  1. Decide which module requires approval.
  2. Define the trigger, such as assessment submit, policy approval, exception approval, risk acceptance, or change approval.
  3. Choose one-step or multi-step approval.
  4. Assign approvers by role or named user.
  5. Define rejection behavior.
  6. Test with a pilot record.
  7. Confirm audit trail and notifications.
  8. Train users to use the Workflow tab when a workflow is active.

Workflow Rules Users Must Know

  • If a workflow is active, direct lifecycle actions may be blocked.
  • The approver should act from the Workflow tab or assigned task.
  • Rejection should include a reason.
  • Workflow history becomes approval evidence.
  • Changing workflow rules after records are in progress can create confusion; test before rollout.

7. Templates and Settings

Templates standardize repeated work.

Common templates/settings:

  • risk templates
  • document templates
  • policy templates
  • training templates
  • assessment defaults
  • incident response templates
  • notification and SLA settings

Administrator rule: templates should be prepared before large-scale module usage, otherwise users may create inconsistent records.

8. Frameworks and Baselines

Before assessments begin:

  1. Confirm active frameworks.
  2. Confirm control ownership.
  3. Confirm applicability tags and organization type.
  4. Confirm control weights.
  5. Decide whether to use global framework content or tenant-specific copies.

9. Go-Live Checklist

  • Modules enabled and visible.
  • Departments and job positions created.
  • Roles created and tested.
  • Users invited with correct role and department.
  • Workflows configured and pilot-tested.
  • Templates and settings prepared.
  • Frameworks selected and owners confirmed.
  • Reports reviewed for expected data.
  • Administrators know how to monitor overdue tasks and workflow queues.

Screenshot

Settings