thewizster/hanc

Useful for building new ASP.Net Core API microservices

HANC

Useful for building new ASP.Net Core API microservices

CLI Quickstart

This quickstart clones the HANC repo, builds, and runs the application

Tools you will need installed

• .NET Core https://www.microsoft.com/net/core
• GIT https://git-scm.com/downloads
• Postman https://www.getpostman.com/

1. Clone the HANC repo
   git clone https://github.com/thewizster/hanc.git

2. Change into the AspNetAPI folder
   cd hanc/AspNetAPI

3. Restore packages and build
   dotnet restore && dotnet build

4. Run the app
   dotnet run

Use Postman to test Hanc

5. Set postman to GET request for http://localhost:5000/api/hello

6. Set X-Hanc-Application-Id header in Postman request to some_key_value (see appsettings.json to change AppId)

7. Press send for the Postman GET request

What's Included

• SQL server support via entity framework
• Message authentication option - HMAC(SHA256)
• API request authorization via app id/api key middleware
• Uses options pattern and DI for appsettings access
• Allows extending API via shared dbcontext model and controller libraries

Roadmap

• Azure integrations: File storage, DocumentDB, Insights