Zum Inhalt springen

2FA-Pflicht

Mit der 2FA-Pflicht können Administratoren festlegen, dass alle Mitglieder 2FA für ihre Konten aktiviert haben müssen, bevor sie auf Organisationsressourcen zugreifen können. Das erhöht die Sicherheit für deine Apps und Daten.

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

  • Alle Mitglieder müssen 2FA für ihr Capgo-Konto aktiviert haben
  • Mitglieder ohne 2FA erhalten keinen Zugriff auf die Apps der Organisation
  • Sowohl das Web-Dashboard als auch CLI erzwingen diese Anforderung
  • Neue Mitglieder müssen 2FA aktivieren, bevor sie auf Organisationsressourcen zugreifen können

Wenn du auf eine Organisation zugreifen willst, die 2FA erfordert, und du 2FA nicht aktiviert hast:

  1. Du erhältst eine Meldung „Zugriff verweigert“
  2. Du wirst aufgefordert, 2FA in deinen Kontoeinstellungen zu aktivieren
  3. Sobald es aktiviert ist, können Sie die Organisation ganz normal nutzen

Wenn du Capgo CLI nutzt, um mit Apps in einer Organisation zu interagieren, die 2FA erfordert:

🔐 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
  1. Navigiere zu deinen Organisationseinstellungen
  2. Besuchen Sie die Sicherheit Abschnitt
  3. Umschalten 2FA für alle Mitglieder erzwingen
  4. Aktion bestätigen

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

Terminalfenster
# 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

Bei der Aktivierung über CLI wird Folgendes angezeigt:

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

Sie können alle Organisationsmitglieder und deren 2FA-Status auflisten:

Terminalfenster
npx @capgo/cli organization members YOUR_ORG_ID

Dabei wird Folgendes angezeigt:

  • E-Mail-Adresse und Rolle des Mitglieds
  • Whether they have 2FA enabled
  • Eine Zusammenfassung, wie viele Mitglieder 2FA aktivieren müssen

In deinen Organisationseinstellungen siehst du, ob 2FA für jedes Mitglied aktiviert ist.

Wenn du 2FA für dein Konto aktivieren musst, siehe unsere Einrichtungsanleitung für Zwei-Faktor-Authentifizierung.

  • Vorab kommunizieren: Gib den Mitgliedern mindestens eine Woche Vorlauf, bevor du die Erzwingung aktivierst
  • Support anbieten: Teile die 2FA-Setup-Anleitung mit deinem Team
  • Bereitschaft prüfen: Nutze npx @capgo/cli organization members um zu sehen, wer noch 2FA aktivieren muss
  • Zugriffsprobleme überwachen: Stehe bereit, um Mitgliedern zu helfen, die ausgesperrt werden
  • Backup-Codes aufbewahren: Mitglieder daran erinnern, ihre 2FA-Backup-Codes zu speichern
  • Regelmäßig überprüfen: Regelmäßig prüfen, ob alle Mitglieder 2FA aktiviert haben
  • 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

„Zugriff verweigert: Zwei-Faktor-Authentifizierung erforderlich“

Abschnitt mit dem Titel „Zugriff verweigert: Zwei-Faktor-Authentifizierung erforderlich“

Problem: Du bekommst diesen Fehler, wenn du versuchst, auf eine Organisation zuzugreifen.

Lösung:

  1. Gehe zu Kontoeinstellungen
  2. Aktiviere 2FA für dein Konto
  3. Versuche erneut, auf die Organisation zuzugreifen

„2FA-Erzwingung kann nicht aktiviert werden“

Abschnitt mit dem Titel „2FA-Pflicht kann nicht aktiviert werden“

Problem: Du kannst die 2FA-Pflicht für deine 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

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
  • Neu authentifizieren, wenn loginbasierte Auth verwendet wird: npx @capgo/cli login

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

StandardVoraussetzungWie 2FA hilft
SOC 2ZugriffskontrollenStellt eine starke Authentifizierung für alle Benutzer sicher
ISO 27001InformationssicherheitFügt eine Ebene der Identitätsprüfung hinzu
HIPAAZugriffsmanagementSchützt vor unbefugtem Zugriff
DSGVODatenschutzReduziert das Risiko von Account-Übernahmen
PCI DSSAuthentifizierungskontrollenErfüllt die Anforderungen an Multi-Faktor-Authentifizierung

Wenn du es nutzt 2FA-Pflicht um Sicherheit und Compliance zu planen, verbinden Sie es mit Verschlüsselung für die Implementierungsdetails in Encryption, Konformität 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.