First Steps After Installation
Congratulations! You've successfully installed SecureHealth. This guide will help you configure your instance and get familiar with the system.
Initial Configurationβ
Step 1: Access the Applicationβ
- Open your web browser
- Navigate to
http://localhost:8000(or your configured domain) - You should see the SecureHealth login page
Step 2: Log In with Demo Accountsβ
Use one of the pre-configured demo accounts:
Admin Account
- Username:
admin@securehealth.dev - Password:
admin123 - Access: Full system administration
Doctor Account
- Username:
doctor@securehealth.dev - Password:
demo123 - Access: Full patient data and medical records
Nurse Account
- Username:
nurse@securehealth.dev - Password:
demo123 - Access: Medical data and patient care information
Receptionist Account
- Username:
receptionist@securehealth.dev - Password:
demo123 - Access: Basic patient information and scheduling
Exploring the Interfaceβ
Dashboard Overviewβ
After logging in, you'll see the main dashboard with:
- Patient Search: Quick search for patient records
- Recent Activity: Latest system activities and audit logs
- Role-Specific Widgets: Information relevant to your user role
- Quick Actions: Common tasks based on your permissions
Navigation Menuβ
The main navigation includes:
- Patients: Patient management and records
- Appointments: Scheduling and calendar management
- Medical Records: Clinical data and documentation
- Reports: Analytics and compliance reporting
- Admin: System administration (admin users only)
Understanding Role-Based Accessβ
Doctor Role (Full Access)β
- View all patient information
- Access complete medical records
- Perform clinical decision support queries
- Manage drug interaction checking
- Access audit logs and compliance reports
Nurse Role (Medical Data Access)β
- View patient medical information
- Access care coordination tools
- Check medication administration records
- Limited access to sensitive personal data
- View relevant audit logs
Receptionist Role (Basic Information)β
- Access patient contact information
- Manage appointment scheduling
- View basic patient demographics
- Limited access to medical data
- Basic audit log viewing
Key Features to Exploreβ
1. Patient Search and Recordsβ
Try This:
- Use the search bar to find a patient
- Notice how search works on encrypted data
- View the patient record
- Observe how data appears differently based on your role
What to Notice:
- Search results are returned from encrypted data
- Different roles see different levels of detail
- Audit logs track all access attempts
2. Encryption Visualizationβ
Try This:
- Navigate to a patient record
- Click the "X-Ray View" button
- Compare encrypted vs. decrypted data views
- Switch between different user roles
What to Notice:
- Raw encrypted data in the database
- How encryption preserves searchability
- Role-based data filtering in action
3. Audit Loggingβ
Try This:
- Perform various actions (search, view records, etc.)
- Navigate to the Audit Logs section
- Review the detailed access logs
- Notice the comprehensive tracking
What to Notice:
- Every action is logged with timestamps
- User identity and role are tracked
- Data access patterns are recorded
- Compliance reporting capabilities
4. Role Switchingβ
Try This:
- Log out and log in with different user accounts
- Perform the same actions with different roles
- Notice how the interface and data access changes
- Compare the audit logs between roles
What to Notice:
- Interface adapts to user role
- Data access is properly restricted
- Audit logs reflect role-based access
- Security controls are enforced
Configuration Tasksβ
Step 1: Update Default Passwordsβ
Important: Change all default passwords before using in any environment other than development.
# Change admin password
php bin/console app:user:change-password admin@securehealth.dev
# Change demo user passwords
php bin/console app:user:change-password doctor@securehealth.dev
php bin/console app:user:change-password nurse@securehealth.dev
php bin/console app:user:change-password receptionist@securehealth.dev
Step 2: Configure Encryption Keysβ
# Verify encryption configuration
php bin/console app:encryption:status
# List available encryption keys
php bin/console app:encryption:list-keys
# Test encryption functionality
php bin/console app:encryption:test
Step 3: Set Up Monitoringβ
# Check system health
php bin/console app:health:check
# View system statistics
php bin/console app:stats:show
# Test audit logging
php bin/console app:audit:test
Common Initial Tasksβ
1. Create Your First Patientβ
- Navigate to "Patients" β "Add New Patient"
- Fill in patient information
- Notice how sensitive fields are encrypted
- Save and view the patient record
- Check the audit logs for the creation event
2. Schedule an Appointmentβ
- Go to "Appointments" β "Schedule Appointment"
- Select a patient and time slot
- Add appointment details
- Save the appointment
- Review the audit trail
3. View Medical Recordsβ
- Search for a patient
- Click on their medical records
- Notice the role-based data filtering
- Try the X-Ray view to see encrypted data
- Review the access logs
4. Generate Reportsβ
- Navigate to "Reports"
- Generate a compliance report
- Review audit log summaries
- Export data (if your role permits)
- Check the audit trail for report generation
Security Best Practicesβ
1. User Managementβ
- Create individual user accounts for each team member
- Assign appropriate roles based on job functions
- Regularly review user access and permissions
- Implement strong password policies
2. Audit Reviewβ
- Regularly review audit logs
- Monitor for unusual access patterns
- Set up alerts for security events
- Maintain audit log retention policies
3. Data Protectionβ
- Verify encryption is working properly
- Test role-based access controls
- Validate audit logging functionality
- Ensure compliance with HIPAA requirements
Troubleshooting Common Issuesβ
Login Problemsβ
Issue: Cannot log in with demo accounts Solution:
# Reset demo user passwords
php bin/console app:user:reset-passwords
Search Not Workingβ
Issue: Patient search returns no results Solution:
# Check encryption configuration
php bin/console app:encryption:status
# Verify database connection
php bin/console doctrine:mongodb:schema:validate
Audit Logs Missingβ
Issue: No audit logs appearing Solution:
# Enable audit logging
php bin/console app:audit:enable
# Check audit configuration
php bin/console app:audit:status
Next Stepsβ
Now that you're familiar with the basics:
- Learn Security Concepts - Understand the underlying technology
- Explore User Guides - Role-specific documentation
- Developer Guides - Technical implementation details
- Tutorials - Step-by-step implementation guides
Getting Helpβ
If you need assistance:
- Check the troubleshooting guide
- Review GitHub issues
- Join community discussions
- Contact support through the application
Congratulations! You're now ready to explore SecureHealth's advanced features and learn how to implement similar HIPAA-compliant systems using MongoDB Queryable Encryption.