API de plugins de RdpGuard

Utilice la API de plugins para detectar fallos en registros no compatibles de forma nativa. Su plugin analiza las entradas; RdpGuard supervisa los archivos, cuenta los fallos y bloquea las IP según sus ajustes.

Cree una biblioteca de clases .NET Framework y añada una referencia a rdpguard-plugin-api.dll desde la carpeta de RdpGuard. La API y el ejemplo están dirigidos a .NET Framework 4.5.

Implemente IExternalLogBasedEngine en una clase pública con un constructor sin parámetros. El ejemplo siguiente recibe uno automáticamente porque no declara ningún constructor.

Coloque el plugin en la subcarpeta Plugins de RdpGuard, por ejemplo C:\Program Files\RdpGuard\Plugins.

Esta es la interfaz del plugin:

namespace rdpguard_plugin_api {

    public interface IExternalEngine {

        string Name { get; }
        string Protocol { get; }
    }

    public interface IExternalLogBasedEngine : IExternalEngine {

        string Directory { get; }
        string FileMask { get; }

        bool IsFailedLoginAttempt(string _line, out string _ip, out string _username);
    }
}

Devuelva true para un fallo y asigne una IP válida a _ip. Asigne _username a null si el registro no contiene un nombre de usuario. Devuelva false para las demás entradas.

Ejemplo de implementación:

using rdpguard_plugin_api;

namespace rdpguard_test_plugin {

    public class MyEngine : IExternalLogBasedEngine {

        public string Name => "TestEngine";
        public string Protocol => "MyProto";

        public string Directory => @"C:\MyApp\Logs\";
        public string FileMask => "*.log";

        public bool IsFailedLoginAttempt(string _line, out string _ip, out string _username) {

            _ip = _username = null;

            // sample log line:
            // 2020-06-22 10:29:18 AUTH-ERROR admin 66.249.65.238 Invalid+username+or+password

            var parts = _line.Split(' ');

            if (parts.Length > 5 && "AUTH-ERROR" == parts[2]) {
                _username = parts[3];
                _ip = parts[4];
                return true;
            }

            return false;
        }
    }
}

Compile el plugin y copie la DLL en C:\Program Files\RdpGuard\Plugins (o en la subcarpeta Plugins de su instalación). Créela si es necesario y reinicie el servicio mediante Herramientas, Servicio RdpGuard, Reiniciar.

Seleccione el nivel Detallado en Herramientas, Opciones, Registros y haga clic en Guardar antes de reiniciar. Busque este mensaje:

ExternalLogBasedEngine::TestEngine started (C:\MyApp\Logs\)

Este mensaje confirma que el plugin se ha iniciado. Para probar la detección, genere nuevos fallos en su aplicación y compruebe que RdpGuard los registra.

Contáctenos si necesita ayuda con su plugin.