2FA-Pflicht

Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.

Durch die Erzwingung der Zwei-Faktor-Authentifizierung (2FA) können Administratoren festlegen, dass alle Mitglieder 2FA für ihre Konten aktivieren müssen, bevor sie auf Organisationsressourcen zugreifen können. Dies erhöht die Sicherheit deiner Apps und Daten.

Übersicht

Wenn die 2FA-Erzwingung für eine Organisation aktiviert ist:

Müssen alle Mitglieder 2FA für ihr Capgo Konto aktiviert haben
Wird Mitgliedern ohne 2FA der Zugriff auf die Apps der Organisation verweigert
Wird diese Anforderung sowohl im Web-Dashboard als auch über CLI durchgesetzt
Neue Mitglieder müssen 2FA aktivieren, um auf Organisationsressourcen zuzugreifen

So funktioniert es

Web-Dashboard

Wenn du versuchst, auf eine Organisation zuzugreifen, die 2FA erfordert, du diese aber nicht aktiviert hast:

Du erhältst eine Fehlermeldung „Access Denied“
Wirst du aufgefordert, 2FA in deinen Kontoeinstellungen zu aktivieren
Sobald es aktiviert ist, können Sie die Organisation ganz normal nutzen

CLI Zugriff

Wenn du das Capgo CLI nutzt, um mit Apps in einer 2FA-pflichtigen Organisation zu interagieren:

🔐 Access Denied: Two-Factor Authentication Required
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

This organization requires all members to have 2FA enabled.

To regain access:
  1. Go to https://web.capgo.app/settings/account
  2. Enable Two-Factor Authentication on your account
  3. Try your command again

2FA-Erzwingung aktivieren

Über das Web Dashboard

Navigieren Sie zu Ihren Organisationseinstellungen
Gehen Sie zu Sicherheit Abschnitt
Umschalten 2FA für alle Mitglieder anfordern
Aktion bestätigen

Über CLI

Du kannst die 2FA-Pflicht mit Capgo CLI aktivieren:

# Enable 2FA enforcement for an organization
npx @capgo/cli organization set YOUR_ORG_ID --enforce-2fa

# Disable 2FA enforcement
npx @capgo/cli organization set YOUR_ORG_ID --no-enforce-2fa

When enabling via CLI, you’ll be shown:

Welche Mitglieder 2FA nicht aktiviert haben
Eine Warnung, falls du selbst 2FA nicht aktiviert hast
Ein Bestätigungs-Prompt vor der Änderung

2FA-Status der Mitglieder prüfen

Über CLI

Du kannst alle Organisationsmitglieder und deren 2FA-Status auflisten:

npx @capgo/cli organization members YOUR_ORG_ID

Dies zeigt Folgendes an:

E-Mail und Rolle des Mitglieds
ob sie 2FA aktiviert haben
Zusammenfassung der Mitglieder, die 2FA aktivieren müssen

Über das Web Dashboard

In deinen Organisationseinstellungen siehst du, ob jedes Mitglied 2FA aktiviert hat.

2FA für Ihren Account einrichten

Falls Sie 2FA für Ihren Account aktivieren müssen, lesen Sie unseren Two-Factor Authentication setup guide.

Best Practices

Bevor Sie die Erzwingung aktivieren

Vorab kommunizieren: Informieren Sie die Mitglieder mindestens eine Woche vor der Aktivierung
Support anbieten: Teilen Sie den 2FA-Einrichtungsleitfaden mit deinem Team
Bereitschaft prüfen: Nutze npx @capgo/cli organization members um zu sehen, wer 2FA noch aktivieren muss

Nach der Aktivierung der Erzwingung

Zugriffsprobleme überwachen: Stehe Mitgliedern, die ausgesperrt wurden, unterstützend zur Seite
Backup-Codes aufbewahren: Erinnere Mitglieder daran, ihre 2FA-Backup-Codes zu speichern
Regelmäßig überprüfen: Regelmäßig prüfen, ob alle Mitglieder 2FA aktiviert haben

Für CI/CD Pipelines

Nutze API Keys: CI/CD-Systeme sollten API Keys statt Benutzerkonten verwenden
API Key-Besitzer: Sicherstellen, dass der Nutzer, der die CI/CD API Keys erstellt hat, 2FA aktiviert hat
Keys rotieren: In automatisierten Systemen genutzte API Keys regelmäßig rotieren

Fehlerbehebung

„Zugriff verweigert: Zwei-Faktor-Authentifizierung erforderlich“

Problem: Dieser Fehler tritt auf, wenn Sie versuchen, auf eine Organisation zuzugreifen.

Lösung:

Gehe zu Kontoeinstellungen
Aktivieren Sie 2FA für Ihr Konto
Versuchen Sie erneut, auf die Organisation zuzugreifen

„2FA-Erzwingung kann nicht aktiviert werden“

Problem: Sie können die 2FA-Erzwingung für Ihre Organisation nicht aktivieren.

Lösung:

Stelle sicher, dass du super_admin Berechtigungen in der Organisation hast
Aktiviere zuerst 2FA für deinen eigenen Account
Contact support if the issue persists

CLI Befehle schlagen fehl

Problem: CLI Befehle schlagen mit 2FA-bezogenen Fehlern fehl.

Lösung:

Überprüfe, ob dein API Key gültig ist: npx @capgo/cli doctor
Ensure the API key owner has 2FA enabled
Erneut authentifizieren, wenn login-basierte Auth genutzt wird: npx @capgo/cli login

Compliance

Die 2FA-Erzwingung hilft Ihrer Organisation, verschiedene Compliance-Anforderungen zu erfüllen:

Standard	Voraussetzung	Wie 2FA hilft
SOC 2	Zugriffskontrollen	Gewährleistet eine starke Authentifizierung für alle Nutzer
ISO 27001	Informationssicherheit	Fügt eine Ebene der Identitätsprüfung hinzu
HIPAA	Zugriffsmanagement	Schützt vor unbefugtem Zugriff
DSGVO	Datenschutz	Verringert das Risiko von Account-Übernahmen
PCI DSS	Authentifizierungs-Kontrollen	Erfüllt Multi-Faktor-Authentifizierungs-Anforderungen

Nächste Schritte

Weiter nach der 2FA-Erzwingung

Wenn du es nutzt 2FA-Pflicht um Sicherheit und Compliance zu planen, verbinden Sie es mit Verschlüsselung für die Implementierungsdetails in Encryption, Compliance für das Implementierungsdetail in Compliance, Capgo Security Scanner für den Produkt-Workflow im Capgo Security Scanner, Capgo Sicherheit für den Produkt-Workflow in Capgo Security und Capgo Trust Center für den Produkt-Workflow im Capgo Trust Center.