Basic (C# / VB.NET)

Implement credential validation in C# and VB.NET while retaining PowerShell host scripts.

Full source

File: pwsh/tutorial/examples/8.2-Basic-MultiLang.ps1

<#
    Sample: Basic Authentication (C# and VB.NET)
    Purpose: Shows how to implement Basic authentication credential validation using inline C# and VB.NET code.
    File:    8.2-Basic-MultiLang.ps1
    Notes:   Demonstrates multi-language support for auth handlers.
#>
param(
    [int]$Port = 5000,
    [IPAddress]$IPAddress = [IPAddress]::Loopback
)
# 1. Logging pipeline
New-KrLogger | Add-KrSinkConsole | Register-KrLogger -Name 'console' -SetAsDefault | Out-Null

# 2. Create server
New-KrServer -Name 'Auth Basic Multi'

# 3. Listener
Add-KrEndpoint -Port $Port -IPAddress $IPAddress

# 4. PowerShell runtime


# 5. C# validation logic
Add-KrBasicAuthentication -Name 'CSharpBasic' -Realm 'CS' -AllowInsecureHttp -Code @'
    return username == "admin" && password == "password";
'@ -CodeLanguage CSharp

# 6. VB.NET validation logic
Add-KrBasicAuthentication -Name 'VBNetBasic' -Realm 'VB' -AllowInsecureHttp -Code @'
    Return username = "admin" AndAlso password = "password"
'@ -CodeLanguage VBNet

# 7. Finalize configuration
Enable-KrConfiguration

# 8. Map language-specific routes
Add-KrMapRoute -Verbs Get -Pattern '/secure/cs/hello' -AuthorizationSchema 'CSharpBasic' -ScriptBlock {
    Write-KrTextResponse -InputObject "CS Hello, $( $Context.User.Identity.Name )!" -ContentType 'text/plain'
}

Add-KrMapRoute -Verbs Get -Pattern '/secure/vb/hello' -AuthorizationSchema 'VBNetBasic' -ScriptBlock {
    Write-KrTextResponse -InputObject "VB Hello, $( $Context.User.Identity.Name )!" -ContentType 'text/plain'
}

# 9. Start server
Start-KrServer -CloseLogsOnExit

Step-by-step

  1. Create server & listener.
  2. Register two Basic schemes (CSharpBasic, VBNetBasic) via -Code and -CodeLanguage.
  3. Enable configuration.
  4. Map separate routes requiring each scheme.
  5. Start server.

Try it 

$b = 'Basic ' + [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes('admin:password'))
Invoke-WebRequest http://127.0.0.1:5000/secure/cs/hello -Headers @{Authorization=$b} | Select -Expand Content
Invoke-WebRequest http://127.0.0.1:5000/secure/vb/hello -Headers @{Authorization=$b} | Select -Expand Content

References

Troubleshooting

Symptom Cause Fix
401 on VB/C# only Scheme name mismatch Match -AuthorizationSchema to -Name
Code errors Syntax issue in inline code Validate language snippet compiles

Previous / Next