{"id":19503556,"url":"https://github.com/hirre/api-in-a-box","last_synced_at":"2026-04-28T16:40:26.670Z","repository":{"id":91537098,"uuid":"322894733","full_name":"hirre/api-in-a-box","owner":"hirre","description":"API in a Box is a generic API back-end service ready to scale web development.","archived":false,"fork":false,"pushed_at":"2024-03-19T08:50:29.000Z","size":191,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-08T10:39:42.216Z","etag":null,"topics":["api","api-rest","asp-net-core","authorization","database","dotnet","dotnetcore","logging","net","server","service","software","tls","token-based-authentication","webapi"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hirre.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-12-19T16:53:22.000Z","updated_at":"2024-07-17T06:32:41.000Z","dependencies_parsed_at":"2024-03-19T09:48:15.493Z","dependency_job_id":"7718caa3-ca18-4c57-82eb-b3d6fee71227","html_url":"https://github.com/hirre/api-in-a-box","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hirre%2Fapi-in-a-box","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hirre%2Fapi-in-a-box/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hirre%2Fapi-in-a-box/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hirre%2Fapi-in-a-box/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hirre","download_url":"https://codeload.github.com/hirre/api-in-a-box/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240754295,"owners_count":19852186,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","api-rest","asp-net-core","authorization","database","dotnet","dotnetcore","logging","net","server","service","software","tls","token-based-authentication","webapi"],"created_at":"2024-11-10T22:22:08.521Z","updated_at":"2026-04-28T16:40:21.645Z","avatar_url":"https://github.com/hirre.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"./images/logo.png\" width=\"200\"\u003e\n\n# API in a Box\nThe goal of this project is to have a \"ready to go\" API back-end service with all necessary features in order to scale web development. \n\nFeatures include:\n- Token generation and validation \n- Authentication and authorization\n- ReCaptcha support\n- ORM EF Core + PostgreSql backend along with concurrency handling\n- API key registration\n- User registration and mail activation support\n- NodaTime support\n- HTTPS (TLS)\n- Logging (file and console) with Serilog\n- Works well with [Web App in a Box](https://github.com/hirre/webapp-in-a-box)\n- and more...\n\n## Create a self signed certificate\n\n1) Install [OpenSSL](https://www.openssl.org)\n\n2) Run and enter a key/certificate password along with other credentials:\n```\nopenssl req -x509 -newkey rsa:4096 -keyout privateKey.pem -out certificate.pem -days 10000\nopenssl pkcs12 -export -out ServerCertificate.pfx -inkey privateKey.pem -in certificate.pem\n```\n\nPut \"ServerCertificate.pfx\" (\"https_certificate\" field in \"src/ApiService/appsettings.json\") in the \"src/ApiService/\" folder (it will automatically be copied to the binary output folder). Set the \"https_certificate_password\" field to your password and change the token key to something unique and hard to guess.\n\n## PostgreSql\nDownload and install PostgreSql: https://www.postgresql.org/download/\n\nChange the connection string in \"src/ApiService/appsettings.json\" to your setup.\n\n## Reverse proxy\nIt is recommended to have Kestrel running behind a reverse proxy, e.g. Nginx.\n\nGuide: https://docs.microsoft.com/en-us/aspnet/core/fundamentals/servers/kestrel?view=aspnetcore-5.0#when-to-use-kestrel-with-a-reverse-proxy\n\n## More info\nhttps://docs.microsoft.com/en-us/aspnet/core/?view=aspnetcore-5.0\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhirre%2Fapi-in-a-box","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhirre%2Fapi-in-a-box","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhirre%2Fapi-in-a-box/lists"}