login-ZJU.NET 0.1.0

login-ZJU.NET

A lightweight .NET library for authenticating with ZJU (Zhejiang University) services, with first-class dependency injection support.

Based on login-ZJU by 5dbwat4 (MIT License). This is a C# / .NET port — see THIRD-PARTY-NOTICES for the original license.

Install

Target frameworks:

• net8.0
• net9.0
• net10.0

This package uses TargetFramework-specific Microsoft.Extensions.* versions to maximize compatibility:

• net8.0 → Microsoft.Extensions.* 8.x
• net9.0 → Microsoft.Extensions.* 9.x
• net10.0 → Microsoft.Extensions.* 10.x

dotnet add package login-ZJU.NET

Quick Start

Dependency Injection — factory pattern (recommended)

using LoginZju.DependencyInjection;

// Register factories (no credentials here — those are per-user at runtime).
services.AddLoginZju();

// Optionally register CC98 factory (app-level OAuth2 client config).
services.AddLoginZjuCc98(options =>
{
    options.ClientId = "your_client_id";
    options.ClientSecret = "your_client_secret";
});

Then inject ILoginZjuFactory and create per-user instances:

public class MyService(ILoginZjuFactory factory)
{
    public async Task DoWorkAsync(string username, string password)
    {
        using var auth = factory.CreateAuth(username, password);
        using var courses = factory.CreateCourses(auth);

        // FetchAsync automatically handles login on first call.
        var response = await courses.FetchAsync("https://courses.zju.edu.cn/api/courses");
        var content = await response.Content.ReadAsStringAsync();
    }
}

Direct usage (without DI)

using LoginZju;
using LoginZju.Services;

using var auth = new ZjuamAuth("username", "password");
using var zdbk = new ZdbkService(auth);

var response = await zdbk.FetchAsync("https://zdbk.zju.edu.cn/jwglxt/some/api");
var content = await response.Content.ReadAsStringAsync();

When using DI in a multi-user application, prefer creating one shared IZjuamAuth instance per user session/request flow and then create per-service instances from that auth object. This matches the upstream implementation behavior and avoids repeated CAS logins.

Supported Services

鉴于部分服务可能会变更登录流程，如果发现登录流程失效，欢迎 提交 Issue 或 发起 PR。

API Overview

All services implement IZjuService:

public interface IZjuService : IDisposable
{
    Task LoginAsync(CancellationToken cancellationToken = default);
    Task<HttpResponseMessage> FetchAsync(
        string url,
        Action<HttpRequestMessage>? configureRequest = null,
        CancellationToken cancellationToken = default);
}

Each service additionally has its own interface (e.g. ICoursesService, ICc98Service) that extends IZjuService, and IZjuamAuth adds CAS/OAuth2 helpers:

public interface IZjuamAuth : IZjuService
{
    Task<string> LoginServiceAsync(string serviceUrl, ...);
    Task<string> LoginServiceOAuth2Async(string redirectUrl, ...);
}

Dependency Injection — factory pattern

采用工厂模式，支持多用户多实例。AddLoginZju 注册 ILoginZjuFactory，通过工厂在运行时为每个用户创建独立的认证和服务实例：

// 注册工厂（不含凭据，凭据在运行时按用户提供）
services.AddLoginZju();

// 可选：注册 CC98 工厂（ClientId/ClientSecret 为应用级配置）
services.AddLoginZjuCc98(options =>
{
    options.ClientId = config["Cc98:ClientId"]!;
    options.ClientSecret = config["Cc98:ClientSecret"]!;
});

运行时创建用户实例：

// 每个用户拥有独立的 auth + 服务实例（独立 cookie / token）
using var auth = factory.CreateAuth(username, password);
using var courses = factory.CreateCourses(auth);
var response = await courses.FetchAsync("...");

// CC98（独立账号体系）
using var cc98 = cc98Factory.Create(cc98Username, cc98Password);

Sending POST requests

var response = await service.FetchAsync("https://example.zju.edu.cn/api", request =>
{
    request.Method = HttpMethod.Post;
    request.Content = new StringContent("{\"key\":\"value\"}", Encoding.UTF8, "application/json");
});

ETA Encryption Helpers

using LoginZju.Services;

var encrypted = EtaService.Encode("plaintext");
var decrypted = EtaService.Decode(encrypted);

Sample

See the Sample project for complete usage examples. Copy .env.template to .env, fill in your credentials, and toggle TEST_* flags to choose which services to test.

The Sample project currently targets net9.0 and inherits TargetFramework-specific package version selection from central package management.

License

This project is licensed under the Apache License 2.0.

This project is a derivative work of login-ZJU by 5dbwat4, which is licensed under the MIT License. See THIRD-PARTY-NOTICES for the full original license text.