{"id":31710144,"url":"https://github.com/emqx/emqx-auth-username","last_synced_at":"2025-10-09T00:11:16.835Z","repository":{"id":54788382,"uuid":"70970505","full_name":"emqx/emqx-auth-username","owner":"emqx","description":"EMQX Authentication with Username and Password","archived":false,"fork":false,"pushed_at":"2023-12-27T07:39:38.000Z","size":219,"stargazers_count":18,"open_issues_count":2,"forks_count":23,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-09-29T22:58:33.380Z","etag":null,"topics":["authentication","emqx","emqx-plugin","username-authentication"],"latest_commit_sha":null,"homepage":"https://emqx.io","language":"Erlang","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/emqx.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-10-15T06:18:25.000Z","updated_at":"2024-09-03T16:29:07.000Z","dependencies_parsed_at":"2022-08-14T03:00:40.980Z","dependency_job_id":null,"html_url":"https://github.com/emqx/emqx-auth-username","commit_stats":null,"previous_names":[],"tags_count":100,"template":false,"template_full_name":null,"purl":"pkg:github/emqx/emqx-auth-username","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emqx%2Femqx-auth-username","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emqx%2Femqx-auth-username/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emqx%2Femqx-auth-username/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emqx%2Femqx-auth-username/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/emqx","download_url":"https://codeload.github.com/emqx/emqx-auth-username/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emqx%2Femqx-auth-username/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279000745,"owners_count":26082879,"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-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","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":["authentication","emqx","emqx-plugin","username-authentication"],"created_at":"2025-10-09T00:10:24.900Z","updated_at":"2025-10-09T00:11:16.830Z","avatar_url":"https://github.com/emqx.png","language":"Erlang","funding_links":[],"categories":[],"sub_categories":[],"readme":"emqx_auth_username\n==================\n\nEMQX Authentication with Username and Password\n\nBuild\n-----\n\n```\nmake \u0026\u0026 make tests\n```\n\nConfiguration\n-------------\n\netc/emqx_auth_username.conf:\n\n```\n## Password hash.\n##\n## Value: plain | md5 | sha | sha256 \nauth.user.password_hash = sha256\n```\n\n[REST API](https://developer.emqx.io/docs/emq/v3/en/rest.html)\n------------\n\nList all usernames\n```\n# Request\nGET api/v4/auth_username\n\n# Response\n{\n    \"code\": 0,\n    \"data\": [\"username1\"]\n}\n```\n\nAdd a username:\n```\n# Request\nPOST api/v4/auth_username\n{\n    \"username\": \"some_name\",\n    \"password\": \"password\"\n}\n\n# Response\n{\n    \"code\": 0\n}\n```\n\nUpdate password for a username:\n```\n# Request\nPUT api/v4/auth_username/$NAME\n{\n    \"password\": \"password\"\n}\n\n# Response\n{\n    \"code\", 0\n}\n```\n\nLookup a username info:\n```\n# Request\nGET api/v4/auth_username/$NAME\n\n# Response\n{\n    \"code\": 0,\n    \"data\": {\n        \"username\": \"some_username\",\n        \"password\": \"hashed_password\"\n    }\n}\n```\n\nDelete a username:\n```\n# Request\nDELETE api/v4/auth_username/$NAME\n\n# Response\n{\n    \"code\": 0\n}\n```\n\nLoad the Plugin\n---------------\n\n```\n./bin/emqx_ctl plugins load emqx_auth_username\n```\n\nLicense\n-------\n\nApache License Version 2.0\n\nAuthor\n------\n\nEMQX Team.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femqx%2Femqx-auth-username","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Femqx%2Femqx-auth-username","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femqx%2Femqx-auth-username/lists"}