Added article about logging to elmah.io from .NET 4.5

elmahio · Oct 29, 2024 · 1602ea4 · 1602ea4
1 parent 90b10c8
commit 1602ea4
Show file tree

Hide file tree

Showing 2 changed files with 20 additions and 0 deletions.
diff --git a/docs/how-to-log-to-elmah-io-from-net-4-5.md b/docs/how-to-log-to-elmah-io-from-net-4-5.md
@@ -0,0 +1,19 @@
+---
+title: How to log to elmah.io from .NET 4.5
+description: Ensure your .NET 4.5 apps continue logging to elmah.io by enabling TLS 1.2 before Azure removes support for older protocols in August 2025.
+---
+
+# How to log to elmah.io from .NET 4.5
+
+elmah.io is being hosted on Microsoft Azure. Azure is getting ready to phase out support for security protocols lower than TLS 1.2. The support for earlier versions like SSL, TLS, and TLS 1.1 will be removed by 31 August 2025. This means that our API will not accept connections with settings lower than TLS 1.2 from that date.
+
+If you are running on .NET 4.6 or newer, you don't need to change anything since TLS 1.2 is the default from that version and forward. Since our clients don't support .NET versions earlier than .NET 4.5, this only leaves out .NET 4.5. So, if your application is running on .NET 4.5, you will need to do one of two things before August 2025 to continue logging errors to elmah.io:
+
+1. Upgrade your application to use a minimum of .NET 4.6 (recommended).
+2. Include the following code during startup in your application (like in the `Global.asax.cs` file for ASP.NET applications and `Program.cs` for other types of applications):
+
+```csharp
+ServicePointManager.SecurityProtocol |= SecurityProtocolType.Tls12;
+```
+
+This will include TLS 1.2 as a supported security protocol in your application.
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -215,6 +215,7 @@ nav:
     - Handle elmah.io downtime: handle-elmah-io-downtime.md
     - Using the elmah.io extension for Visual Studio: using-the-elmah-io-extension-for-visual-studio.md
     - Using the REST API: using-the-rest-api.md
+    - How to log to elmah.io from .NET 4.5: how-to-log-to-elmah-io-from-net-4-5.md
     - Upgrade elmah.io from v4 to v5: upgrade-elmah-io-from-v4-to-v5.md
     - Upgrade elmah.io from v3 to v4: upgrade-elmah-io-from-v3-to-v4.md
     - Upgrade elmah.io from v2 to v3: upgrade-elmah-io-from-v2-to-v3.md