{"id":18248060,"url":"https://github.com/nanoninja/bulma","last_synced_at":"2025-07-22T10:37:20.029Z","repository":{"id":57497215,"uuid":"65480076","full_name":"nanoninja/bulma","owner":"nanoninja","description":"Implementation of Basic HTTP authentication middleware for Go language.","archived":false,"fork":false,"pushed_at":"2020-06-20T16:55:41.000Z","size":19,"stargazers_count":9,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-04T15:39:59.741Z","etag":null,"topics":["auth","authentication","basic","bulma","go","godev","godoc","golang","handler","http","middleware","module","package"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nanoninja.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}},"created_at":"2016-08-11T15:22:51.000Z","updated_at":"2022-02-17T09:29:43.000Z","dependencies_parsed_at":"2022-09-03T23:50:34.096Z","dependency_job_id":null,"html_url":"https://github.com/nanoninja/bulma","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/nanoninja/bulma","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nanoninja%2Fbulma","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nanoninja%2Fbulma/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nanoninja%2Fbulma/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nanoninja%2Fbulma/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nanoninja","download_url":"https://codeload.github.com/nanoninja/bulma/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nanoninja%2Fbulma/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266477152,"owners_count":23935390,"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","status":"online","status_checked_at":"2025-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["auth","authentication","basic","bulma","go","godev","godoc","golang","handler","http","middleware","module","package"],"created_at":"2024-11-05T09:35:26.592Z","updated_at":"2025-07-22T10:37:20.000Z","avatar_url":"https://github.com/nanoninja.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bulma\n\nBasic authentication implementation for Go.\n\n[![golang](https://img.shields.io/badge/go-lang-%2347cafa.svg)](https://golang.org/) [![license](https://img.shields.io/badge/license-BSD%203--Clause-blue.svg)](https://github.com/nanoninja/bulma/blob/master/LICENSE) [![tag](https://img.shields.io/github/tag/nanoninja/bulma.svg)](https://github.com/nanoninja/bulma/tags)\n[![godoc](https://godoc.org/github.com/nanoninja/bulma?status.svg)](https://pkg.go.dev/github.com/nanoninja/bulma?tab=doc) [![build status](https://travis-ci.org/nanoninja/bulma.svg)](https://travis-ci.org/nanoninja/bulma) [![coverage status](https://coveralls.io/repos/github/nanoninja/bulma/badge.svg?branch=master)](https://coveralls.io/github/nanoninja/bulma?branch=master) [![go report card](https://goreportcard.com/badge/github.com/nanoninja/bulma)](https://goreportcard.com/report/github.com/nanoninja/bulma) [![codebeat](https://codebeat.co/badges/58e89ce4-2fd8-4a93-b624-afdbbb44a6e3)](https://codebeat.co/projects/github-com-nanoninja-bulma)\n\n## Installation\n\n```sh\ngo get github.com/nanoninja/bulma\n```\n\n## Getting started\nAfter installing Go and setting up your\n[GOPATH](http://golang.org/doc/code.html#GOPATH), create your first `.go` file.\n\n```go\npackage main\n\nimport (\n    \"fmt\"\n    \"net/http\"\n\n    \"github.com/nanoninja/bulma\"\n)\n\nfunc main() {\n    onSuccess := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {\n        fmt.Fprintf(w, \"Dashboard\")\n    })\n\n    ba := bulma.BasicAuth(bulma.Realm, onSuccess, bulma.User{\n        \"foo\": \"bar\",\n        \"bar\": \"foo\",\n    })\n\n    http.Handle(\"/admin\", ba)\n    http.ListenAndServe(\":3000\", nil)\n}\n```\n\n## Using a function as validator\n\n```go\nfunc main() {\n    onSuccess := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {\n        fmt.Fprintf(w, \"Dashboard\")\n    })\n\n    validator := bulma.ValidateFunc(func(c *bulma.Credential) bool {\n        return c.Authorization \u0026\u0026 c.Username == \"foo\" \u0026\u0026 c.Password == \"bar\"\n    })\n\n    ba := bulma.BasicAuth(bulma.Realm, onSuccess, validator)\n\n    http.Handle(\"/admin\", ba)\n    http.ListenAndServe(\":3000\", nil)\n}\n```\n\n## Using configuration\nThe configuration allows you to set up HTTP authentication.\n\n```go\ntype Config struct {\n    Realm string\n    Validator Validator\n    Success http.Handler\n    Error http.Handler\n}\n```\n\nExample :\n\n```go\nfunc main() {\n    onSuccess := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {\n        fmt.Fprintf(w, \"Dashboard\")\n    })\n\n    onError := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {\n        fmt.Fprintf(w, \"My Custom Error Handler\")\n    })\n\n    ba := bulma.New(\u0026bulma.Config{\n        Realm:     \"MyRealm\",\n        Validator: bulma.Auth(\"foo\", \"bar\"),\n        Success:   onSuccess,\n        Error:     onError,\n    })\n\n    http.Handle(\"/admin\", ba)\n    http.ListenAndServe(\":3000\", nil)\n}\n```\n\n## Creating Validator\nTo create a validator, use bulma.Validator interface.\n\n```go\ntype Validator interface {\n    Validate(*Credential) bool\n}\n```\n\nExample :\n\n```go\ntype MyValidator struct {\n    username, password string\n}\n\nfunc (v MyValidator) Validate(c *bulma.Credential) bool {\n    return c.Authorization \u0026\u0026 v.username == c.Username \u0026\u0026 v.password == c.Password\n}\n```\n\nUsing your own validator\n\n```go\nfunc main() {\n    onSuccess := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {\n        fmt.Fprintf(w, \"Dashboard\")\n    })\n\n    ba := bulma.BasicAuth(\"MyRealm\", onSuccess, MyValidator{\"foo\", \"bar\"})\n\n    http.Handle(\"/admin\", ba)\n    http.ListenAndServe(\":3000\", nil)\n}\n```\n\n## License\n\nBulma is licensed under the Creative Commons Attribution 3.0 License, and code is licensed under a [BSD license](https://github.com/nanoninja/bulma/blob/master/LICENSE).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnanoninja%2Fbulma","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnanoninja%2Fbulma","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnanoninja%2Fbulma/lists"}