Class CloudflareForwardingOptions
Provides options for trusting the client address and scheme that Cloudflare forwards.
Namespace: Singulink.Net.Http.Api.Service
Assembly: Singulink.Net.Http.Api.Service.Cloudflare.dll
Syntax
public sealed class CloudflareForwardingOptionsFields
| Name | Description |
|---|---|
| HttpClientName | The name of the HttpClient (see IHttpClientFactory) used to download Cloudflare's IP ranges, so the configuration of that named client applies to the downloads. |
Properties
| Name | Description |
|---|---|
| DownloadRanges | Gets or sets a value indicating whether Cloudflare's IP ranges are downloaded. Default is true. |
| DownloadTimeout | Gets or sets how long a download of the ranges may take before it is abandoned. This also bounds how long startup waits for the ranges. Default is 10 seconds. |
| InitialRetryInterval | Gets or sets how long to wait before trying again while no ranges are available, which is when they could not be loaded at startup. Default is 10 seconds. |
| RefreshInterval | Gets or sets how often Cloudflare's IP ranges are downloaded again after a successful download, or read again from SavedRangesPath when DownloadRanges is false. Default is 1 day. |
| RetryInterval | Gets or sets how long to wait before trying again after a download fails, or after reading the saved copy fails when DownloadRanges is false. RefreshInterval is used instead if it is shorter. Default is 5 minutes. |
| SavedRangesPath | Gets or sets the path of the file that Cloudflare's IP ranges are saved to after each download, and read from at startup when they cannot be downloaded. When DownloadRanges is false, the ranges are only read from this file. Relative paths are resolved against the application's content root. Required: the application fails to start if this is not set. |
| StaleWarningAge | Gets or sets how old the ranges in use can get before each failed download also logs a warning that they are out of date. Does not apply when DownloadRanges is false. Default is 7 days. |
| TrustedProxyNetworks | Gets the addresses and networks whose connections are trusted like connections from Cloudflare's IP ranges: their forwarded client address and
scheme are applied and their Cloudflare headers are kept. Each entry is an IP address (for example |