Notion Integration
Compliance-Dokumentation als strukturierte Notion-Pages in einer Database. Ideal für Scale-Ups + KMU die Notion als zentrales Wissens-Tool nutzen.
Schnell-Fakten
- Kategorie
- Dokumentation
- Authentifizierung
- API-Token
- Plan
- Ab Team
- Datenfluss
- Push (nur ausgehend)
Setup-Anleitung
- 1
Notion-Account öffnen
Gehe in deinem Notion-Account zu den API-Einstellungen oder Personal Access Tokens.
- 2
API-Token erstellen
Erstelle einen neuen API-Token mit den benötigten Permissions (siehe Credentials-Section unten).
- 3
Token kopieren
Kopiere den Token sofort — die meisten Services zeigen ihn nur einmal an.
- 4
In ai-risk-check verbinden
Öffne Einstellungen → Integrationen → Notion, füge die Credentials ein und klicke "Verbindung testen". Bei Erfolg: Aktivieren.
Benötigte Credentials
Aus notion.so/profile/integrations → New integration → Copy "Internal Integration Secret" (beginnt mit "secret_" oder "ntn_").
Alle Credentials werden mit AES-256-GCM verschlüsselt at-rest gespeichert.
Konfiguration
Aus der Database-URL: notion.so/<workspace>/<DATABASE_ID>?v=... — der lange Hex-String vor "?v=".
12a34b5c6d7e8f9012345678abcdef01Unterstützte Events
Diese Compliance-Events werden automatisch an Notion weitergeleitet:
- High-Risk-System erkannt
- FRIA erforderlich (Art. 27)
- Verbotene Praktik erkannt (Art. 5)
- Substantielle Änderung (Art. 25)
Troubleshooting
Verbindungstest schlägt fehl
Prüfe ob: (1) Credentials korrekt eingetragen sind, (2) der API-Token/Webhook noch gültig ist, (3) bei OAuth2 die nötigen Scopes vergeben wurden, (4) Admin-Consent erteilt wurde (bei Microsoft/Google).
Events werden nicht ausgelöst
Stelle sicher, dass die Integration auf "Aktiv" steht (nicht pausiert). Prüfe die Event-Historie unter Einstellungen → Integrationen → Notion → Verlauf.
Wie sicher sind meine Credentials?
Alle Credentials werden mit AES-256-GCM verschlüsselt at-rest in Supabase (Frankfurt) gespeichert. Der Encryption-Key ist ENV-gesteuert und nicht in der Datenbank. Credentials sind nie im Klartext in Logs.
Bereit für Notion?
Setup in unter 5 Minuten. Du brauchst nur die Credentials oben.