user_login ); $issuer = rawurlencode( get_bloginfo( 'name' ) ); return "otpauth://totp/{$label}?secret={$secret}&issuer={$issuer}&algorithm=SHA1&digits=6&period=30"; } /* ---------------------------------------------------------------- */ /* Ein-/Ausschalten */ /* ---------------------------------------------------------------- */ public static function is_enabled( $user_id ) { return (bool) get_user_meta( $user_id, self::ENABLED_META, true ); } public static function pending_secret( $user_id ) { return get_user_meta( $user_id, self::SECRET_META, true ); } public static function start_enrollment( $user_id ) { $secret = self::generate_secret(); update_user_meta( $user_id, self::SECRET_META, $secret ); return $secret; } /** * Gibt bei Erfolg die frisch erzeugten Backup-Codes im Klartext zurueck * (einmalig anzuzeigen -- werden danach nur noch gehasht gespeichert), * bei falschem Code false. */ public static function confirm_enrollment( $user_id, $code ) { $secret = self::pending_secret( $user_id ); if ( ! $secret || ! self::consume_login_code( $user_id, $secret, $code ) ) { return false; } update_user_meta( $user_id, self::ENABLED_META, true ); return self::generate_backup_codes( $user_id ); } public static function disable( $user_id ) { delete_user_meta( $user_id, self::ENABLED_META ); delete_user_meta( $user_id, self::SECRET_META ); delete_user_meta( $user_id, self::BACKUP_CODES_META ); delete_user_meta( $user_id, self::LAST_TIMESLICE_META ); delete_user_meta( $user_id, self::FAILURES_META ); // Vertraute Browser (Pro) verlieren mit der Zwei-Faktor-Anmeldung ihren Sinn. delete_user_meta( $user_id, 'wp360_lg_2fa_trust' ); } /** @return array{count: int, since: int} */ private static function user_failures( $user_id ) { $failures = get_user_meta( $user_id, self::FAILURES_META, true ); if ( ! is_array( $failures ) || (int) $failures['since'] + self::USER_FAILURE_WINDOW < time() ) { return array( 'count' => 0, 'since' => time(), ); } return array( 'count' => (int) $failures['count'], 'since' => (int) $failures['since'], ); } private static function record_user_failure( $user_id ) { $failures = self::user_failures( $user_id ); ++$failures['count']; update_user_meta( $user_id, self::FAILURES_META, $failures ); } /** @return WP_Error|null */ private static function user_lock_error( $user_id ) { if ( self::user_failures( $user_id )['count'] < self::MAX_USER_FAILURES ) { return null; } return new WP_Error( 'wp360_lg_locked', __( 'Error: Too many failed login attempts. Please try again later.', '360-orbit-login-guard' ) ); } /* ---------------------------------------------------------------- */ /* Backup-Codes (Einmal-Codes fuer den Fall eines verlorenen Geraets) */ /* ---------------------------------------------------------------- */ /** * Erzeugt BACKUP_CODES_COUNT neue Codes, verwirft alle bisherigen * (auch unbenutzte) und gibt die Codes im Klartext zurueck -- das ist * der einzige Zeitpunkt, zu dem sie je im Klartext existieren; ab hier * ist nur noch der sha256-Hash gespeichert. */ public static function generate_backup_codes( $user_id ) { $codes = array(); $hashes = array(); for ( $i = 0; $i < self::BACKUP_CODES_COUNT; $i++ ) { $code = self::random_backup_code(); $codes[] = $code; $hashes[] = hash( 'sha256', $code ); } update_user_meta( $user_id, self::BACKUP_CODES_META, $hashes ); return $codes; } /** 10 Zeichen aus einem Alphabet ohne leicht verwechselbare Zeichen (0/O, 1/I), als XXXXX-XXXXX formatiert. */ private static function random_backup_code() { $alphabet = 'ABCDEFGHJKLMNPQRSTUVWXYZ23456789'; $raw = ''; for ( $i = 0; $i < 10; $i++ ) { $raw .= $alphabet[ random_int( 0, strlen( $alphabet ) - 1 ) ]; } return substr( $raw, 0, 5 ) . '-' . substr( $raw, 5, 5 ); } public static function backup_codes_remaining( $user_id ) { return count( (array) get_user_meta( $user_id, self::BACKUP_CODES_META, true ) ); } /** Bei Erfolg wird der Code sofort verbraucht (aus der gespeicherten Liste entfernt) -- Einmalverwendung. */ public static function verify_backup_code( $user_id, $code ) { $code = strtoupper( trim( (string) $code ) ); $hashes = (array) get_user_meta( $user_id, self::BACKUP_CODES_META, true ); $hash = hash( 'sha256', $code ); $index = array_search( $hash, $hashes, true ); if ( false === $index ) { return false; } unset( $hashes[ $index ] ); update_user_meta( $user_id, self::BACKUP_CODES_META, array_values( $hashes ) ); return true; } private static function required_for_user( $user ) { if ( self::is_enabled( $user->ID ) ) { return true; } return self::is_required_for( $user ); } /** Verlangt eine der Rollen dieser Person Zwei-Faktor (unabhaengig davon, ob sie schon eingerichtet ist)? */ public static function is_required_for( $user ) { // Die kostenlose Version kennt keine Pflicht je Rolle. return false; // phpcs:ignore Squiz.PHP.NonExecutableCode.Unreachable -- im Pro-Build nicht erreichbar, im Free-Build die einzige Zeile. } /** * Darf diese Person Zwei-Faktor fuer ihr Konto einrichten? In der * kostenlosen Version Administratoren (manage_options), mit Pro-Lizenz * jedes Konto. Abschalten und Anmelden mit eingerichteter 2FA gehen immer. */ public static function can_enroll( $user ) { if ( ! $user instanceof WP_User || ! $user->exists() ) { return false; } return user_can( $user, 'manage_options' ); } /** * Bestaetigt die Identitaet vor Abschalten oder neuen Backup-Codes: ein * aktueller Authenticator-Code oder ein Backup-Code (fuer den Fall, dass * das Geraet weg ist). Beide werden dabei verbraucht. */ public static function confirm_identity( $user_id, $code ) { $secret = self::pending_secret( $user_id ); if ( $secret && self::consume_login_code( $user_id, $secret, $code ) ) { return true; } return '' !== trim( (string) $code ) && self::verify_backup_code( $user_id, $code ); } /* ---------------------------------------------------------------- */ /* Login-Flow */ /* ---------------------------------------------------------------- */ /** * Laeuft nach der eigentlichen Passwortpruefung (Prioritaet 25, also * nach WordPress' eigenem Callback bei 20). Ist Zwei-Faktor fuer diese * Person erforderlich, wird die Anmeldung hier angehalten und ein * eigenes Code-Eingabeformular ausgegeben, statt WordPress die * Sitzung setzen zu lassen. */ public static function require_second_factor( $user ) { if ( ! $user instanceof WP_User ) { return $user; } if ( ! self::required_for_user( $user ) ) { return $user; } if ( ! self::is_enabled( $user->ID ) ) { // Rolle verlangt 2FA, ist aber noch nicht eingerichtet -- Login // zulassen, aber der Person im Backend die Einrichtung anzeigen // (siehe class-admin-page.php), statt sie komplett auszusperren. return $user; } // Die Sperrpruefung am Ende der authenticate-Kette (PHP_INT_MAX) wird // nie erreicht, weil render_form_and_exit() die Anfrage beendet. Ohne // diese Pruefung verriete das 2FA-Formular einer gesperrten IP, dass // das Passwort stimmt -- Passwoerter liessen sich trotz Sperre raten. $access_error = Wp360_Login_Guard_Guard::access_error( $user->user_login ); if ( ! $access_error ) { $access_error = self::user_lock_error( $user->ID ); } if ( $access_error ) { return $access_error; } $token = wp_generate_password( 32, false ); self::save_token( $token, array( 'user_id' => $user->ID, 'attempts' => 0, 'expires_at' => time() + self::TOKEN_LIFETIME, ) ); self::render_form_and_exit( $token ); return $user; // Nicht erreichbar -- render_form_and_exit() beendet die Anfrage. } private static function render_form_and_exit( $token, $error = '' ) { nocache_headers(); login_header( __( 'Two-Factor Authentication', '360-orbit-login-guard' ), '', $error ? new WP_Error( 'wp360_lg_2fa_invalid', $error ) : null ); ?>


(int) $data['user_id'], 'attempts' => (int) $data['attempts'], 'expires_at' => (int) $data['expires_at'], ); } /** Beendet den Zwei-Faktor-Schritt mit einer Fehlermeldung und einem Link zurueck zur Anmeldung. */ private static function render_error_and_exit( $error ) { nocache_headers(); login_header( __( 'Two-Factor Authentication', '360-orbit-login-guard' ), '', $error ); ?> user_login : '' ); if ( $access_error ) { delete_transient( self::TOKEN_PREFIX . $token ); self::render_error_and_exit( $access_error ); } $user_id = $data['user_id']; $user = get_user_by( 'id', $user_id ); if ( ! $user ) { delete_transient( self::TOKEN_PREFIX . $token ); self::render_error_and_exit( $invalid_code_error ); } $user_lock_error = self::user_lock_error( $user_id ); if ( $user_lock_error ) { delete_transient( self::TOKEN_PREFIX . $token ); self::render_error_and_exit( $user_lock_error ); } $secret = self::pending_secret( $user_id ); $valid_totp = $secret && self::consume_login_code( $user_id, $secret, $code ); $used_backup_code = false; if ( ! $valid_totp && ! empty( $code ) ) { $used_backup_code = self::verify_backup_code( $user_id, $code ); } if ( ! $valid_totp && ! $used_backup_code ) { // Falsche Codes zaehlen in dieselbe IP-Sperre wie falsche // Passwoerter; zusaetzlich verfaellt das Token nach // MAX_CODE_ATTEMPTS Versuchen, damit sich die 6-stelligen Codes // nicht innerhalb seiner Laufzeit durchprobieren lassen. Wp360_Login_Guard_Guard::register_failure( $user->user_login ); self::record_user_failure( $user_id ); ++$data['attempts']; $access_error = Wp360_Login_Guard_Guard::access_error( $user->user_login ); if ( ! $access_error ) { $access_error = self::user_lock_error( $user_id ); } if ( $access_error || $data['attempts'] >= self::MAX_CODE_ATTEMPTS ) { delete_transient( self::TOKEN_PREFIX . $token ); self::render_error_and_exit( $access_error ? $access_error : $invalid_code_error ); } self::save_token( $token, $data ); self::render_form_and_exit( $token, $invalid_code_error->get_error_message() ); return; } if ( $used_backup_code ) { self::notify_backup_code_used( $user ); } delete_transient( self::TOKEN_PREFIX . $token ); delete_user_meta( $user_id, self::FAILURES_META ); $redirect_to = isset( $_REQUEST['redirect_to'] ) ? esc_url_raw( wp_unslash( $_REQUEST['redirect_to'] ) ) : admin_url(); wp_set_current_user( $user_id ); wp_set_auth_cookie( $user_id ); do_action( 'wp_login', $user->user_login, $user ); wp_safe_redirect( $redirect_to ); exit; } /** * Kurzer Name eines Geraets aus der Browserkennung, z. B. "Chrome auf Windows". * * @param string $user_agent Browserkennung. */ public static function device_label( $user_agent ) { list( $browser, $system ) = self::device_parts( $user_agent ); if ( '' === $browser && '' === $system ) { return __( 'Unknown device', '360-orbit-login-guard' ); } if ( '' === $browser || '' === $system ) { return $browser . $system; } /* translators: 1: browser name, 2: operating system */ return sprintf( __( '%1$s on %2$s', '360-orbit-login-guard' ), $browser, $system ); } /** * Browser und System aus der Browserkennung, je '' wenn unbekannt. * * @param string $user_agent Browserkennung. * @return array{0:string,1:string} */ public static function device_parts( $user_agent ) { $ua = (string) $user_agent; $browsers = array( 'Edg/' => 'Edge', 'OPR/' => 'Opera', 'Firefox/' => 'Firefox', 'Chrome/' => 'Chrome', 'Safari/' => 'Safari', ); $systems = array( 'iPhone' => 'iPhone', 'iPad' => 'iPad', 'Android' => 'Android', 'Windows' => 'Windows', 'Macintosh' => 'Mac', 'Linux' => 'Linux', ); $browser = ''; $system = ''; foreach ( $browsers as $needle => $name ) { if ( false !== strpos( $ua, $needle ) ) { $browser = $name; break; } } foreach ( $systems as $needle => $name ) { if ( false !== strpos( $ua, $needle ) ) { $system = $name; break; } } return array( $browser, $system ); } /* ---------------------------------------------------------------- */ /* Geraete-Benachrichtigung (PRO) */ /* ---------------------------------------------------------------- */ /** * Ein Backup-Code wird nur verwendet, wenn das normale Geraet nicht * verfuegbar war -- das ist ein Signal wert, damit ein Kontoinhaber * merkt, falls er es nicht selbst war, und rechtzeitig neue Codes * generiert, bevor sie ausgehen. */ private static function notify_backup_code_used( $user ) { $remaining = self::backup_codes_remaining( $user->ID ); wp_mail( $user->user_email, sprintf( /* translators: %s: site name */ __( '[%s] A backup code was used to sign in', '360-orbit-login-guard' ), get_bloginfo( 'name' ) ), sprintf( /* translators: 1: number of remaining backup codes, 2: account settings URL */ __( "A backup code was used to sign in to your account instead of your usual authenticator app.\n\nIf this was you, no action is needed. If not, please change your password immediately.\n\n%1\$d backup code(s) remaining. Generate new ones from the \"Two-Factor\" tab once you're running low.\n\n%2\$s", '360-orbit-login-guard' ), $remaining, home_url( '/' ) ) ); } }