-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathapp.py
More file actions
1423 lines (1188 loc) · 56.9 KB
/
app.py
File metadata and controls
1423 lines (1188 loc) · 56.9 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
import os
import logging
import uuid
import json
from datetime import datetime
from flask import Flask, render_template, redirect, url_for, flash, request, abort, send_from_directory, jsonify
from markupsafe import Markup, escape
from flask_login import LoginManager, current_user, login_user, logout_user, login_required
from flask_sqlalchemy import SQLAlchemy
from sqlalchemy.orm import DeclarativeBase
from werkzeug.middleware.proxy_fix import ProxyFix
from werkzeug.security import generate_password_hash, check_password_hash
from werkzeug.utils import secure_filename
from flask_limiter import Limiter
from flask_limiter.util import get_remote_address
import secrets
import string
from dotenv import load_dotenv
load_dotenv()
# Setup logging
# Use INFO level for production (less verbose than DEBUG)
logging_level = logging.INFO if not os.environ.get("FLASK_DEBUG") else logging.DEBUG
logging.basicConfig(
level=logging_level,
format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
datefmt='%Y-%m-%d %H:%M:%S'
)
logger = logging.getLogger(__name__)
class Base(DeclarativeBase):
pass
db = SQLAlchemy(model_class=Base)
# Create the app
app = Flask(__name__)
app.secret_key = os.environ.get("SESSION_SECRET", secrets.token_hex(16))
# Explicitly set debug mode to False for production
# Can be overridden with FLASK_DEBUG environment variable
app.config['DEBUG'] = False
app.wsgi_app = ProxyFix(app.wsgi_app, x_proto=1, x_host=1) # needed for url_for to generate with https
# Initialize rate limiter with more robust settings for production
limiter = Limiter(
get_remote_address,
app=app,
default_limits=["1000 per day", "300 per hour", "30 per minute"],
storage_uri="memory://", # In production, consider using redis or memcached
strategy="moving-window", # More accurate than fixed-window
headers_enabled=True, # Send rate limit headers
swallow_errors=True, # Don't fail if rate limiter fails
default_limits_per_method=True # Apply rate limits per HTTP method
)
# Configure the database
db_url = os.environ.get("DATABASE_URL")
if db_url and db_url.startswith("postgres://"):
# Fix for SQLAlchemy 1.4+ compatibility
db_url = db_url.replace("postgres://", "postgresql://", 1)
app.config["SQLALCHEMY_DATABASE_URI"] = db_url
app.config["SQLALCHEMY_ENGINE_OPTIONS"] = {
"pool_recycle": 300, # Recycle connections after 5 minutes of inactivity
"pool_pre_ping": True, # Verify connections before use to avoid stale connections
"pool_size": 10, # Increase connection pool size for production
"max_overflow": 20, # Allow up to 20 additional connections in high-load situations
"pool_timeout": 30 # Connection timeout in seconds
}
app.config["SQLALCHEMY_TRACK_MODIFICATIONS"] = False
# Configure upload settings
app.config["UPLOAD_FOLDER"] = "uploads/evidence"
app.config["MAX_CONTENT_LENGTH"] = 16 * 1024 * 1024 # 16 megabytes max upload size
app.config["ALLOWED_EXTENSIONS"] = {'txt', 'pdf', 'png', 'jpg', 'jpeg', 'gif', 'doc', 'docx'}
# Initialize the database
db.init_app(app)
# Ensure upload directory exists and has proper permissions
upload_dir = app.config["UPLOAD_FOLDER"]
if not os.path.exists(upload_dir):
try:
os.makedirs(upload_dir, mode=0o750, exist_ok=True)
logger.info(f"Created upload directory: {upload_dir}")
except Exception as e:
logger.error(f"Failed to create upload directory: {str(e)}")
# Initialize login manager
login_manager = LoginManager()
login_manager.init_app(app)
login_manager.login_view = 'login'
login_manager.login_message_category = 'danger'
# Import models after db initialization
from models import RVIUser as User, AuditLog, MatrixToken, VettingForm, VettingEvidence, UserPreferences
# Add secure headers to all responses
@app.after_request
def add_security_headers(response):
# Content Security Policy - Balanced approach
if app.debug:
# Development mode - permissive policy
csp_policy = (
"default-src * 'unsafe-inline' 'unsafe-eval'; "
"script-src * 'unsafe-inline' 'unsafe-eval'; "
"style-src * 'unsafe-inline'; "
"img-src * data: blob:; "
"font-src * data:; "
"connect-src *; "
"frame-ancestors 'self'; "
"base-uri 'self'; "
"form-action 'self'; "
"object-src 'none'; "
"upgrade-insecure-requests; "
)
else:
# Production mode - stricter policy
csp_policy = (
"default-src 'self'; "
"script-src 'self' https://cdn.jsdelivr.net https://code.jquery.com 'unsafe-inline'; "
"style-src 'self' https://cdn.jsdelivr.net https://cdn.replit.com https://cdnjs.cloudflare.com 'unsafe-inline'; "
"img-src 'self' data:; "
"font-src 'self' https://cdn.jsdelivr.net https://cdnjs.cloudflare.com data:; "
"connect-src 'self'; "
"frame-ancestors 'self'; "
"base-uri 'self'; "
"form-action 'self'; "
"object-src 'none'; "
"upgrade-insecure-requests; "
)
# Get domain name from request for production use
domain = request.host.split(':')[0] if request.host else None
if domain and domain != 'localhost' and domain != '127.0.0.1':
# Add report-uri for production
csp_policy += f"report-uri /csp-report;"
response.headers['Content-Security-Policy'] = csp_policy
# Prevent MIME type sniffing
response.headers['X-Content-Type-Options'] = 'nosniff'
# XSS Protection
response.headers['X-XSS-Protection'] = '1; mode=block'
# Click-jacking protection
response.headers['X-Frame-Options'] = 'SAMEORIGIN'
# Strict Transport Security (only in production)
if not app.debug:
response.headers['Strict-Transport-Security'] = 'max-age=31536000; includeSubDomains'
# Referrer Policy
response.headers['Referrer-Policy'] = 'strict-origin-when-cross-origin'
# Feature Policy
response.headers['Permissions-Policy'] = 'camera=(), microphone=(), geolocation=()'
return response
@login_manager.user_loader
def load_user(user_id):
return User.query.get(int(user_id))
# Import forms
from forms import LoginForm, ChangePasswordForm, UserRegistrationForm, MatrixRegistrationForm, VettingFormClass, UserPreferencesForm
from utils import generate_random_password, send_account_notification
# Helper functions for file uploads
def allowed_file(filename):
return '.' in filename and filename.rsplit('.', 1)[1].lower() in app.config['ALLOWED_EXTENSIONS']
def save_evidence_file(file, form_id, notes=None):
"""Save an evidence file and return the VettingEvidence object"""
if not file or file.filename == '':
return None
if not allowed_file(file.filename):
flash(f'File type not allowed for {file.filename}', 'danger')
return None
# Create a unique filename
filename = secure_filename(file.filename)
unique_filename = f"{uuid.uuid4().hex}_{filename}"
file_path = os.path.join(app.config['UPLOAD_FOLDER'], unique_filename)
# Save the file
try:
file.save(file_path)
# Create evidence record
evidence = VettingEvidence(
vetting_form_id=form_id,
filename=filename,
file_path=file_path,
file_type=file.content_type if hasattr(file, 'content_type') else None,
file_size=len(file.read()) if hasattr(file, 'read') else None,
notes=notes
)
# Reset file position after reading for size
if hasattr(file, 'seek'):
file.seek(0)
return evidence
except Exception as e:
logger.error(f"Error saving file: {str(e)}")
flash(f'Error saving file: {str(e)}', 'danger')
return None
# Custom filters
@app.template_filter('datetime_format')
def datetime_format(value, format='%Y-%m-%d %H:%M:%S'):
if value is None:
return ""
return value.strftime(format)
@app.template_filter('timestamp_format')
def timestamp_format(value, format='%Y-%m-%d %H:%M:%S'):
"""Format a Unix timestamp to human-readable date."""
if not value:
return "Unknown"
try:
# Convert Unix timestamp to datetime
dt = datetime.fromtimestamp(int(value))
return dt.strftime(format)
except (ValueError, TypeError) as e:
logger.error(f"Error formatting timestamp {value}: {str(e)}")
return "Invalid timestamp"
@app.template_filter('nl2br')
def nl2br(value):
if value:
return Markup(value.replace('\n', '<br>'))
# Context processors
@app.context_processor
def inject_current_year():
return {'current_year': datetime.utcnow().year}
@app.context_processor
def inject_pending_forms():
try:
if hasattr(current_user, 'is_authenticated') and current_user.is_authenticated:
if hasattr(current_user, 'is_superadmin') and (current_user.is_superadmin() or current_user.is_server_admin()):
try:
pending_forms = VettingForm.query.filter_by(status='submitted').count()
return {'pending_forms': pending_forms}
except Exception as e:
logger.error(f"Error getting pending forms: {str(e)}")
return {'pending_forms': 0}
except Exception as e:
logger.error(f"Error in inject_pending_forms: {str(e)}")
return {'pending_forms': 0}
# Create routes
@app.route('/csp-report', methods=['POST'])
def csp_report():
"""Endpoint to receive CSP violation reports"""
try:
# Accept both JSON and form data submissions
content_type = request.headers.get('Content-Type', '')
if 'application/json' in content_type:
data = request.get_json(silent=True)
if data:
report_data = data.get('csp-report', {})
else:
report_data = {'error': 'Empty JSON data'}
elif 'application/csp-report' in content_type:
# Some browsers use this content type
try:
report_data = json.loads(request.data.decode('utf-8')).get('csp-report', {})
except:
report_data = {'error': 'Invalid CSP report format'}
else:
# Fall back to raw data for any other content type
report_data = {'raw': request.data.decode('utf-8', errors='replace')}
# Log CSP violations
logger.warning(f"CSP Violation: {json.dumps(report_data)}")
return jsonify({'status': 'received'}), 204
except Exception as e:
logger.error(f"Error processing CSP report: {str(e)}")
return jsonify({'status': 'error'}), 500
@app.route('/service-worker.js')
def service_worker():
"""Serve the service worker from the root, which is required for PWA functionality"""
return app.send_static_file('js/service-worker.js')
@app.route('/offline')
def offline():
"""Serve the offline page when the user is offline"""
return render_template('offline.html')
@app.route('/manifest.json')
def manifest():
"""Serve the manifest file from the root for PWA functionality"""
return app.send_static_file('manifest.json')
@app.route('/')
def index():
if not current_user.is_authenticated:
return redirect(url_for('login'))
if current_user.needs_password_change:
flash('Please change your temporary password before continuing.', 'warning')
return redirect(url_for('change_password'))
if current_user.is_superadmin() or current_user.is_server_admin():
return redirect(url_for('admin_dashboard'))
else:
return redirect(url_for('agent_dashboard'))
@app.route('/login', methods=['GET', 'POST'])
@limiter.limit("5 per minute; 20 per hour")
def login():
if current_user.is_authenticated:
return redirect(url_for('index'))
form = LoginForm()
if form.validate_on_submit():
user = User.query.filter_by(username=form.username.data).first()
if user and check_password_hash(user.password_hash, form.password.data):
login_user(user)
# Log the login event
log_entry = AuditLog(
user_id=user.id,
action="login",
details=f"User logged in from IP: {request.remote_addr}",
ip_address=request.remote_addr
)
db.session.add(log_entry)
# Update last login time
user.last_login = datetime.utcnow()
db.session.commit()
next_page = request.args.get('next')
if not next_page or not next_page.startswith('/'):
next_page = url_for('index')
return redirect(next_page)
else:
flash('Invalid username or password', 'danger')
return render_template('login.html', form=form)
@app.route('/logout')
@login_required
def logout():
# Log the logout event
log_entry = AuditLog(
user_id=current_user.id,
action="logout",
details=f"User logged out from IP: {request.remote_addr}",
ip_address=request.remote_addr
)
db.session.add(log_entry)
db.session.commit()
logout_user()
flash('You have been logged out.', 'info')
return redirect(url_for('login'))
@app.route('/change-password', methods=['GET', 'POST'])
@login_required
@limiter.limit("3 per minute; 10 per hour")
def change_password():
form = ChangePasswordForm()
if form.validate_on_submit():
if check_password_hash(current_user.password_hash, form.current_password.data):
current_user.password_hash = generate_password_hash(form.new_password.data)
current_user.needs_password_change = False
# Log the password change
log_entry = AuditLog(
user_id=current_user.id,
action="password_change",
details="User changed their password",
ip_address=request.remote_addr
)
db.session.add(log_entry)
db.session.commit()
flash('Your password has been updated.', 'success')
return redirect(url_for('index'))
else:
flash('Current password is incorrect.', 'danger')
return render_template('change_password.html', form=form)
@app.route('/user-preferences', methods=['GET', 'POST'])
@login_required
def user_preferences():
# Check if user has preferences, create if they don't
if not current_user.preferences:
new_preferences = UserPreferences(user_id=current_user.id)
db.session.add(new_preferences)
db.session.commit()
db.session.refresh(current_user)
form = UserPreferencesForm()
# On GET, populate form with current preferences
if request.method == 'GET':
form.theme.data = current_user.preferences.theme
form.animation_enabled.data = current_user.preferences.animation_enabled
form.tooltip_enabled.data = current_user.preferences.tooltip_enabled
# Populate token colors
token_colors = current_user.preferences.get_token_colors()
form.token_available_color.data = token_colors.get('available', 'bg-info')
form.token_used_color.data = token_colors.get('used', 'bg-success')
form.token_pending_color.data = token_colors.get('pending', 'bg-warning')
form.token_expired_color.data = token_colors.get('expired', 'bg-danger')
form.token_error_color.data = token_colors.get('error', 'bg-danger')
# Populate role colors
role_colors = current_user.preferences.get_role_colors()
form.superadmin_color.data = role_colors.get('superadmin', 'bg-danger')
form.server_admin_color.data = role_colors.get('server_admin', 'bg-warning')
form.inviting_admin_color.data = role_colors.get('inviting_admin', 'bg-primary')
form.vetting_agent_color.data = role_colors.get('vetting_agent', 'bg-info')
# Populate status colors
status_colors = current_user.preferences.get_status_colors()
form.active_status_color.data = status_colors.get('active', 'bg-success')
form.pending_status_color.data = status_colors.get('pending', 'bg-warning')
form.awaiting_token_status_color.data = status_colors.get('awaiting_token', 'bg-info')
form.rejected_status_color.data = status_colors.get('rejected', 'bg-danger')
form.draft_status_color.data = status_colors.get('draft', 'bg-secondary')
form.submitted_status_color.data = status_colors.get('submitted', 'bg-primary')
# On POST, save the preferences
if form.validate_on_submit():
# Update theme and option preferences
current_user.preferences.theme = form.theme.data
current_user.preferences.animation_enabled = form.animation_enabled.data
current_user.preferences.tooltip_enabled = form.tooltip_enabled.data
# Update token colors
token_colors = {
'available': form.token_available_color.data,
'used': form.token_used_color.data,
'pending': form.token_pending_color.data,
'expired': form.token_expired_color.data,
'error': form.token_error_color.data
}
current_user.preferences.token_colors = json.dumps(token_colors)
# Update role colors
role_colors = {
'superadmin': form.superadmin_color.data,
'server_admin': form.server_admin_color.data,
'inviting_admin': form.inviting_admin_color.data,
'vetting_agent': form.vetting_agent_color.data
}
current_user.preferences.role_colors = json.dumps(role_colors)
# Update status colors
status_colors = {
'active': form.active_status_color.data,
'pending': form.pending_status_color.data,
'awaiting_token': form.awaiting_token_status_color.data,
'rejected': form.rejected_status_color.data,
'draft': form.draft_status_color.data,
'submitted': form.submitted_status_color.data
}
current_user.preferences.status_colors = json.dumps(status_colors)
# Update last modified timestamp (handled by onupdate)
# Log the preference change
log_entry = AuditLog(
user_id=current_user.id,
action="preferences_updated",
details="User updated their preferences",
ip_address=request.remote_addr
)
db.session.add(log_entry)
db.session.commit()
flash('Your preferences have been updated.', 'success')
return redirect(url_for('user_preferences'))
return render_template('user_preferences.html', form=form)
# File routes
@app.route('/uploads/evidence/<filename>')
@login_required
def serve_evidence_file(filename):
"""Serve an evidence file securely"""
return send_from_directory(app.config['UPLOAD_FOLDER'], filename)
@app.route('/agent/evidence/<int:evidence_id>/info', methods=['GET'])
@login_required
def evidence_info(evidence_id):
"""Debug information about an evidence file"""
evidence = VettingEvidence.query.get_or_404(evidence_id)
vetting_form = VettingForm.query.get(evidence.vetting_form_id)
if not vetting_form or (vetting_form.user_id != current_user.id and not current_user.is_server_admin()):
abort(403)
info = {
'id': evidence.id,
'filename': evidence.filename,
'vetting_form_id': evidence.vetting_form_id,
'file_path': evidence.file_path,
'exists': os.path.exists(evidence.file_path),
'form_status': vetting_form.status,
'user_is_owner': vetting_form.user_id == current_user.id,
'user_is_admin': current_user.is_server_admin()
}
return jsonify(info)
@app.route('/agent/evidence/<int:evidence_id>/delete', methods=['POST'])
@login_required
def delete_evidence_file(evidence_id):
"""Delete an evidence file"""
# Log the request for debugging
logger.debug(f"Delete request for evidence ID: {evidence_id}")
logger.debug(f"POST data: {request.form}")
evidence = VettingEvidence.query.get_or_404(evidence_id)
logger.debug(f"Found evidence record: ID={evidence.id}, File={evidence.filename}")
# Verify ownership or admin rights
vetting_form = VettingForm.query.get(evidence.vetting_form_id)
if not vetting_form:
logger.error(f"Vetting form not found for ID: {evidence.vetting_form_id}")
abort(404)
logger.debug(f"Vetting form: ID={vetting_form.id}, User={vetting_form.user_id}, Current user={current_user.id}")
if vetting_form.user_id != current_user.id and not current_user.is_server_admin():
logger.warning(f"Permission denied for user {current_user.id} to delete evidence {evidence_id}")
abort(403)
# Check if the form is editable
if vetting_form.status in ['approved', 'rejected']:
flash('You cannot delete evidence from a processed form.', 'warning')
return redirect(url_for('edit_vetting_form', form_id=evidence.vetting_form_id))
# Delete the file from filesystem
try:
if os.path.exists(evidence.file_path):
logger.debug(f"Removing file from disk: {evidence.file_path}")
os.remove(evidence.file_path)
else:
logger.warning(f"File not found on disk: {evidence.file_path}")
except Exception as e:
logger.error(f"Error deleting file: {str(e)}")
# Log the deletion
log_entry = AuditLog(
user_id=current_user.id,
action="evidence_deleted",
details=f"Deleted evidence file: {evidence.filename} from vetting form ID: {evidence.vetting_form_id} (ID: {evidence.id})",
ip_address=request.remote_addr
)
db.session.add(log_entry)
# Delete the database record
form_id = evidence.vetting_form_id
try:
logger.debug(f"Deleting evidence record from database: {evidence.id}")
db.session.delete(evidence)
db.session.commit()
logger.debug("Database commit successful")
except Exception as e:
db.session.rollback()
logger.error(f"Database error during deletion: {str(e)}")
flash(f'Error deleting file: {str(e)}', 'danger')
return redirect(url_for('edit_vetting_form', form_id=form_id))
flash(f'Evidence file "{evidence.filename}" deleted successfully.', 'success')
return redirect(url_for('edit_vetting_form', form_id=form_id))
# Admin Routes
@app.route('/admin/dashboard')
@login_required
def admin_dashboard():
if not (current_user.is_superadmin() or current_user.is_server_admin()):
abort(403)
user_count = User.query.count()
recent_logs = AuditLog.query.order_by(AuditLog.timestamp.desc()).limit(10).all()
recent_tokens = MatrixToken.query.order_by(MatrixToken.created_at.desc()).limit(10).all()
pending_forms = VettingForm.query.filter_by(status='submitted').count()
awaiting_token_forms = 0
# Only count awaiting_token_forms for inviting_admin and above
if current_user.is_inviting_admin():
awaiting_token_forms = VettingForm.query.filter_by(status='awaiting_token').count()
return render_template('admin/dashboard.html',
user_count=user_count,
recent_logs=recent_logs,
recent_tokens=recent_tokens,
pending_forms=pending_forms,
awaiting_token_forms=awaiting_token_forms)
@app.route('/admin/register-user', methods=['GET', 'POST'])
@login_required
@limiter.limit("10 per hour")
def register_user():
if not (current_user.is_superadmin() or current_user.is_server_admin()):
abort(403)
form = UserRegistrationForm()
# Only show server_admin option for superadmin
if not current_user.is_superadmin():
form.role.choices = [
('vetting_agent', 'Vetting Agent'),
('inviting_admin', 'Inviting Admin')
]
if form.validate_on_submit():
# Generate a random temporary password
temp_password = generate_random_password()
# Determine registration status
# Superadmins can create any account immediately
# Server admins need approval for creating vetting_agent and inviting_admin accounts
if current_user.is_superadmin() or form.role.data == 'server_admin':
status = 'active'
approved_by = current_user.id
approved_at = datetime.utcnow()
else:
status = 'pending'
approved_by = None
approved_at = None
# Create the new user
new_user = User(
username=form.username.data,
email=form.email.data,
password_hash=generate_password_hash(temp_password),
role=form.role.data,
needs_password_change=True,
created_by=current_user.id,
status=status,
approved_by=approved_by,
approved_at=approved_at
)
db.session.add(new_user)
# Log the user creation
action = "user_created" if status == 'active' else "user_created_pending"
details = f"Created new user: {form.username.data} with role: {form.role.data}"
if status == 'pending':
details += " (awaiting approval)"
log_entry = AuditLog(
user_id=current_user.id,
action=action,
details=details,
ip_address=request.remote_addr
)
db.session.add(log_entry)
db.session.commit()
# Only send notifications for active users
if status == 'active':
try:
send_account_notification(
admin_email=current_user.email,
user_email=new_user.email,
username=new_user.username,
admin_name=current_user.username
)
flash(f'User {new_user.username} created successfully. Temporary password: {temp_password}', 'success')
flash('Notification emails have been sent.', 'info')
except Exception as e:
logger.error(f"Email notification error: {str(e)}")
flash(f'User created, but email notifications failed. Temporary password: {temp_password}', 'warning')
else:
flash(f'User {new_user.username} created and awaiting approval from a Superadmin or Server Admin.', 'info')
return redirect(url_for('user_list'))
return render_template('admin/register_user.html', form=form)
@app.route('/admin/users')
@login_required
def user_list():
if not (current_user.is_superadmin() or current_user.is_server_admin()):
abort(403)
users = User.query.all()
# Get count of pending users
pending_users_count = User.query.filter_by(status='pending').count()
return render_template('admin/user_list.html', users=users, pending_users_count=pending_users_count)
@app.route('/admin/approve-user/<int:user_id>', methods=['GET', 'POST'])
@login_required
def approve_user(user_id):
if not (current_user.is_superadmin() or current_user.is_server_admin()):
abort(403)
# Get the user to approve
user = User.query.get_or_404(user_id)
# Check if user is pending
if user.status != 'pending':
flash('This user is not pending approval.', 'warning')
return redirect(url_for('user_list'))
# Check if user is trying to approve their own created user
if user.created_by == current_user.id:
flash('You cannot approve a user you created. Another admin must approve this user.', 'warning')
return redirect(url_for('user_list'))
# Check if trying to approve a server_admin (only superadmin can do this)
if user.role == 'server_admin' and not current_user.is_superadmin():
flash('Only a Superadmin can approve a Server Admin account.', 'danger')
return redirect(url_for('user_list'))
if request.method == 'POST':
action = request.form.get('action')
notes = request.form.get('notes', '')
if action not in ['approve', 'reject']:
flash('Invalid action.', 'danger')
return redirect(url_for('user_list'))
if action == 'approve':
user.status = 'active'
user.approved_by = current_user.id
user.approved_at = datetime.utcnow()
user.approval_notes = notes
# Generate a random temporary password
temp_password = generate_random_password()
user.password_hash = generate_password_hash(temp_password)
# Log the approval
log_entry = AuditLog(
user_id=current_user.id,
action="user_approved",
details=f"Approved user: {user.username} with role: {user.role}",
ip_address=request.remote_addr
)
db.session.add(log_entry)
db.session.commit()
# Send notification
try:
send_account_notification(
admin_email=current_user.email,
user_email=user.email,
username=user.username,
admin_name=current_user.username
)
flash(f'User {user.username} approved successfully. Temporary password: {temp_password}', 'success')
flash('Notification emails have been sent.', 'info')
except Exception as e:
logger.error(f"Email notification error: {str(e)}")
flash(f'User approved, but email notifications failed. Temporary password: {temp_password}', 'warning')
else: # reject
user.status = 'rejected'
user.approved_by = current_user.id
user.approved_at = datetime.utcnow()
user.approval_notes = notes
# Log the rejection
log_entry = AuditLog(
user_id=current_user.id,
action="user_rejected",
details=f"Rejected user: {user.username} with role: {user.role}. Reason: {notes}",
ip_address=request.remote_addr
)
db.session.add(log_entry)
db.session.commit()
flash(f'User {user.username} has been rejected.', 'info')
return redirect(url_for('user_list'))
# Pass User query to template for looking up the creator
return render_template('admin/approve_user.html', user=user, user_query=User.query)
@app.route('/admin/delete-user/<int:user_id>', methods=['POST'])
@login_required
def delete_user(user_id):
# Only allow superadmin to delete users
if not current_user.is_superadmin():
abort(403)
# Prevent deletion of own account
if current_user.id == user_id:
flash('You cannot delete your own account.', 'danger')
return redirect(url_for('user_list'))
# Get the user to delete
user = User.query.get_or_404(user_id)
try:
# Get the username for the log
username = user.username
# Delete all associated audit logs
AuditLog.query.filter_by(user_id=user_id).delete()
# Delete all associated tokens
MatrixToken.query.filter_by(created_by=user_id).delete()
# Delete all associated vetting forms
vetting_forms = VettingForm.query.filter_by(user_id=user_id).all()
for form in vetting_forms:
# Delete associated evidence files
VettingEvidence.query.filter_by(vetting_form_id=form.id).delete()
# Now delete the vetting forms
VettingForm.query.filter_by(user_id=user_id).delete()
# Finally delete the user
db.session.delete(user)
# Log the user deletion
log_entry = AuditLog(
user_id=current_user.id,
action="user_deleted",
details=f"Deleted user: {username} with role: {user.role}",
ip_address=request.remote_addr
)
db.session.add(log_entry)
db.session.commit()
flash(f'User {username} has been permanently deleted.', 'success')
except Exception as e:
db.session.rollback()
logger.error(f"Error deleting user: {str(e)}", exc_info=True)
flash(f'Error deleting user: {str(e)}', 'danger')
return redirect(url_for('user_list'))
@app.route('/admin/audit-log/<int:user_id>')
@login_required
def audit_log(user_id):
if not (current_user.is_superadmin() or current_user.is_server_admin()):
abort(403)
user = User.query.get_or_404(user_id)
logs = AuditLog.query.filter_by(user_id=user_id).order_by(AuditLog.timestamp.desc()).all()
return render_template('admin/audit_log.html', user=user, logs=logs)
@app.route('/admin/vetting-forms')
@login_required
def admin_vetting_forms():
if not (current_user.is_superadmin() or current_user.is_server_admin()):
abort(403)
# Get submitted vetting forms that are pending review
pending_forms = VettingForm.query.filter_by(status='submitted').order_by(VettingForm.updated_at.desc()).all()
# Get forms that are approved and awaiting token generation
# Only inviting_admin, server_admin, and superadmin can see this
awaiting_token_forms = []
if current_user.is_inviting_admin():
awaiting_token_forms = VettingForm.query.filter_by(status='awaiting_token').order_by(VettingForm.approved_at.desc()).all()
# Get recently approved/rejected forms
processed_forms = VettingForm.query.filter(
VettingForm.status.in_(['approved', 'rejected']),
VettingForm.approved_by.isnot(None)
).order_by(VettingForm.approved_at.desc()).limit(10).all()
return render_template('admin/vetting_forms.html',
pending_forms=pending_forms,
awaiting_token_forms=awaiting_token_forms,
processed_forms=processed_forms)
@app.route('/admin/vetting-form/<int:form_id>', methods=['GET', 'POST'])
@login_required
def admin_review_vetting_form(form_id):
if not (current_user.is_superadmin() or current_user.is_server_admin()):
abort(403)
# Get the vetting form record
vetting_form_record = VettingForm.query.get_or_404(form_id)
# Check if the form is already processed
if vetting_form_record.status in ['approved', 'rejected']:
flash('This vetting form has already been processed.', 'info')
# Get the agent who submitted the form
submitter = User.query.get(vetting_form_record.user_id)
# Get evidence files for this form
evidence_files = VettingEvidence.query.filter_by(vetting_form_id=form_id).all()
# Attach evidence files to form record for template access
vetting_form_record.evidence_files = evidence_files
if request.method == 'POST':
action = request.form.get('action')
if action in ['approve', 'reject']:
# Set status to 'awaiting_token' if approved, otherwise 'rejected'
vetting_form_record.status = 'awaiting_token' if action == 'approve' else 'rejected'
vetting_form_record.approved_by = current_user.id
vetting_form_record.approved_at = datetime.utcnow()
# Log the approval/rejection
status_text = 'approved (awaiting token)' if action == 'approve' else 'rejected'
log_details = f"Vetting form for {vetting_form_record.full_name} was {status_text}"
if evidence_files:
log_details += f" with {len(evidence_files)} evidence file(s)"
log_entry = AuditLog(
user_id=current_user.id,
action=f"vetting_form_{action}d",
details=log_details,
ip_address=request.remote_addr
)
db.session.add(log_entry)
db.session.commit()
if action == 'approve':
flash(f'Vetting form has been approved. The applicant is now in the queue awaiting token generation.', 'success')
else:
flash(f'Vetting form has been rejected.', 'success')
return redirect(url_for('admin_vetting_forms'))
return render_template('admin/review_vetting_form.html',
form=vetting_form_record,
submitter=submitter)
# Agent Routes
@app.route('/agent/dashboard')
@login_required
def agent_dashboard():
if current_user.needs_password_change:
flash('Please change your temporary password before continuing.', 'warning')
return redirect(url_for('change_password'))
# Get tokens generated by this user
tokens = MatrixToken.query.filter_by(created_by=current_user.id).order_by(MatrixToken.created_at.desc()).limit(10).all()
# Get vetting forms submitted by this user
vetting_forms = VettingForm.query.filter_by(user_id=current_user.id).order_by(VettingForm.updated_at.desc()).limit(10).all()
return render_template('agent/dashboard.html',
tokens=tokens,
vetting_forms=vetting_forms)
@app.route('/admin/generate-token-for-form/<int:form_id>', methods=['GET', 'POST'])
@login_required
@limiter.limit("20 per day; 5 per hour")
def generate_token_for_form(form_id):
# Only allow inviting_admin, server_admin and superadmin
if not current_user.is_inviting_admin():
flash('You do not have permission to generate tokens.', 'danger')
return redirect(url_for('index'))
if current_user.needs_password_change:
flash('Please change your temporary password before continuing.', 'warning')
return redirect(url_for('change_password'))
# Get the vetting form
vetting_form = VettingForm.query.get_or_404(form_id)
# Verify the form is awaiting token
if vetting_form.status != 'awaiting_token':
flash('This form is not approved for token generation.', 'warning')
return redirect(url_for('admin_vetting_forms'))
form = MatrixRegistrationForm()
# Pre-fill the form with data from the vetting form
form.full_name.data = vetting_form.full_name
form.email.data = vetting_form.email
if form.validate_on_submit():
# Request Matrix API to generate a token
from utils import matrix_api_post, send_token_notification
# Call the API first to get a token
result = matrix_api_post(
user_fullname=form.full_name.data,
user_email=form.email.data,
assigned_username=form.assigned_username.data
)
if result["success"]:
# Extract the token and other data from the API response
response_data = result["response"]
token = response_data.get("token", "")