FAQ & Troubleshooting
General Questions
What is AIIA?
AIIA is an AI-enabled internal audit platform that covers the complete audit lifecycle — from audit universe management and annual planning through fieldwork, reporting, and continuous monitoring. It is designed for Saudi enterprises and aligned with Vision 2030.
What browsers are supported?
| Browser | Minimum Version | Status |
|---|---|---|
| Chrome | 100+ | ✅ Recommended |
| Microsoft Edge | 100+ | ✅ Fully Supported |
| Safari | 16+ | ✅ Supported |
| Firefox | 100+ | ✅ Supported |
Is AIIA available in Arabic?
Yes. AIIA supports full bilingual operation in English (EN) and Arabic (AR) with complete RTL layout support. Switch languages via the language toggle in the top navigation bar.
Can AIIA run without internet (on-prem)?
Yes. AIIA supports fully air-gapped on-prem deployment. AI features use Ollama for local LLM processing without internet access. All infrastructure (PostgreSQL, Redis, MinIO, Keycloak) runs locally via Docker.
What audit standards does AIIA support?
AIIA aligns with:
- IIA International Professional Practices Framework (IPPF)
- NCA Essential Cybersecurity Controls (ECC)
- PDPL — Saudi Personal Data Protection Law
- CSCC — Cloud Security Compliance Certification
- SAMA CSF — Saudi Monetary Authority Cyber Security Framework
- ISO 27001, COSO, COBIT, SOX
Authentication & Access
I can't log in
- Check your credentials — ensure you're using the correct username/password
- SSO redirect issues — clear browser cookies and try again
- Account locked — contact your IT administrator
- Keycloak down — check if the Keycloak service is running
I can see a page but can't edit anything
Your role may not have edit permissions. Check with your administrator:
- Viewer role = read-only access
- Client role = PBC portal only
- Auditor role = fieldwork and findings
- Manager role = engagement management
- CAE role = full audit access
- Admin role = full system access
How do I reset my password?
Click Forgot Password on the login page, or contact your IT administrator to reset via Keycloak.
AI Features
AI suggestions are not appearing
| Check | Solution |
|---|---|
| AI model configured? | Administration → AI Models — add a provider |
| Connection test passes? | Test the connection in AI Models settings |
| Your role has AI access? | ai:suggest permission required |
| AI features enabled? | Check subscription tier includes AI |
AI responses are slow
| Cause | Solution |
|---|---|
| Cloud provider latency | Switch to a faster model or local Ollama |
| Large context window | Reduce scope of the question |
| Server resources | Increase server RAM/CPU allocation |
AI gives inaccurate suggestions
- Check the confidence score — low scores indicate uncertainty
- Provide more context — be specific in your request
- Verify citations — check the source references
- Report the issue — use the thumbs-down feedback button
Can AI access data from other organizations?
No. AI retrieval is strictly scoped by org_id and user roles. Cross-organization data leakage is prevented at the database level with Row-Level Security.
Engagements & Fieldwork
I can't create a new engagement
- You need the Manager or CAE role
- Check the
engagement:createpermission
Workpaper review fails with "SoD violation"
You cannot review your own workpaper. Segregation of Duties requires a different user to be the reviewer. Assign a colleague as the reviewer.
Evidence upload fails
| Error | Solution |
|---|---|
| File too large | Maximum 50MB per file |
| Unsupported format | Supported: PDF, Word, Excel, Images, ZIP |
| Virus detected | File was flagged by the scanner — do not upload |
| Storage full | Contact admin to check MinIO storage |
Can I delete evidence after upload?
No. Evidence files are immutable after upload to maintain chain-of-custody. If you uploaded the wrong file, upload the correct one and note the error in the workpaper.
Reports & Exports
PDF export has formatting issues
- Use simple table layouts for best PDF compatibility
- Avoid very wide tables (>6 columns)
- Check that custom fonts are available on the server
Board pack is missing findings
- Only findings from selected engagements are included
- Check the engagement selection in the board pack builder
- Findings in "Draft" status are not included — they must be finalized
Performance
Pages load slowly
| Cause | Solution |
|---|---|
| Large dataset | Use filters to narrow the view |
| Network issues | Check internet connection |
| Browser extensions | Disable ad blockers and extensions |
| Server resources | Contact admin to check resource allocation |
Dashboard widgets show "No data"
- Check that the date range filter is set correctly
- Verify you have access to the underlying data
- Some widgets require specific module data to exist (e.g., findings, KRIs)
Still Need Help?
- Check module-specific troubleshooting — each module has its own troubleshooting page
- Review the Audit Trail — for recent changes
- Contact your IT Administrator — for system and permission issues
- Check Release Notes — for known issues and fixes