RS.Fritz.Manager.API 2.4.0-alpha0015

.NET 7.0
This is a prerelease version of RS.Fritz.Manager.API.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package RS.Fritz.Manager.API --version 2.4.0-alpha0015
NuGet\Install-Package RS.Fritz.Manager.API -Version 2.4.0-alpha0015
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="RS.Fritz.Manager.API" Version="2.4.0-alpha0015" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add RS.Fritz.Manager.API --version 2.4.0-alpha0015
#r "nuget: RS.Fritz.Manager.API, 2.4.0-alpha0015"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install RS.Fritz.Manager.API as a Cake Addin
#addin nuget:?package=RS.Fritz.Manager.API&version=2.4.0-alpha0015&prerelease

// Install RS.Fritz.Manager.API as a Cake Tool
#tool nuget:?package=RS.Fritz.Manager.API&version=2.4.0-alpha0015&prerelease

RS.Fritz.Manager

Allows FritzBox device detection, monitoring, configuring and packet capturing.

Available as a standalone Windows application (UI) and as a NuGet package (API).

For a list of implemented services check the Service implementation status

RS.Fritz.Manager.UI

A Windows .NET WPF application for x64 and ARM64.

Untitled

Untitled1

Untitled3

Untitled4

RS.Fritz.Manager.API

A NuGet package to manage FritzBox devices using pure WCF calls.

Usage Examples

using System.Net;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using RS.Fritz.Manager.API;

// Register the Fritz services in the dependency container using AddFritzApi()
using IHost host = Host.CreateDefaultBuilder(args)
    .ConfigureServices((_, services) => services.AddFritzApi())
    .Build();

using IServiceScope serviceScope = host.Services.CreateScope();

// Search for routers and take the first one
IDeviceSearchService deviceSearchService = serviceScope.ServiceProvider.GetRequiredService<IDeviceSearchService>();
InternetGatewayDevice device = (await deviceSearchService.GetDevicesAsync()).First();

// Show the device model from UPnP data
Console.WriteLine($"Device model: {device.UPnPDescription.Device.ModelDescription}");

// Initialize the device for TR-064, retrieves the security port and the users
await device.InitializeAsync();

// Provide the password for the last logged on user
string lastUsedUserName = device.Users.Single(q => q.LastUser).Name;
Console.WriteLine($"Enter password for {lastUsedUserName}:");
device.NetworkCredential = new NetworkCredential(lastUsedUserName, Console.ReadLine());

// TR-064 example; show the device uptime from the TR-064 DeviceInfo service
DeviceInfoGetInfoResponse deviceInfo = await device.DeviceInfoGetInfoAsync();
Console.WriteLine($"Device uptime: {TimeSpan.FromSeconds(deviceInfo.Uptime)}");

// Special services

// Retrieving the device users manually
IUsersService usersService = serviceScope.ServiceProvider.GetRequiredService<IUsersService>();
IEnumerable<User> users = await usersService.GetUsersAsync(device);
users.ToList().ForEach(q => Console.WriteLine($"User: {q.Name}"));

// Retrieving a list of device hosts in the network
IDeviceHostsService deviceHostsService = serviceScope.ServiceProvider.GetRequiredService<IDeviceHostsService>();
DeviceHostInfo deviceHostInfo = await deviceHostsService.GetDeviceHostsAsync(device);
deviceHostInfo.DeviceHosts.ToList().ForEach(q => Console.WriteLine($"Device host: {q.HostName}"));

// Retrieving a list of mesh hosts in the network
IDeviceMeshService deviceMeshService = serviceScope.ServiceProvider.GetRequiredService<IDeviceMeshService>();
DeviceMeshInfo deviceMeshInfo = await deviceMeshService.GetDeviceMeshAsync(device);
deviceMeshInfo.DeviceMesh.Nodes.ToList().ForEach(q => Console.WriteLine($"Mesh host: {q.DeviceName}"));

// Retrieving a list of WLAN devices in the network
IWlanDeviceService wlanDeviceService = serviceScope.ServiceProvider.GetRequiredService<IWlanDeviceService>();
WlanDeviceInfo wlanDeviceInfo = await wlanDeviceService.GetWlanDevicesAsync(device);
wlanDeviceInfo.WlanDeviceList.Items.ToList().ForEach(q => Console.WriteLine($"WLAN device: {q.AssociatedDeviceIpAddress}"));

// Retrieve a new session for use in the WebUI
IWebUiService webUiService = serviceScope.ServiceProvider.GetRequiredService<IWebUiService>();
WebUiSessionInfo webUiSessionInfo = await webUiService.LogonAsync(device);
Console.WriteLine($"Session: {webUiSessionInfo.Sid}");

// Capture live network traffic from router to file
ICaptureControlService captureControlService = serviceScope.ServiceProvider.GetRequiredService<ICaptureControlService>();
IEnumerable<CaptureInterfaceGroup>? interfaceGroups = await captureControlService.GetInterfacesAsync(device);
CaptureInterface captureInterface = interfaceGroups.First().CaptureInterfaces.First();
var fileInfo = new FileInfo(FormattableString.Invariant($"c:\\temp\\{captureInterface.Name}_{DateTime.Now.ToString("s").Replace(":", string.Empty)}.eth"));

Task.Run(() => StopCaptureAsync(device, captureInterface, TimeSpan.FromSeconds(10), captureControlService));

await captureControlService.StartCaptureAsync(device, fileInfo, captureInterface);
Console.WriteLine($"Network trace written to file: {fileInfo}");

await host.RunAsync();

static async Task StopCaptureAsync(InternetGatewayDevice device, CaptureInterface captureInterface, TimeSpan timeSpan, ICaptureControlService captureControlService)
{
    await Task.Delay(timeSpan);
    await captureControlService.StopCaptureAsync(device, captureInterface);
}

TR-064 Service implementation status

WAN

  • 🔶 urn:dslforum-org:service:WANIPConnection
    • ✅ GetInfo
    • ✅ GetConnectionTypeInfo
    • ❌ SetConnectionType
    • ✅ GetStatusInfo
    • ✅ GetNATRSIPStatus
    • ❌ SetConnectionTrigger
    • ❌ ForceTermination
    • ❌ RequestConnection
    • ✅ X_GetDNSServers
    • ✅ GetPortMappingNumberOfEntries
    • ✅ GetGenericPortMappingEntry
    • ❌ GetSpecificPortMappingEntry
    • ❌ AddPortMapping
    • ❌ DeletePortMapping
    • ✅ GetExternalIPAddress
    • ❌ SetRouteProtocolRx
    • ❌ SetIdleDisconnectTime
  • 🔶 urn:dslforum-org:service:WANPPPConnection
    • ✅ GetInfo
    • ✅ GetConnectionTypeInfo
    • ❌ SetConnectionType
    • ✅ GetStatusInfo
    • ✅ GetLinkLayerMaxBitRates
    • ✅ GetUserName
    • ❌ SetUserName
    • ❌ SetPassword
    • ✅ GetNATRSIPStatus
    • ❌ SetConnectionTrigger
    • ❌ ForceTermination
    • ❌ RequestConnection
    • ✅ X_GetDNSServers
    • ✅ GetPortMappingNumberOfEntries
    • ✅ GetGenericPortMappingEntry
    • ❌ GetSpecificPortMappingEntry
    • ❌ AddPortMapping
    • ❌ DeletePortMapping
    • ✅ GetExternalIPAddress
    • ❌ SetRouteProtocolRx
    • ❌ SetIdleDisconnectTime
    • ✅ X_AVM-DE_GetAutoDisconnectTimeSpan
    • ❌ X_AVM-DE_SetAutoDisconnectTimeSpan
  • ✅ urn:dslforum-org:service:WANCommonInterfaceConfig
    • ✅ GetCommonLinkProperties
    • ✅ GetTotalBytesSent
    • ✅ GetTotalBytesReceived
    • ✅ GetTotalPacketsSent
    • ✅ GetTotalPacketsReceived
    • ✅ X_AVM-DE_SetWANAccessType
    • ✅ X_AVM-DE_GetOnlineMonitor
  • ✅ urn:dslforum-org:service:WANEthernetLinkConfig
    • ✅ GetEthernetLinkStatus
  • ✅ urn:dslforum-org:service:WANDSLInterfaceConfig
    • ✅ GetInfo
    • ✅ GetStatisticsTotal
    • ✅ X_AVM-DE_GetDSLDiagnoseInfo
    • ✅ X_AVM-DE_GetDSLInfo
  • 🔶 urn:dslforum-org:service:WANDSLLinkConfig
    • ✅ GetInfo
    • ❌ SetEnable
    • ❌ SetDSLLinkType
    • ✅ GetDSLLinkInfo
    • ❌ SetDestinationAddress
    • ✅ GetDestinationAddress
    • ❌ SetATMEncapsulation
    • ✅ GetATMEncapsulation
    • ✅ GetAutoConfig
    • ✅ GetStatistics
  • ❌ urn:dslforum-org:service:X_AVM-DE_WANMobileConnection
  • 🔶 urn:dslforum-org:service:X_AVM-DE_Speedtest
    • ✅ GetInfo
    • ❌ SetConfig
    • ✅ GetStatistics
    • ❌ ResetStatistics
  • ❌ urn:dslforum-org:service:X_AVM-DE_RemoteAccess
  • ❌ urn:dslforum-org:service:X_AVM-DE_MyFritz
  • ❌ urn:dslforum-org:service:X_AVM-DE_HostFilter
  • 🔶 urn:dslforum-org:service:Layer3Forwarding
    • ❌ SetDefaultConnectionService
    • ✅ GetDefaultConnectionService
    • ✅ GetForwardNumberOfEntries
    • ❌ AddForwardingEntry
    • ❌ DeleteForwardingEntry
    • ❌ GetSpecificForwardingEntry
    • ✅ GetGenericForwardingEntry
    • ❌ SetForwardingEntryEnable

Telephony

  • ❌ urn:dslforum-org:service:X_AVM-DE_OnTel
  • ❌ urn:dslforum-org:service:X_AVM-DE_TAM
  • ❌ urn:dslforum-org:service:X_VoIP

Home network

  • 🔶 urn:dslforum-org:service:Hosts
    • ✅ GetHostNumberOfEntries
    • ❌ GetSpecificHostEntry
    • ✅ GetGenericHostEntry
    • ✅ X_AVM-DE_GetInfo
    • ✅ X_AVM-DE_GetChangeCounter
    • ❌ X_AVM-DE_GetAutoWakeOnLANByMACAddress
    • ❌ X_AVM-DE_SetAutoWakeOnLANByMACAddress
    • ❌ X_AVM-DE_SetHostNameByMACAddress
    • ❌ X_AVM-DE_WakeOnLANByMACAddress
    • ❌ X_AVM-DE_GetSpecificHostEntryByIp
    • ✅ X_AVM-DE_HostsCheckUpdate
    • ❌ X_AVM-DE_HostDoUpdate
    • ❌ X_AVM-DE_SetPrioritizationByIP
    • ✅ X_AVM-DE_GetHostListPath
    • ✅ X_AVM-DE_GetMeshListPath
    • ✅ X_AVM-DE_GetFriendlyName
    • ❌ X_AVM-DE_SetFriendlyName
    • ❌ X_AVM-DE_SetFriendlyNameByIP
    • ❌ X_AVM-DE_SetFriendlyNameByMAC
  • 🔶 urn:dslforum-org:service:WLANConfiguration
    • ❌ SetEnable
    • ✅ GetInfo
    • ❌ SetConfig
    • ❌ SetSecurityKeys
    • ❌ GetSecurityKeys
    • ❌ SetBasBeaconSecurityProperties
    • ✅ GetBasBeaconSecurityProperties
    • ✅ GetBSSID
    • ✅ GetSSID
    • ❌ SetSSID
    • ✅ GetBeaconType
    • ❌ SetBeaconType
    • ✅ GetChannelInfo
    • ❌ SetChannel
    • ✅ GetBeaconAdvertisement
    • ❌ SetBeaconAdvertisement
    • ✅ GetTotalAssociations
    • ❌ GetGenericAssociatedDeviceInfo
    • ❌ GetSpecificAssociatedDeviceInfo
    • ❌ X_AVM-DE_GetSpecificAssociatedDeviceInfoByIp
    • ✅ X_AVM-DE_GetWLANDeviceListPath
    • ❌ X_AVM-DE_SetStickSurfEnable
    • ✅ X_AVM-DE_GetIPTVOptimized
    • ❌ X_AVM-DE_SetIPTVOptimized
    • ✅ GetStatistics
    • ✅ GetPacketStatistics
    • ✅ X_AVM-DE_GetNightControl
    • ❌ X_SetHighFrequencyBand
    • ✅ X_AVM-DE_GetWLANHybridMode
    • ❌ X_AVM-DE_SetWLANHybridMode
    • ✅ X_AVM-DE_GetWLANExtInfo
    • ❌ X_AVM-DE_SetWLANGlobalEnable
    • ✅ X_AVM-DE_GetWPSInfo
    • ❌ X_AVM-DE_SetWPSConfig
    • ❌ X_AVM-DE_SetWPSEnable
    • ✅ X_AVM-DE_GetWLANConnectionInfo
  • 🔶 urn:dslforum-org:service:LANHostConfigManagement
    • ✅ GetInfo
    • ❌ SetDHCPServerEnable
    • ❌ SetSubnetMask
    • ✅ GetSubnetMask
    • ❌ SetIPRouter
    • ✅ GetIPRoutersList
    • ❌ SetIPInterface
    • ✅ GetAddressRange
    • ❌ SetAddressRange
    • ✅ GetIPInterfaceNumberOfEntries
    • ✅ GetDNSServers
  • 🔶 urn:dslforum-org:service:LANEthernetInterfaceConfig
    • ❌ SetEnable
    • ✅ GetInfo
    • ✅ GetStatistics
  • ❌ urn:dslforum-org:service:X_AVM-DE_Dect
  • ❌ urn:dslforum-org:service:X_AVM-DE_Media
  • ❌ urn:dslforum-org:service:X_AVM-DE_Homeauto
  • ❌ urn:dslforum-org:service:X_AVM-DE_Homeplug

Storage/NAS

  • ❌ urn:dslforum-org:service:X_AVM-DE_Storage
  • ❌ urn:dslforum-org:service:X_AVM-DE_UPnP
  • ❌ urn:dslforum-org:service:X_AVM-DE_WebDAVClient
  • ❌ urn:dslforum-org:service:X_AVM-DE_Filelinks

System

  • ✅ urn:dslforum-org:service:DeviceInfo
    • ✅ GetInfo
    • ✅ SetProvisioningCode
    • ✅ GetDeviceLog
    • ✅ GetSecurityPort
  • 🔶 urn:dslforum-org:service:DeviceConfig
    • ✅ GetPersistentData
    • ❌ SetPersistentData
    • ❌ ConfigurationStarted
    • ❌ ConfigurationFinished
    • ❌ FactoryReset
    • ❌ Reboot
    • ✅ X_GenerateUUID
    • ❌ X_AVM-DE_GetConfigFile
    • ❌ X_AVM-DE_SetConfigFile
    • ✅ X_AVM-DE_CreateUrlSID
    • ✅ X_AVM-DE_GetSupportDataInfo
    • ❌ X_AVM-DE_SendSupportData
    • ❌ X_AVM-DE_GetSupportDataEnable
    • ❌ X_AVM-DE_SetSupportDataEnable
  • ✅ urn:dslforum-org:service:LANConfigSecurity
    • ✅ GetInfo
    • ✅ X_AVM-DE_GetAnonymousLogin
    • ✅ X_AVM-DE_GetCurrentUser
    • ✅ SetConfigPassword
    • ✅ X_AVM-DE_GetUserList
  • ❌ urn:dslforum-org:service:X_AVM-DE_AppSetup
  • ✅ urn:dslforum-org:service:ManagementServer
    • ✅ GetInfo
    • ✅ SetManagementServerURL
    • ✅ SetManagementServerUsername
    • ✅ SetManagementServerPassword
    • ✅ SetPeriodicInform
    • ✅ SetConnectionRequestAuthentication
    • ✅ SetUpgradeManagement
    • ✅ X_SetTR069Enable
    • ✅ X_AVM-DE_GetTR069FirmwareDownloadEnabled
    • ✅ X_AVM-DE_SetTR069FirmwareDownloadEnabled
  • ❌ urn:dslforum-org:service:X_AVM-DE_USPController
  • ❌ urn:dslforum-org:service:X_AVM-DE_Auth
  • ✅ urn:dslforum-org:service:Time
    • ✅ GetInfo
    • ✅ SetNTPServers
  • ✅ urn:dslforum-org:service:UserInterface
    • ✅ GetInfo
    • ✅ X_AVM-DE_CheckUpdate
    • ✅ X_AVM-DE_DoPrepareCGI
    • ✅ X_AVM-DE_DoUpdate
    • ✅ X_AVM-DE_DoManualUpdate
    • ✅ X_AVM-DE_GetInternationalConfig
    • ✅ X_AVM-DE_SetInternationalConfig
    • ✅ X_AVM-DE_GetInfo
    • ✅ X_AVM-DE_SetConfig
Product Versions
.NET net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.0-windows
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.4.0-alpha0021 42 2/21/2023
2.4.0-alpha0015 51 1/27/2023
2.4.0-alpha0010 52 1/27/2023
2.4.0-alpha0006 56 1/25/2023
2.4.0-alpha0003 46 1/25/2023
2.4.0-alpha0001 51 1/24/2023
2.3.0 68 1/24/2023
2.3.0-alpha0061 49 1/22/2023
2.3.0-alpha0049 46 1/19/2023
2.3.0-alpha0038 49 1/18/2023
2.3.0-alpha0028 49 1/16/2023
2.3.0-alpha0021 58 11/19/2022
2.3.0-alpha0015 55 10/28/2022
2.3.0-alpha0010 87 7/9/2022
2.3.0-alpha0006 78 5/11/2022
2.3.0-alpha0003 78 4/13/2022
2.3.0-alpha0001 79 4/12/2022
2.2.0 139 4/12/2022
2.2.0-alpha0131 79 4/12/2022
2.2.0-alpha0107 80 4/12/2022
2.2.0-alpha0084 74 4/8/2022
2.2.0-alpha0066 73 4/7/2022
2.2.0-alpha0050 79 4/7/2022
2.2.0-alpha0036 83 4/7/2022
2.2.0-alpha0023 74 4/6/2022
2.2.0-alpha0011 68 4/5/2022
2.2.0-alpha0003 69 4/4/2022
2.1.0 80 4/4/2022
2.1.0-alpha0316 68 4/4/2022
2.1.0-alpha0274 75 4/3/2022
2.1.0-alpha0234 84 4/1/2022
2.1.0-alpha0198 71 3/30/2022
2.1.0-alpha0168 72 3/28/2022
2.1.0-alpha0140 67 3/28/2022
2.1.0-alpha0114 70 3/28/2022
2.1.0-alpha0090 67 3/27/2022
2.1.0-alpha0068 68 3/27/2022
2.1.0-alpha0048 62 3/26/2022
2.1.0-alpha0032 64 3/25/2022
2.1.0-alpha0019 71 3/25/2022
2.1.0-alpha0008 67 3/24/2022
2.0.0 81 3/22/2022
2.0.0-beta0002 67 3/22/2022
2.0.0-beta0001 67 3/22/2022
2.0.0-alpha0011 68 3/24/2022
2.0.0-alpha0004 68 3/23/2022
1.1.0-alpha0161 70 3/22/2022
1.1.0-alpha0135 67 3/22/2022
1.1.0-alpha0111 69 3/22/2022
1.1.0-alpha0089 52 3/21/2022
1.1.0-alpha0069 59 3/21/2022
1.1.0-alpha0051 63 3/21/2022
1.1.0-alpha0036 63 3/21/2022
1.1.0-alpha0023 66 3/21/2022
1.1.0-alpha0012 62 3/20/2022
1.1.0-alpha0003 75 3/19/2022
1.1.0-alpha0001 67 3/19/2022
1.0.0 79 3/19/2022
1.0.0-beta0003 68 3/19/2022
1.0.0-beta0002 68 3/19/2022
1.0.0-beta0001 68 3/19/2022
0.2.0-alpha1222 64 3/19/2022
0.2.0-alpha1221 65 3/19/2022
0.2.0-alpha1118 71 3/19/2022
0.2.0-alpha1017 67 3/19/2022
0.2.0-alpha0926 65 3/19/2022
0.2.0-alpha0836 66 3/19/2022
0.2.0-alpha0747 62 3/18/2022
0.2.0-alpha0660 64 3/18/2022
0.2.0-alpha0574 67 3/18/2022
0.2.0-alpha0489 62 3/18/2022
0.2.0-alpha0405 70 3/18/2022
0.2.0-alpha0322 65 3/18/2022
0.2.0-alpha0240 66 3/18/2022
0.2.0-alpha0159 67 3/18/2022
0.2.0-alpha0079 68 3/17/2022
0.1.3 78 3/17/2022
0.1.3-alpha0051 76 3/17/2022
0.1.3-alpha0050 68 3/17/2022
0.1.3-alpha0049 70 3/17/2022
0.1.3-alpha0048 70 3/17/2022
0.1.3-alpha0047 73 3/16/2022
0.1.3-alpha0046 73 3/16/2022
0.1.3-alpha0045 68 3/16/2022
0.1.3-alpha.44 74 3/15/2022
0.1.3-alpha.43 64 3/14/2022
0.1.3-alpha.42 64 3/14/2022
0.1.3-alpha.41 72 3/14/2022
0.1.3-alpha.40 69 3/14/2022
0.1.3-alpha.39 66 3/14/2022
0.1.3-alpha.38 65 3/14/2022
0.1.3-alpha.37 70 3/14/2022
0.1.3-alpha.36 62 3/13/2022
0.1.3-alpha.35 70 3/13/2022
0.1.3-alpha.34 67 3/13/2022
0.1.3-alpha.33 65 3/13/2022
0.1.3-alpha.32 72 3/13/2022
0.1.3-alpha.31 70 3/13/2022
0.1.3-alpha.30 69 3/13/2022
0.1.3-alpha.29 68 3/13/2022
0.1.3-alpha.28 66 3/13/2022
0.1.3-alpha.27 68 3/13/2022
0.1.3-alpha.26 70 3/13/2022
0.1.3-alpha.8 70 3/13/2022
0.1.3-alpha.7 72 3/13/2022
0.1.3-alpha.4 72 3/13/2022
0.1.3-alpha.3 66 3/13/2022
0.1.3-alpha.2 75 3/13/2022
0.1.2 78 3/12/2022
0.1.2-alpha.15 70 3/12/2022
0.1.2-alpha.14 73 3/12/2022
0.1.2-alpha.13 72 3/12/2022
0.1.2-alpha.12 74 3/12/2022
0.1.2-alpha.11 72 3/12/2022
0.1.2-alpha.10 76 3/11/2022
0.1.2-alpha.7 74 3/11/2022
0.1.2-alpha.6 70 3/11/2022
0.1.2-alpha.2 73 3/10/2022
0.1.1 84 3/9/2022
0.1.1-alpha.10 72 3/10/2022
0.1.1-alpha.9 72 3/9/2022
0.1.1-alpha.6 75 3/9/2022
0.1.1-alpha.2 77 3/9/2022
0.1.0 81 3/7/2022
0.1.0-alpha.80 75 3/8/2022
0.1.0-alpha.79 83 3/8/2022
0.1.0-alpha.78 80 3/7/2022
0.1.0-alpha.77 80 3/6/2022
0.1.0-alpha.76 75 3/6/2022
0.1.0-alpha.75 69 3/6/2022
0.1.0-alpha.74 65 3/5/2022
0.1.0-alpha.73 75 3/5/2022
0.1.0-alpha.72 77 3/5/2022