prefix . WP360_LG_TABLE; } /** Aktivierungs-Hook: Verlaufstabelle anlegen + Salt erzeugen. */ public static function install() { global $wpdb; $table = self::table_name(); $charset_collate = $wpdb->get_charset_collate(); $sql = "CREATE TABLE {$table} ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT, ip_hash CHAR(64) NOT NULL, username VARCHAR(60) NOT NULL DEFAULT '', success TINYINT(1) UNSIGNED NOT NULL DEFAULT 0, created_at DATETIME NOT NULL, PRIMARY KEY (id), KEY ip_hash (ip_hash), KEY created_at (created_at), KEY username (username) ) {$charset_collate};"; require_once ABSPATH . 'wp-admin/includes/upgrade.php'; dbDelta( $sql ); self::salt(); self::schedule_cleanup(); } public static function uninstall_cron() { wp_clear_scheduled_hook( self::CLEANUP_HOOK ); } public static function schedule_cleanup() { if ( ! wp_next_scheduled( self::CLEANUP_HOOK ) ) { wp_schedule_event( time() + HOUR_IN_SECONDS, 'daily', self::CLEANUP_HOOK ); } } /** Loescht Verlaufseintraege, die aelter als die feste Aufbewahrungsfrist (7 Tage) sind. */ public static function run_cleanup() { global $wpdb; $table = self::table_name(); $cutoff = gmdate( 'Y-m-d H:i:s', time() - self::RETENTION_DAYS * DAY_IN_SECONDS ); return (int) $wpdb->query($wpdb->prepare("DELETE FROM {$table} WHERE created_at < %s", $cutoff)); // phpcs:ignore } /** Persistentes geheimes Salt fuer den IP-Hash. */ public static function salt() { $salt = get_option( self::SALT_OPTION ); if ( ! is_string( $salt ) || $salt === '' ) { $salt = wp_generate_password( 64, true, true ); add_option( self::SALT_OPTION, $salt, '', 'no' ); } return $salt; } /** * Pseudonymer Hash einer IP-Adresse -- wird nirgends zurueckgerechnet, nur * fuer Vergleiche verwendet. IPv6-Adressen zaehlen als ganzes /64-Netz: * Ein einzelner Anschluss bekommt ueblicherweise ein /64 zugeteilt, also * 2^64 Adressen -- je Adresse gezaehlt, liesse sich die Sperre mit jeder * Anfrage durch eine neue Adresse umgehen. */ public static function hash_ip( $ip ) { return hash( 'sha256', self::network_key( $ip ) . self::salt() ); } private static function network_key( $ip ) { if ( ! filter_var( $ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6 ) ) { return (string) $ip; } $packed = inet_pton( $ip ); if ( false === $packed ) { return (string) $ip; } return inet_ntop( substr( $packed, 0, 8 ) . str_repeat( "\0", 8 ) ) . '/64'; } /** * Name, wie er im Verlauf steht: Konten, die es gibt, im Klartext. Alles * andere nur als kurze Kennung -- in das Anmeldefeld tippen Leute oft * versehentlich ihr Passwort, und das soll nicht sieben Tage lang lesbar * in der Datenbank und in wp-admin stehen. Marken wie "(application * password)" bleiben unveraendert. */ private static function loggable_username( $username ) { $username = (string) $username; if ( '' === $username || '(' === $username[0] || false !== get_user_by( 'login', $username ) ) { return $username; } return '(unknown ' . substr( hash( 'sha256', strtolower( $username ) . self::salt() ), 0, 8 ) . ')'; } public static function record( $ip_hash, $username, $success ) { global $wpdb; $wpdb->insert( // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching -- plugineigene Tabelle, Abfragen sind vorbereitet; ein Login-Protokoll darf nicht gecacht werden. self::table_name(), array( 'ip_hash' => $ip_hash, 'username' => mb_substr( self::loggable_username( $username ), 0, 60 ), 'success' => $success ? 1 : 0, 'created_at' => current_time( 'mysql', true ), ), array( '%s', '%s', '%d', '%s' ) ); } /** Anzahl fehlgeschlagener Versuche fuer einen IP-Hash innerhalb der letzten $minutes Minuten. */ public static function failed_count_since( $ip_hash, $minutes ) { global $wpdb; $since = gmdate( 'Y-m-d H:i:s', time() - $minutes * MINUTE_IN_SECONDS ); return (int) $wpdb->get_var($wpdb->prepare( // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching -- plugineigene Tabelle, Abfragen sind vorbereitet; ein Login-Protokoll darf nicht gecacht werden. "SELECT COUNT(*) FROM " . self::table_name() . " WHERE ip_hash = %s AND success = 0 AND created_at >= %s", // phpcs:ignore $ip_hash, $since )); } /** Anzahl fehlgeschlagener Versuche fuer einen Benutzernamen, ueber alle IPs, innerhalb der letzten $minutes Minuten. */ public static function failed_count_for_username_since( $username, $minutes ) { global $wpdb; $since = gmdate( 'Y-m-d H:i:s', time() - $minutes * MINUTE_IN_SECONDS ); return (int) $wpdb->get_var($wpdb->prepare( // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching -- plugineigene Tabelle, Abfragen sind vorbereitet; ein Login-Protokoll darf nicht gecacht werden. "SELECT COUNT(*) FROM " . self::table_name() . " WHERE username = %s AND success = 0 AND created_at >= %s", // phpcs:ignore mb_substr( (string) $username, 0, 60 ), $since )); } /** * true, wenn sich genau dieser Benutzername von diesem IP-Hash aus * innerhalb der Aufbewahrungsfrist erfolgreich angemeldet hat. Grundlage * fuer beide Sicherheitsnetze in class-guard.php: Die eigene Adresse * einer Person wird fuer ihr eigenes Konto nicht gesperrt. */ public static function has_recent_login( $ip_hash, $username ) { global $wpdb; $since = gmdate( 'Y-m-d H:i:s', time() - self::RETENTION_DAYS * DAY_IN_SECONDS ); return (bool) $wpdb->get_var($wpdb->prepare( // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching -- plugineigene Tabelle, Abfragen sind vorbereitet; ein Login-Protokoll darf nicht gecacht werden. "SELECT 1 FROM " . self::table_name() . " WHERE ip_hash = %s AND username = %s AND success = 1 AND created_at >= %s LIMIT 1", // phpcs:ignore $ip_hash, mb_substr( (string) $username, 0, 60 ), $since )); } /** * Sicherheitsnetz gegen versehentlichen Admin-Lockout: true, wenn sich * dieser Benutzername -- ein Konto mit manage_options -- von diesem * IP-Hash aus kuerzlich erfolgreich angemeldet hat. Gebunden an das * Konto, nicht nur an die IP: Hinter einem Proxy teilen sich viele * Besucher eine Adresse, und eine reine IP-Ausnahme hebelte die Sperre * dann fuer alle anderen Konten auf. */ public static function has_recent_admin_login( $ip_hash, $username ) { $user = get_user_by( 'login', (string) $username ); if ( ! $user || ! user_can( $user, 'manage_options' ) ) { return false; } return self::has_recent_login( $ip_hash, $username ); } /** Vergisst die Fehlversuche eines IP-Hashes (beim Entsperren), damit die Sperre nicht sofort wieder greift. */ public static function forget_failures_for_hash( $ip_hash ) { global $wpdb; return (int) $wpdb->query( $wpdb->prepare( 'DELETE FROM ' . self::table_name() . ' WHERE ip_hash = %s AND success = 0', $ip_hash ) ); // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.PreparedSQL.NotPrepared -- plugineigene Tabelle, Name ist fest. } /** Vergisst die Fehlversuche eines Kontos, ueber alle Adressen (beim Entsperren). */ public static function forget_failures_for_username( $username ) { global $wpdb; return (int) $wpdb->query( $wpdb->prepare( 'DELETE FROM ' . self::table_name() . ' WHERE username = %s AND success = 0', mb_substr( (string) $username, 0, 60 ) ) ); // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.PreparedSQL.NotPrepared -- plugineigene Tabelle, Name ist fest. } /** * Verlaufseintraege zu einem Konto (fuer den Datenexport). * * @return object[] */ public static function attempts_for_username( $username, $limit = 1000 ) { global $wpdb; return (array) $wpdb->get_results( $wpdb->prepare( 'SELECT id, success, created_at FROM ' . self::table_name() . ' WHERE username = %s ORDER BY created_at DESC LIMIT %d', mb_substr( (string) $username, 0, 60 ), $limit ) ); // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.PreparedSQL.NotPrepared -- plugineigene Tabelle, Name ist fest. } /** Loescht alle Verlaufseintraege eines Kontos (fuer die Datenloeschung). */ public static function delete_for_username( $username ) { global $wpdb; return (int) $wpdb->query( $wpdb->prepare( 'DELETE FROM ' . self::table_name() . ' WHERE username = %s', mb_substr( (string) $username, 0, 60 ) ) ); // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.PreparedSQL.NotPrepared -- plugineigene Tabelle, Name ist fest. } public static function recent_attempts( $limit = 20 ) { global $wpdb; return $wpdb->get_results($wpdb->prepare( // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching -- plugineigene Tabelle, Abfragen sind vorbereitet; ein Login-Protokoll darf nicht gecacht werden. 'SELECT * FROM ' . self::table_name() . ' ORDER BY created_at DESC LIMIT %d', // phpcs:ignore $limit )); } }