RDPGW 1.0.0.1744875936

RDP Gateway .Net (RDPGW.Net)

RDPGW.Net is a lightweight and extensible ASP.NET library that brings Remote Desktop Gateway (RDP Gateway) functionality directly into your .NET web application. With easy plug-and-play integration, you can securely expose RDP services through your existing web app, with support for custom authentication and authorization flows.

✨ Features

• 🖥️ Seamlessly integrate RDP Gateway into any ASP.NET Core app.
• 🔐 Customizable authentication (Basic, Digest, Negotiate).
• 🛡️ Fine-grained resource-based authorization.
• ⚙️ Simple service registration and middleware configuration.

🚀 Getting Started

1. Add the Library

Add the package to your project:

dotnet add package RDPGW --version 

2. Register the Services

In your Program.cs or wherever you're building your service container, add:

builder.Services.AddRDPGW();

Optional: Add Custom Handlers for Authentication and/or Authorization

builder.Services.AddSingleton<IRDPGWAuthenticationHandler, AuthHandler>();
builder.Services.AddSingleton<IRDPGWAuthorizationHandler, AuthorizationHandler>();

3. Use the Middleware

Place this as the first middleware in the pipeline:

var app = builder.Build();

app.UseRDPGW(); // Must be first

// Other middlewares
app.UseRouting();
app.UseAuthentication();
app.UseAuthorization();

app.MapControllers();
app.Run();

🔐 Authentication & Authorization

Custom Authentication

To authenticate users, implement IRDPGWAuthenticationHandler. The interface provides hooks for Basic, Digest, and Negotiate methods.

public class AuthHandler : IRDPGWAuthenticationHandler
{
    public Task<RDPGWAuthenticationResult> HandleBasicAuth(string auth)
    {
        var challenge = Encoding.UTF8.GetString(Convert.FromBase64String(auth));
        var split = challenge.Split(":");

        var userName = split[0];
        var userPassword = split[1];

        // Your authentication logic here

        return Task.FromResult(RDPGWAuthenticationResult.Success(userName));
    }

    public Task<RDPGWAuthenticationResult> HandleDigestAuth(string auth)
    {
        throw new NotImplementedException(); // Not used in this example.
    }

    public Task<RDPGWAuthenticationResult> HandleNegotiateAuth(string auth)
    {
        throw new NotImplementedException(); // Not used in this example.
    }
}

Custom Authorization

To control access to specific RDP resources, implement IRDPGWAuthorizationHandler:

public class AuthorizationHandler : IRDPGWAuthorizationHandler
{
    public Task<bool> HandleUserAuthorization(string userId, string resource)
    {
        // Your authorization logic here
        return Task.FromResult(true); // Allow access
    }
}

The userId comes from your authentication handler. The resource is the identifier of the RDP target being accessed.

📞 Support & Contribution

• Found a bug? Want to suggest a feature? Open an issue.
• Contributions welcome via PRs!
• License: GNU GPL v3