2020-09-12 17:41:37 +02:00
|
|
|
using System;
|
|
|
|
using System.Collections.Generic;
|
|
|
|
using System.Net;
|
|
|
|
using System.Net.NetworkInformation;
|
2020-09-14 16:46:38 +02:00
|
|
|
using Microsoft.AspNetCore.Http;
|
2020-09-12 17:41:37 +02:00
|
|
|
|
2020-09-14 16:46:38 +02:00
|
|
|
namespace MediaBrowser.Common.Net
|
2020-09-12 17:41:37 +02:00
|
|
|
{
|
|
|
|
/// <summary>
|
|
|
|
/// Interface for the NetworkManager class.
|
|
|
|
/// </summary>
|
|
|
|
public interface INetworkManager
|
|
|
|
{
|
|
|
|
/// <summary>
|
|
|
|
/// Event triggered on network changes.
|
|
|
|
/// </summary>
|
|
|
|
event EventHandler NetworkChanged;
|
|
|
|
|
|
|
|
/// <summary>
|
2022-07-19 21:53:10 +02:00
|
|
|
/// Gets a value indicating whether IPv6 is enabled.
|
2020-09-12 17:41:37 +02:00
|
|
|
/// </summary>
|
2022-07-19 21:28:04 +02:00
|
|
|
bool IsIpv6Enabled { get; }
|
2020-09-12 17:41:37 +02:00
|
|
|
|
|
|
|
/// <summary>
|
2022-07-19 21:53:10 +02:00
|
|
|
/// Gets a value indicating whether IPv4 is enabled.
|
2020-09-12 17:41:37 +02:00
|
|
|
/// </summary>
|
2022-07-19 21:28:04 +02:00
|
|
|
bool IsIpv4Enabled { get; }
|
2020-09-30 18:51:17 +02:00
|
|
|
|
2020-09-12 17:41:37 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Calculates the list of interfaces to use for Kestrel.
|
|
|
|
/// </summary>
|
2022-07-19 21:28:04 +02:00
|
|
|
/// <returns>A List{IPData} object containing all the interfaces to bind.
|
2020-09-12 17:41:37 +02:00
|
|
|
/// If all the interfaces are specified, and none are excluded, it returns zero items
|
|
|
|
/// to represent any address.</returns>
|
2020-09-30 18:51:17 +02:00
|
|
|
/// <param name="individualInterfaces">When false, return <see cref="IPAddress.Any"/> or <see cref="IPAddress.IPv6Any"/> for all interfaces.</param>
|
2022-07-20 14:29:30 +02:00
|
|
|
IReadOnlyList<IPData> GetAllBindInterfaces(bool individualInterfaces = false);
|
2020-09-12 17:41:37 +02:00
|
|
|
|
|
|
|
/// <summary>
|
2022-07-20 14:29:30 +02:00
|
|
|
/// Returns a list containing the loopback interfaces.
|
2020-09-12 17:41:37 +02:00
|
|
|
/// </summary>
|
2022-07-19 21:28:04 +02:00
|
|
|
/// <returns>List{IPData}.</returns>
|
2022-07-20 14:29:30 +02:00
|
|
|
IReadOnlyList<IPData> GetLoopbacks();
|
2020-09-12 17:41:37 +02:00
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
/// Retrieves the bind address to use in system url's. (Server Discovery, PlayTo, LiveTV, SystemInfo)
|
|
|
|
/// If no bind addresses are specified, an internal interface address is selected.
|
|
|
|
/// The priority of selection is as follows:-
|
|
|
|
///
|
|
|
|
/// The value contained in the startup parameter --published-server-url.
|
|
|
|
///
|
|
|
|
/// If the user specified custom subnet overrides, the correct subnet for the source address.
|
|
|
|
///
|
|
|
|
/// If the user specified bind interfaces to use:-
|
|
|
|
/// The bind interface that contains the source subnet.
|
|
|
|
/// The first bind interface specified that suits best first the source's endpoint. eg. external or internal.
|
|
|
|
///
|
|
|
|
/// If the source is from a public subnet address range and the user hasn't specified any bind addresses:-
|
|
|
|
/// The first public interface that isn't a loopback and contains the source subnet.
|
|
|
|
/// The first public interface that isn't a loopback. Priority is given to interfaces with gateways.
|
|
|
|
/// An internal interface if there are no public ip addresses.
|
|
|
|
///
|
|
|
|
/// If the source is from a private subnet address range and the user hasn't specified any bind addresses:-
|
|
|
|
/// The first private interface that contains the source subnet.
|
|
|
|
/// The first private interface that isn't a loopback. Priority is given to interfaces with gateways.
|
|
|
|
///
|
|
|
|
/// If no interfaces meet any of these criteria, then a loopback address is returned.
|
|
|
|
///
|
|
|
|
/// Interface that have been specifically excluded from binding are not used in any of the calculations.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="source">Source of the request.</param>
|
|
|
|
/// <param name="port">Optional port returned, if it's part of an override.</param>
|
|
|
|
/// <returns>IP Address to use, or loopback address if all else fails.</returns>
|
2020-09-14 16:46:38 +02:00
|
|
|
string GetBindInterface(HttpRequest source, out int? port);
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
/// Retrieves the bind address to use in system url's. (Server Discovery, PlayTo, LiveTV, SystemInfo)
|
|
|
|
/// If no bind addresses are specified, an internal interface address is selected.
|
2022-07-19 21:28:04 +02:00
|
|
|
/// (See <see cref="GetBindInterface(IPAddress, out int?)"/>.
|
2020-09-14 16:46:38 +02:00
|
|
|
/// </summary>
|
|
|
|
/// <param name="source">IP address of the request.</param>
|
|
|
|
/// <param name="port">Optional port returned, if it's part of an override.</param>
|
|
|
|
/// <returns>IP Address to use, or loopback address if all else fails.</returns>
|
|
|
|
string GetBindInterface(IPAddress source, out int? port);
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
/// Retrieves the bind address to use in system url's. (Server Discovery, PlayTo, LiveTV, SystemInfo)
|
|
|
|
/// If no bind addresses are specified, an internal interface address is selected.
|
2022-07-19 21:28:04 +02:00
|
|
|
/// (See <see cref="GetBindInterface(IPAddress, out int?)"/>.
|
2020-09-14 16:46:38 +02:00
|
|
|
/// </summary>
|
|
|
|
/// <param name="source">Source of the request.</param>
|
|
|
|
/// <param name="port">Optional port returned, if it's part of an override.</param>
|
|
|
|
/// <returns>IP Address to use, or loopback address if all else fails.</returns>
|
|
|
|
string GetBindInterface(string source, out int? port);
|
2020-09-12 17:41:37 +02:00
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
/// Get a list of all the MAC addresses associated with active interfaces.
|
|
|
|
/// </summary>
|
|
|
|
/// <returns>List of MAC addresses.</returns>
|
2022-07-20 14:29:30 +02:00
|
|
|
IReadOnlyList<PhysicalAddress> GetMacAddresses();
|
2020-09-12 17:41:37 +02:00
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
/// Returns true if the address is part of the user defined LAN.
|
2020-11-24 06:11:02 +01:00
|
|
|
/// The configuration option TrustIP6Interfaces overrides this functions behaviour.
|
2020-09-12 17:41:37 +02:00
|
|
|
/// </summary>
|
|
|
|
/// <param name="address">IP to check.</param>
|
|
|
|
/// <returns>True if endpoint is within the LAN range.</returns>
|
|
|
|
bool IsInLocalNetwork(string address);
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
/// Returns true if the address is part of the user defined LAN.
|
2020-11-24 06:11:02 +01:00
|
|
|
/// The configuration option TrustIP6Interfaces overrides this functions behaviour.
|
2020-09-12 17:41:37 +02:00
|
|
|
/// </summary>
|
|
|
|
/// <param name="address">IP to check.</param>
|
|
|
|
/// <returns>True if endpoint is within the LAN range.</returns>
|
|
|
|
bool IsInLocalNetwork(IPAddress address);
|
|
|
|
|
|
|
|
/// <summary>
|
2022-07-19 21:28:04 +02:00
|
|
|
/// Attempts to convert the interface name to an IP address.
|
|
|
|
/// eg. "eth1", or "enp3s5".
|
2020-09-12 17:41:37 +02:00
|
|
|
/// </summary>
|
2022-07-19 21:28:04 +02:00
|
|
|
/// <param name="intf">Interface name.</param>
|
2020-09-30 18:51:17 +02:00
|
|
|
/// <param name="result">Resultant object's ip addresses, if successful.</param>
|
2020-09-12 17:41:37 +02:00
|
|
|
/// <returns>Success of the operation.</returns>
|
2022-07-20 14:29:30 +02:00
|
|
|
bool TryParseInterface(string intf, out List<IPData>? result);
|
2020-09-12 17:41:37 +02:00
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
/// Returns all the internal Bind interface addresses.
|
|
|
|
/// </summary>
|
|
|
|
/// <returns>An internal list of interfaces addresses.</returns>
|
2022-07-20 14:29:30 +02:00
|
|
|
IReadOnlyList<IPData> GetInternalBindAddresses();
|
2021-03-11 22:36:58 +01:00
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
/// Checks to see if <paramref name="remoteIp"/> has access.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="remoteIp">IP Address of client.</param>
|
|
|
|
/// <returns><b>True</b> if has access, otherwise <b>false</b>.</returns>
|
|
|
|
bool HasRemoteAccess(IPAddress remoteIp);
|
2020-09-12 17:41:37 +02:00
|
|
|
}
|
|
|
|
}
|