## buildbot-netauth
NetAuth authentication, user info, and avatar plugin for buildbot
### Usage
1. Install the plugin, for example: `pip install buildbot-netauth`
2. In your `buildmaster.cfg`, add:
```py
from buildbot.plugins import util
netauth = util.BuildbotNetAuth(conf=Path("/etc/netauth/config.toml"))
# in your buildmaster config object
c["www"]["auth"] = netauth
c["www"]["avatar_methods"] = [netauth, ...]
```
### Notes
The plugin looks at the following metadata on NetAuth entities:
- entity ID: used as an "email" in the format `entity_id@domain`. `domain` is the base domain of the NetAuth server, but is overridable.
- entity display name or legal name: if set, will be used for the `full_name` buildbot user property in that fallback order
- entity group membership: used for the `groups` buildbot user property and can be used for buildbot authz, for example:
```py
from buildbot.plugins import util
c["www"]["authz"] = util.Authz(
allowRules=[
util.AnyEndpointMatcher(role="ops", defaultDeny=False),
util.AnyControlEndpointMatcher(role="ops"),
],
roleMatchers=[
util.RolesFromGroups(groupPrefix="build-"),
]
)
```
Raw data
{
"_id": null,
"home_page": null,
"name": "buildbot-netauth",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "secure-access, authentication-service, netauth, buildbot",
"author": null,
"author_email": "classabbyamp <dev@placeviolette.net>",
"download_url": "https://files.pythonhosted.org/packages/c3/f2/04de2ec38eee928467cd3739605251d3d142cc6f133618b7d2a2723cce1c/buildbot_netauth-0.1.1.tar.gz",
"platform": null,
"description": "## buildbot-netauth\n\nNetAuth authentication, user info, and avatar plugin for buildbot\n\n### Usage\n\n1. Install the plugin, for example: `pip install buildbot-netauth`\n\n2. In your `buildmaster.cfg`, add:\n\n```py\nfrom buildbot.plugins import util\n\nnetauth = util.BuildbotNetAuth(conf=Path(\"/etc/netauth/config.toml\"))\n\n# in your buildmaster config object\nc[\"www\"][\"auth\"] = netauth\nc[\"www\"][\"avatar_methods\"] = [netauth, ...]\n```\n\n### Notes\n\nThe plugin looks at the following metadata on NetAuth entities:\n\n- entity ID: used as an \"email\" in the format `entity_id@domain`. `domain` is the base domain of the NetAuth server, but is overridable.\n- entity display name or legal name: if set, will be used for the `full_name` buildbot user property in that fallback order\n- entity group membership: used for the `groups` buildbot user property and can be used for buildbot authz, for example:\n\n```py\nfrom buildbot.plugins import util\n\nc[\"www\"][\"authz\"] = util.Authz(\n allowRules=[\n util.AnyEndpointMatcher(role=\"ops\", defaultDeny=False),\n util.AnyControlEndpointMatcher(role=\"ops\"),\n ],\n roleMatchers=[\n util.RolesFromGroups(groupPrefix=\"build-\"),\n ]\n)\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "buildbot plugin for integration with NetAuth",
"version": "0.1.1",
"project_urls": {
"Changelog": "https://github.com/classabbyamp/buildbot-netauth/blob/master/CHANGELOG.md",
"Repository": "https://github.com/classabbyamp/buildbot-netauth"
},
"split_keywords": [
"secure-access",
" authentication-service",
" netauth",
" buildbot"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "95d19ed16b107f0779cf63184382f2eaa8454755d5d48f8abf237fff19c2536b",
"md5": "07b310a257f2fe0ea69d095e50361986",
"sha256": "a75f5fa2354453b8cbf6a572b20faf219cac8646c837c99d76430699a5aed5fb"
},
"downloads": -1,
"filename": "buildbot_netauth-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "07b310a257f2fe0ea69d095e50361986",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 4288,
"upload_time": "2024-12-14T23:31:00",
"upload_time_iso_8601": "2024-12-14T23:31:00.637579Z",
"url": "https://files.pythonhosted.org/packages/95/d1/9ed16b107f0779cf63184382f2eaa8454755d5d48f8abf237fff19c2536b/buildbot_netauth-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c3f204de2ec38eee928467cd3739605251d3d142cc6f133618b7d2a2723cce1c",
"md5": "a586cde31c55500aa043ae84640d9b09",
"sha256": "817f4eb05c6130ae19851a95692ccd8fafa2702cbe069fd725eb55136ac8897e"
},
"downloads": -1,
"filename": "buildbot_netauth-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "a586cde31c55500aa043ae84640d9b09",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 45690,
"upload_time": "2024-12-14T23:31:02",
"upload_time_iso_8601": "2024-12-14T23:31:02.724766Z",
"url": "https://files.pythonhosted.org/packages/c3/f2/04de2ec38eee928467cd3739605251d3d142cc6f133618b7d2a2723cce1c/buildbot_netauth-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-14 23:31:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "classabbyamp",
"github_project": "buildbot-netauth",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "buildbot-netauth"
}
JSON
