KASserver.NET 1.2.0

KASserver.NET

Unofficial .NET client for the ALL-INKL.COM KAS API (Kunden-Administrations-System).

The KAS API is SOAP 1.1 and ships a faulty WSDL (response element declared Result, server returns return) that breaks strict SOAP/WCF clients. KASserver.NET talks raw SOAP and parses the response itself, and additionally handles KAS session authentication and the KasFloodDelay rate limit automatically.

builder.Services.AddKasServer(options =>
{
    options.Login = "w00XXXXX";
    options.Password = "your-kas-password";
});

public class MailProvisioning(IKasClient kas)
{
    public async Task Run()
    {
        var login = await kas.AddMailAccountAsync(new AddMailAccount
        {
            LocalPart = "info",
            DomainPart = "example.com",
            Password = "S3cure-Pw!"
        });

        await kas.DeleteMailAccountAsync(login); // delete works on the mail_login, not the address
    }
}

Account management (subaccounts, account/superuser settings, ownership) is available too — superuser-only actions require the main account:

public class AccountProvisioning(IKasClient kas)
{
    public async Task Run()
    {
        var login = await kas.AddAccountAsync(new AddAccount
        {
            KasPassword = "Kas-Pw!",
            FtpPassword = "Ftp-Pw!",
            HostnameKind = AccountHostnameKind.Domain,
            HostnamePart1 = "example",
            HostnamePart2 = "com",
            Quota = new AccountQuota { MaxDomain = 1, MaxWebspace = 1024 },
        });

        await kas.UpdateSuperuserSettingsAsync(login, new UpdateSuperuserSettings { SshAccess = true });
        await kas.DeleteAccountAsync(login); // irreversible: removes all of the subaccount's resources
    }
}

DNS zone records are supported as well (write actions need the account's DNS-settings permission):

public class DnsProvisioning(IKasClient kas)
{
    public async Task Run()
    {
        var records = await kas.GetDnsRecordsAsync("example.com"); // zone_host trailing dot added for you

        var recordId = await kas.AddDnsRecordAsync(new AddDnsRecord
        {
            ZoneHost = "example.com",
            Type = DnsRecordType.Txt,
            RecordName = "_acme-challenge",
            RecordData = "token-value",
        });

        await kas.UpdateDnsRecordAsync(recordId, new UpdateDnsRecord { RecordData = "new-token" });
        await kas.DeleteDnsRecordAsync(recordId); // delete/update work on the record_id
    }
}

DynDNS users (add_ddnsuser, get_ddnsusers, update_ddnsuser, delete_ddnsuser) work the same way — KAS generates the technical dyndns_login:

var login = await kas.AddDynDnsUserAsync(new AddDynDnsUser
{
    Comment = "home router", Password = "Dyn-Pw!",
    Zone = "example.com", Label = "home", TargetIp = "203.0.113.10",
});
await kas.DeleteDynDnsUserAsync(login);

Not affiliated with or endorsed by Neue Medien Münnich / ALL-INKL.COM.

Full docs: https://github.com/emuuu/KASserver.NET