Tutorial: Set Up a Csharp Client with TideCloak on IIS

Deploy your ASP.NET Core TideCloak app on IIS.

---

1) Install prerequisites

• IIS Windows feature
• ASP.NET Core Hosting Bundle (matching your .NET runtime)

2) Create project & configure auth

Follow the ASP.NET Core tutorial first and confirm it runs locally.

3) launchSettings.json for local dev

{
  "iisSettings": {
  "windowsAuthentication": false,
  "anonymousAuthentication": true,
  "iisExpress": {
    "applicationUrl": "http://localhost:5000",
    "sslPort": 44300
    }
  },
  "profiles": {
    "IIS Express": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "environmentVariables": { "ASPNETCORE_ENVIRONMENT": "Development" }
      },
    "MyTideCloakApp": {
      "commandName": "Project",
      "launchBrowser": true,
      "applicationUrl": "http://localhost:8000",
      "environmentVariables": { "ASPNETCORE_ENVIRONMENT": "Development" }
      }
    }
  }

4) Publish and configure site

dotnet publish -c Release -o ./publish

• In IIS Manager → Sites → Add Website...
• Physical path: the publish folder
• Binding: choose a port/host (e.g., http://localhost:8000)
• Ensure your TideCloak client lists the callback http://localhost:8000/signin-oidc

5) Test

Browse the site, click Login, and complete the flow. Check Windows Event Log if the app doesn't start (missing hosting bundle is the most common issue).