Noundry.AuthnzNet.CLI 1.9.0

AuthnzNet

Local OAuth 2.0 / OpenID Connect server for development.

Stop wasting time setting up IdentityServer or waiting for cloud IdP trial approvals. Get OAuth working in your app in under 60 seconds.

Quick Start

# Install the CLI
dotnet tool install -g Noundry.AuthnzNet.CLI

# Create everything you need in one command
ndaz quickstart

# Start the server
ndaz serve

That's it. Your app now has OAuth.

What You Get

After ndaz quickstart:

OAuth Configuration
┌───────────────┬─────────────────────────────────────────────┐
│ Authority     │ https://localhost:5000                      │
│ Client ID     │ client_4d47e486494d4ab68                    │
│ Client Secret │ 1IHI0Wvw1cQQuEJAnsNciWR1mTSfxWJY            │
│ Login URL     │ https://localhost:5000/login/local-dev-4f31 │
└───────────────┴─────────────────────────────────────────────┘

Test User
┌──────────┬───────────────┐
│ Email    │ dev@localhost │
│ Password │ Password123!  │
└──────────┴───────────────┘

Configure Your App

ASP.NET Core

builder.Services.AddAuthentication(options =>
{
    options.DefaultScheme = "Cookies";
    options.DefaultChallengeScheme = "oidc";
})
.AddCookie("Cookies")
.AddOpenIdConnect("oidc", options =>
{
    options.Authority = "https://localhost:5000";
    options.ClientId = "YOUR_CLIENT_ID";
    options.ClientSecret = "YOUR_CLIENT_SECRET";
    options.ResponseType = "code";
    options.SaveTokens = true;
    options.Scope.Add("openid");
    options.Scope.Add("profile");
    options.Scope.Add("email");
});

React / SPA (PKCE)

const config = {
  authority: "https://localhost:5000",
  client_id: "YOUR_CLIENT_ID",
  redirect_uri: "http://localhost:3000/callback",
  response_type: "code",
  scope: "openid profile email",
};

appsettings.json

{
  "Authentication": {
    "Authority": "https://localhost:5000",
    "ClientId": "YOUR_CLIENT_ID",
    "ClientSecret": "YOUR_CLIENT_SECRET"
  }
}

OAuth Endpoints

Supported Flows

• Authorization Code (with PKCE)
• Client Credentials
• Refresh Token
• Resource Owner Password

CLI Commands

ndaz quickstart              # Create tenant + client + user
ndaz serve                   # Start server
ndaz serve --port 8080       # Custom port
ndaz tenant register <email> <name>  # New tenant
ndaz client create <tenant-id>       # New OAuth client
ndaz user create <tenant-id> <email> <password>  # New user

Dashboard

Visit https://localhost:5000/dashboard to manage tenants, users, and clients.

Switching to Production

When ready for production, change one line:

// Development
options.Authority = "https://localhost:5000";

// Production
options.Authority = "https://login.microsoftonline.com/...";  // Azure AD
// or
options.Authority = "https://your-tenant.auth0.com";          // Auth0
// or
options.Authority = "https://accounts.google.com";            // Google

No other code changes needed.

Why AuthnzNet?

Project Structure

AuthnzNet/
├── src/
│   ├── AuthnzNet.Core/      # Shared models & interfaces
│   ├── AuthnzNet.Cli/       # CLI tool (ndaz)
│   └── AuthnzNet.Server/    # OAuth server (single process, SQLite)
├── tests/
│   ├── AuthnzNet.Core.Tests/
│   └── AuthnzNet.Cli.Tests/
└── cloud/                   # (Future cloud service code)

Requirements

• .NET 9.0 SDK or .NET 10.0 SDK

License

MIT