Administrator Access Requirement: Provide notification in writing if someone is assigned to an administrator role so that the individual is aware of the privileged level of access required as an administrator. Guidance: An administrator is a person who is responsible and has full access for the upkeep, and reliable operation of computer operating systems, databases, networks, and/or applications; the administrator may be involved with account creations, installations, and upgrades. Send a formal communication to the individual who gets assigned with administrator privileges in an environment where client data is exposed. Make sure the person is aware of his or her privileges in the environment. Supporting Evidence: copy of the communication or the mail template. Additional information can be found on CDP website Administrator Access
**CDP Control ID:** `35948468`
**Category:** Administrator Access
**Frequency:** Annually
**Owner:** h.noerenberg
**Parent:** #1
## Requirement & Guidance
Administrator Access Requirement: Provide notification in writing if someone is assigned to an administrator role so that the individual is aware of the privileged level of access required as an administrator. Guidance: An administrator is a person who is responsible and has full access for the upkeep, and reliable operation of computer operating systems, databases, networks, and/or applications; the administrator may be involved with account creations, installations, and upgrades. Send a formal communication to the individual who gets assigned with administrator privileges in an environment where client data is exposed. Make sure the person is aware of his or her privileges in the environment. Supporting Evidence: copy of the communication or the mail template. Additional information can be found on CDP website Administrator Access
Keine automatisierte E-Mail-Benachrichtigung bei Rollen-Zuweisung — aktuell nur UI-Toast.
Offene Aufgaben
Notification-Flow ergänzen: Bei Zuweisung/Änderung zu admin → E-Mail an den User mit CDP-Hinweistext.
Alternativ: einmaligen schriftlichen Prozess dokumentieren (z. B. Admin-Onboarding in docs/developer-runbook.md).
Template-Text für Notification abstimmen (Security-/Compliance-Referenz).
Ticket bleibt offen bis alle Aufgaben abgehakt sind.
## CapaKraken Compliance-Status
**EAPPS-Mapping:** `Access Control Standard (Prozess)`
**Status:** 🟡 **PARTIAL / TODO** — konkrete Schritte unten
### Zusammenfassung
Prozess-Kontrolle: Admins müssen schriftlich über ihre privilegierte Rolle informiert werden.
### Aktuelle Evidenz
- Admin-Rolle wird technisch via `UserCreateModal` zugewiesen — [`apps/web/src/components/admin/UserCreateModal.tsx`](../blob/main/apps/web/src/components/admin/UserCreateModal.tsx)
- Keine automatisierte E-Mail-Benachrichtigung bei Rollen-Zuweisung — aktuell nur UI-Toast.
### Offene Aufgaben
- [ ] Notification-Flow ergänzen: Bei Zuweisung/Änderung zu `admin` → E-Mail an den User mit CDP-Hinweistext.
- [ ] Alternativ: einmaligen schriftlichen Prozess dokumentieren (z. B. Admin-Onboarding in `docs/developer-runbook.md`).
- [ ] Template-Text für Notification abstimmen (Security-/Compliance-Referenz).
---
*Ticket bleibt offen bis alle Aufgaben abgehakt sind.*
Admin-Vergabe erfolgt aktuell nur viascripts/setup-admin.mjs (CLI) oder Rollen-UI — ohne automatische Notification.
TODOs
Email-Templateadmin-role-assignment-notification.html unter packages/api/src/lib/email-templates/ anlegen. Inhalt:
Empfänger wird Administrator von CapaKraken
Bedeutet privilegierten Zugriff auf Client-Daten
Zugehörige CDP-Pflichten (Secure-Coding, Audit-Log, kein Credential-Sharing)
Link auf internes Policy-Doc
Hook in RBAC-Service: wenn role === "ADMIN" gesetzt wird (über UI oder setup-admin.mjs), triggere sendEmail({ to: user.email, template: "admin-role-assignment-notification" }).
Audit-Eintrag ergänzen: action: "ADMIN_ROLE_ASSIGNED", entityType: "User" — nötig als Supporting-Evidence für CDP-Attestierung.
PDF-Export der gesendeten Notification in docs/evidence/admin-notifications/ ablegen (für CDP-Audit).
Frequency
Annual — bei jedem Admin-Wechsel + jährliche Re-Attestierung der aktiven Admin-Liste.
Blocker: Keine. Kann direkt implementiert werden.
## Action Plan
**CDP-Requirement:** Admin-Rollenzuweisung muss formell schriftlich kommuniziert werden.
### Status
- **Infrastruktur vorhanden:** `packages/api/src/lib/email.ts` (nodemailer) — Mail-Versand etabliert (Reset-Password, Weekly-Digest).
- **Admin-Vergabe erfolgt aktuell nur via** `scripts/setup-admin.mjs` (CLI) oder Rollen-UI — **ohne automatische Notification**.
### TODOs
1. **Email-Template** `admin-role-assignment-notification.html` unter `packages/api/src/lib/email-templates/` anlegen. Inhalt:
- Empfänger wird Administrator von CapaKraken
- Bedeutet privilegierten Zugriff auf Client-Daten
- Zugehörige CDP-Pflichten (Secure-Coding, Audit-Log, kein Credential-Sharing)
- Link auf internes Policy-Doc
2. **Hook** in RBAC-Service: wenn `role === "ADMIN"` gesetzt wird (über UI oder `setup-admin.mjs`), triggere `sendEmail({ to: user.email, template: "admin-role-assignment-notification" })`.
3. **Audit-Eintrag** ergänzen: `action: "ADMIN_ROLE_ASSIGNED"`, `entityType: "User"` — nötig als Supporting-Evidence für CDP-Attestierung.
4. **PDF-Export** der gesendeten Notification in `docs/evidence/admin-notifications/` ablegen (für CDP-Audit).
### Frequency
Annual — bei jedem Admin-Wechsel + jährliche Re-Attestierung der aktiven Admin-Liste.
**Blocker:** Keine. Kann direkt implementiert werden.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
CDP Control ID:
35948468Category: Administrator Access
Frequency: Annually
Owner: h.noerenberg
Parent: #1
Requirement & Guidance
Administrator Access Requirement: Provide notification in writing if someone is assigned to an administrator role so that the individual is aware of the privileged level of access required as an administrator. Guidance: An administrator is a person who is responsible and has full access for the upkeep, and reliable operation of computer operating systems, databases, networks, and/or applications; the administrator may be involved with account creations, installations, and upgrades. Send a formal communication to the individual who gets assigned with administrator privileges in an environment where client data is exposed. Make sure the person is aware of his or her privileges in the environment. Supporting Evidence: copy of the communication or the mail template. Additional information can be found on CDP website Administrator Access
CapaKraken Action Plan — 35948468 Administrator-Benachrichtigung
Scope: Wer eine Admin-Rolle erhält, muss schriftlich über die Privilegien informiert werden.
Aktueller Stand:
adminProcedure)UserRole-Eintrag in DBTodos:
/admin/usersRollenänderung → automatische E-Mail an Betroffenen mit Notification-Text + Ack-CheckboxADMIN-User senden und Ack inUserAckLogoder neuem Feld persistierenDateien:
packages/api/src/router/users.ts— Rollenvergabeapps/web/src/app/(app)/admin/users/— UICapaKraken Compliance-Status
EAPPS-Mapping:
Access Control Standard (Prozess)Status: 🟡 PARTIAL / TODO — konkrete Schritte unten
Zusammenfassung
Prozess-Kontrolle: Admins müssen schriftlich über ihre privilegierte Rolle informiert werden.
Aktuelle Evidenz
UserCreateModalzugewiesen —apps/web/src/components/admin/UserCreateModal.tsxOffene Aufgaben
admin→ E-Mail an den User mit CDP-Hinweistext.docs/developer-runbook.md).Ticket bleibt offen bis alle Aufgaben abgehakt sind.
Action Plan
CDP-Requirement: Admin-Rollenzuweisung muss formell schriftlich kommuniziert werden.
Status
packages/api/src/lib/email.ts(nodemailer) — Mail-Versand etabliert (Reset-Password, Weekly-Digest).scripts/setup-admin.mjs(CLI) oder Rollen-UI — ohne automatische Notification.TODOs
admin-role-assignment-notification.htmlunterpackages/api/src/lib/email-templates/anlegen. Inhalt:role === "ADMIN"gesetzt wird (über UI odersetup-admin.mjs), triggeresendEmail({ to: user.email, template: "admin-role-assignment-notification" }).action: "ADMIN_ROLE_ASSIGNED",entityType: "User"— nötig als Supporting-Evidence für CDP-Attestierung.docs/evidence/admin-notifications/ablegen (für CDP-Audit).Frequency
Annual — bei jedem Admin-Wechsel + jährliche Re-Attestierung der aktiven Admin-Liste.
Blocker: Keine. Kann direkt implementiert werden.