Skip to main content

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).