SAIF.NetCore.EnvironmentClient dependencies

SAIF.NetCore.EnvironmentClient depends on the foundation SAIF.NetCore.ServiceContracts package for the interfaces it implements and consumes, on several Microsoft.Extensions.*/Newtonsoft.Json/System.DirectoryServices.AccountManagement third-party packages, and it makes its own outbound HTTP calls to a remote Environment API through the injected IHttpJsonClient contract.

Internal dependencies

Dependency	Reference Type	Usage
SAIF.NetCore.ServiceContracts	NuGet Package (same-repo)	Implements IEnvironmentClient; consumes IHttpJsonClient, IHttpRequestResult, ISystemHashService, and SystemType.

External dependencies

Dependency	Version	Usage
Microsoft.Extensions.Configuration.Json	3.1.9	Backs IConfiguration (GetSection, GetValue<T>, indexer) for the developer-settings override path.
Microsoft.Extensions.Hosting.Abstractions	3.1.9	Backs IHostEnvironment (ApplicationName, ContentRootPath).
Newtonsoft.Json	13.0.1	Deserializes the developer-settings override file (JsonConvert.DeserializeObject<ConfigSetting[]>).
System.DirectoryServices.AccountManagement	4.7.0	Active Directory group/host lookups in HostResolver (PrincipalContext, ComputerPrincipal, GroupPrincipal).

API dependencies

Endpoint	Method	Called from	Source library	Reached via	Usage
/v2/tracks/{ApplicationName}/value	GET	BaseEnvironmentClient.GetHostsByTrack (via Setup)	This library	—	Resolves the set of hosts per environment track to determine the application's own track and host identity.
/v2/settings/{ApplicationName}/{ApplicationHost}/value or /v2/settings/{ApplicationName}/{ApplicationHost}/{section}/value	GET	BaseEnvironmentClient.LoadSettings / LoadSettingsAsync (via GetSettingValue*, HasSetting, GetSectionSettings, CheckForUpdates)	This library	—	Loads configuration settings, optionally scoped to a named section, into the in-memory settings cache.
/settings/lastRefreshed	GET	BaseEnvironmentClient.TestForRefreshSettings (via CheckForUpdates)	This library	—	Checks whether cached settings are stale (throttled to roughly 60 seconds) before triggering a reload.
/v2/secureSetting/{ApplicationName}/{TrackName}[/{section}]/{configKey}/value?systemHashValue={hash}	GET	SecureEnvironmentClient.RetrieveSecureSetting<T> / RetrieveSecureSettingAsync<T> (via GetSecureSetting*)	This library	—	Retrieves a secure (crypto) configuration value, authorized by a system-hash query parameter.

All four endpoints are issued directly by BaseEnvironmentClient/SecureEnvironmentClient through the injected IHttpJsonClient.Get/GetAsync (ServiceContracts contract) against the base URL supplied by the EnvironmentApiUrl OS environment variable; the Environment API itself is an external HTTP service and is not part of this repository.

Dependency risks and notes

• IHttpJsonClient and ISystemHashService are consumed only as ServiceContracts interfaces; the library does not reference SAIF.NetCore.HttpClients or SAIF.NetCore.SystemHash/SAIF.NetCore.HashUtil directly, so the concrete HTTP transport and hash computation are determined entirely by what the consuming application registers*.
• TestForRefreshSettings reads GetResult<DateTime> before checking IsSuccessful; whether this throws on a failed result depends on the registered IHttpJsonClient implementation**.
• Server-side Environment API semantics (hash validation, lastRefreshed meaning, response casing) are outside this repository and cannot be verified from source alone**.
• The developer-settings override path couples this library to ASP.NET Core via a transitively flowed FrameworkReference Microsoft.AspNetCore.App from SAIF.NetCore.ServiceContracts, even for non-web (console/Windows-service) hosts*.

Related documentation

• Index
• Overview
• Architecture
• Configuration
• Operations and processes
• Business rules
• Security and authorization
• API reference

Note: Statements marked with * were inferred from code structure, naming conventions, or contextual evidence where direct confirmation was not available in source artifacts. Statements marked with ** could not be confirmed; treat as unknown until verified.

Sources

• src/SAIF.NetCore.EnvironmentClient/SAIF.NetCore.EnvironmentClient/SAIF.NetCore.EnvironmentClient/SAIF.NetCore.EnvironmentClient.csproj
• src/SAIF.NetCore.EnvironmentClient/SAIF.NetCore.EnvironmentClient/SAIF.NetCore.EnvironmentClient/BaseEnvironmentClient.cs
• src/SAIF.NetCore.EnvironmentClient/SAIF.NetCore.EnvironmentClient/SAIF.NetCore.EnvironmentClient/SecureEnvironmentClient.cs
• src/SAIF.NetCore.ServiceContracts/SAIF.NetCore.ServiceContracts/SAIF.NetCore.ServiceContracts/IEnvironmentClient.cs, ISystemHashService.cs, IHttpJsonClient.cs, IHttpRequestResult.cs