acl.py
329 lines
| 10.5 KiB
| text/x-python
|
PythonLexer
/ hgext / acl.py
|
r2344 | # acl.py - changeset access control for mercurial | ||
# | ||||
# Copyright 2006 Vadim Gelfer <vadim.gelfer@gmail.com> | ||||
# | ||||
|
r8225 | # This software may be used and distributed according to the terms of the | ||
|
r10263 | # GNU General Public License version 2 or any later version. | ||
|
r8873 | |||
|
r8935 | '''hooks for controlling repository access | ||
|
r8873 | |||
|
r11095 | This hook makes it possible to allow or deny write access to given | ||
branches and paths of a repository when receiving incoming changesets | ||||
via pretxnchangegroup and pretxncommit. | ||||
|
r9250 | |||
The authorization is matched based on the local user name on the | ||||
system where the hook runs, and not the committer of the original | ||||
changeset (since the latter is merely informative). | ||||
|
r8873 | |||
|
r9250 | The acl hook is best used along with a restricted shell like hgsh, | ||
|
r11095 | preventing authenticating users from doing anything other than pushing | ||
or pulling. The hook is not safe to use if users have interactive | ||||
shell access, as they can then disable the hook. Nor is it safe if | ||||
remote users share an account, because then there is no way to | ||||
distinguish them. | ||||
|
r8873 | |||
|
r11092 | The order in which access checks are performed is: | ||
|
r11094 | |||
1) Deny list for branches (section ``acl.deny.branches``) | ||||
2) Allow list for branches (section ``acl.allow.branches``) | ||||
3) Deny list for paths (section ``acl.deny``) | ||||
4) Allow list for paths (section ``acl.allow``) | ||||
|
r11042 | |||
|
r11092 | The allow and deny sections take key-value pairs. | ||
|
r11094 | Branch-based Access Control | ||
|
r17267 | --------------------------- | ||
|
r11092 | |||
|
r11095 | Use the ``acl.deny.branches`` and ``acl.allow.branches`` sections to | ||
have branch-based access control. Keys in these sections can be | ||||
either: | ||||
|
r11057 | |||
|
r11095 | - a branch name, or | ||
- an asterisk, to match any branch; | ||||
|
r11092 | |||
The corresponding values can be either: | ||||
|
r11094 | |||
|
r11095 | - a comma-separated list containing users and groups, or | ||
- an asterisk, to match anyone; | ||||
|
r11042 | |||
|
r16957 | You can add the "!" prefix to a user or group name to invert the sense | ||
of the match. | ||||
|
r11094 | Path-based Access Control | ||
|
r17267 | ------------------------- | ||
|
r11092 | |||
|
r11095 | Use the ``acl.deny`` and ``acl.allow`` sections to have path-based | ||
access control. Keys in these sections accept a subtree pattern (with | ||||
a glob syntax by default). The corresponding values follow the same | ||||
syntax as the other sections above. | ||||
|
r11092 | |||
|
r11094 | Groups | ||
|
r17267 | ------ | ||
|
r11092 | |||
|
r11095 | Group names must be prefixed with an ``@`` symbol. Specifying a group | ||
name has the same effect as specifying all the users in that group. | ||||
|
r8873 | |||
|
r11115 | You can define group members in the ``acl.groups`` section. | ||
If a group name is not defined there, and Mercurial is running under | ||||
a Unix-like system, the list of users will be taken from the OS. | ||||
Otherwise, an exception will be raised. | ||||
|
r11094 | Example Configuration | ||
|
r17267 | --------------------- | ||
|
r11094 | |||
:: | ||||
|
r8873 | |||
[hooks] | ||||
|
r11042 | |||
|
r11092 | # Use this if you want to check access restrictions at commit time | ||
|
r11042 | pretxncommit.acl = python:hgext.acl.hook | ||
|
r11423 | |||
|
r11095 | # Use this if you want to check access restrictions for pull, push, | ||
# bundle and serve. | ||||
|
r8873 | pretxnchangegroup.acl = python:hgext.acl.hook | ||
[acl] | ||||
|
r11131 | # Allow or deny access for incoming changes only if their source is | ||
# listed here, let them pass otherwise. Source is "serve" for all | ||||
# remote access (http or ssh), "push", "pull" or "bundle" when the | ||||
# related commands are run locally. | ||||
# Default: serve | ||||
|
r8893 | sources = serve | ||
|
r8873 | |||
|
r11423 | [acl.deny.branches] | ||
# Everyone is denied to the frozen branch: | ||||
frozen-branch = * | ||||
# A bad user is denied on all branches: | ||||
* = bad-user | ||||
[acl.allow.branches] | ||||
# A few users are allowed on branch-a: | ||||
branch-a = user-1, user-2, user-3 | ||||
# Only one user is allowed on branch-b: | ||||
branch-b = user-1 | ||||
# The super user is allowed on any branch: | ||||
* = super-user | ||||
# Everyone is allowed on branch-for-tests: | ||||
branch-for-tests = * | ||||
|
r11092 | |||
|
r11042 | [acl.deny] | ||
|
r11095 | # This list is checked first. If a match is found, acl.allow is not | ||
# checked. All users are granted access if acl.deny is not present. | ||||
# Format for both lists: glob pattern = user, ..., @group, ... | ||||
|
r11042 | |||
# To match everyone, use an asterisk for the user: | ||||
# my/glob/pattern = * | ||||
# user6 will not have write access to any file: | ||||
** = user6 | ||||
# Group "hg-denied" will not have write access to any file: | ||||
** = @hg-denied | ||||
|
r17537 | # Nobody will be able to change "DONT-TOUCH-THIS.txt", despite | ||
|
r11095 | # everyone being able to change all other files. See below. | ||
|
r17537 | src/main/resources/DONT-TOUCH-THIS.txt = * | ||
|
r8873 | |||
[acl.allow] | ||||
|
r11131 | # if acl.allow is not present, all users are allowed by default | ||
|
r11042 | # empty acl.allow = no users allowed | ||
|
r11095 | # User "doc_writer" has write access to any file under the "docs" | ||
# folder: | ||||
|
r8873 | docs/** = doc_writer | ||
|
r11042 | |||
|
r11095 | # User "jack" and group "designers" have write access to any file | ||
# under the "images" folder: | ||||
|
r11042 | images/** = jack, @designers | ||
|
r16499 | # Everyone (except for "user6" and "@hg-denied" - see acl.deny above) | ||
# will have write access to any file under the "resources" folder | ||||
# (except for 1 file. See acl.deny): | ||||
|
r11042 | src/main/resources/** = * | ||
|
r8873 | .hgtags = release_engineer | ||
|
r16957 | Examples using the "!" prefix | ||
............................. | ||||
Suppose there's a branch that only a given user (or group) should be able to | ||||
push to, and you don't want to restrict access to any other branch that may | ||||
be created. | ||||
The "!" prefix allows you to prevent anyone except a given user or group to | ||||
push changesets in a given branch or path. | ||||
In the examples below, we will: | ||||
1) Deny access to branch "ring" to anyone but user "gollum" | ||||
2) Deny access to branch "lake" to anyone but members of the group "hobbit" | ||||
3) Deny access to a file to anyone but user "gollum" | ||||
:: | ||||
[acl.allow.branches] | ||||
# Empty | ||||
[acl.deny.branches] | ||||
# 1) only 'gollum' can commit to branch 'ring'; | ||||
# 'gollum' and anyone else can still commit to any other branch. | ||||
ring = !gollum | ||||
# 2) only members of the group 'hobbit' can commit to branch 'lake'; | ||||
# 'hobbit' members and anyone else can still commit to any other branch. | ||||
lake = !@hobbit | ||||
# You can also deny access based on file paths: | ||||
[acl.allow] | ||||
# Empty | ||||
[acl.deny] | ||||
# 3) only 'gollum' can change the file below; | ||||
# 'gollum' and anyone else can still change any other file. | ||||
/misty/mountains/cave/ring = !gollum | ||||
|
r8873 | ''' | ||
|
r2344 | |||
|
r28089 | from __future__ import absolute_import | ||
import getpass | ||||
import urllib | ||||
|
r3891 | from mercurial.i18n import _ | ||
|
r28089 | from mercurial import ( | ||
error, | ||||
match, | ||||
util, | ||||
) | ||||
|
r11041 | |||
|
r25186 | # Note for extension authors: ONLY specify testedwith = 'internal' for | ||
# extensions which SHIP WITH MERCURIAL. Non-mainline extensions should | ||||
# be specifying the version(s) of Mercurial they are tested with, or | ||||
# leave the attribute unspecified. | ||||
|
r16743 | testedwith = 'internal' | ||
|
r11114 | def _getusers(ui, group): | ||
# First, try to use group definition from section [acl.groups] | ||||
hgrcusers = ui.configlist('acl.groups', group) | ||||
if hgrcusers: | ||||
return hgrcusers | ||||
ui.debug('acl: "%s" not defined in [acl.groups]\n' % group) | ||||
# If no users found in group definition, get users from OS-level group | ||||
|
r11140 | try: | ||
return util.groupmembers(group) | ||||
except KeyError: | ||||
|
r26587 | raise error.Abort(_("group '%s' is undefined") % group) | ||
|
r11041 | |||
|
r11114 | def _usermatch(ui, user, usersorgroups): | ||
|
r11041 | |||
if usersorgroups == '*': | ||||
return True | ||||
for ug in usersorgroups.replace(',', ' ').split(): | ||||
|
r16956 | |||
if ug.startswith('!'): | ||||
# Test for excluded user or group. Format: | ||||
# if ug is a user name: !username | ||||
# if ug is a group name: !@groupname | ||||
ug = ug[1:] | ||||
if not ug.startswith('@') and user != ug \ | ||||
or ug.startswith('@') and user not in _getusers(ui, ug[1:]): | ||||
return True | ||||
# Test for user or group. Format: | ||||
# if ug is a user name: username | ||||
# if ug is a group name: @groupname | ||||
elif user == ug \ | ||||
or ug.startswith('@') and user in _getusers(ui, ug[1:]): | ||||
|
r11041 | return True | ||
return False | ||||
|
r2344 | |||
|
r6766 | def buildmatch(ui, repo, user, key): | ||
'''return tuple of (match function, list enabled).''' | ||||
if not ui.has_section(key): | ||||
|
r9467 | ui.debug('acl: %s not enabled\n' % key) | ||
|
r6766 | return None | ||
|
r2344 | |||
|
r6766 | pats = [pat for pat, users in ui.configitems(key) | ||
|
r11114 | if _usermatch(ui, user, users)] | ||
|
r9467 | ui.debug('acl: %s enabled, %d entries for user %s\n' % | ||
|
r6766 | (key, len(pats), user)) | ||
|
r11092 | |||
|
r16765 | # Branch-based ACL | ||
|
r11092 | if not repo: | ||
if pats: | ||||
|
r16766 | # If there's an asterisk (meaning "any branch"), always return True; | ||
# Otherwise, test if b is in pats | ||||
if '*' in pats: | ||||
return util.always | ||||
return lambda b: b in pats | ||||
|
r16764 | return util.never | ||
|
r11092 | |||
|
r16765 | # Path-based ACL | ||
|
r6766 | if pats: | ||
|
r8567 | return match.match(repo.root, '', pats) | ||
|
r16767 | return util.never | ||
|
r2344 | |||
def hook(ui, repo, hooktype, node=None, source=None, **kwargs): | ||||
|
r10955 | if hooktype not in ['pretxnchangegroup', 'pretxncommit']: | ||
|
r26587 | raise error.Abort(_('config error - hook type "%s" cannot stop ' | ||
|
r10955 | 'incoming changesets nor commits') % hooktype) | ||
if (hooktype == 'pretxnchangegroup' and | ||||
source not in ui.config('acl', 'sources', 'serve').split()): | ||||
|
r9467 | ui.debug('acl: changes have source "%s" - skipping\n' % source) | ||
|
r2344 | return | ||
|
r8846 | user = None | ||
if source == 'serve' and 'url' in kwargs: | ||||
url = kwargs['url'].split(':') | ||||
if url[0] == 'remote' and url[1].startswith('http'): | ||||
|
r9018 | user = urllib.unquote(url[3]) | ||
|
r8846 | |||
if user is None: | ||||
user = getpass.getuser() | ||||
|
r15207 | ui.debug('acl: checking access for user "%s"\n' % user) | ||
|
r25792 | # deprecated config: acl.config | ||
|
r6766 | cfg = ui.config('acl', 'config') | ||
if cfg: | ||||
|
r19872 | ui.readconfig(cfg, sections=['acl.groups', 'acl.allow.branches', | ||
'acl.deny.branches', 'acl.allow', 'acl.deny']) | ||||
|
r11092 | |||
allowbranches = buildmatch(ui, None, user, 'acl.allow.branches') | ||||
denybranches = buildmatch(ui, None, user, 'acl.deny.branches') | ||||
|
r6766 | allow = buildmatch(ui, repo, user, 'acl.allow') | ||
deny = buildmatch(ui, repo, user, 'acl.deny') | ||||
for rev in xrange(repo[node], len(repo)): | ||||
ctx = repo[rev] | ||||
|
r11092 | branch = ctx.branch() | ||
if denybranches and denybranches(branch): | ||||
|
r26587 | raise error.Abort(_('acl: user "%s" denied on branch "%s"' | ||
|
r11092 | ' (changeset "%s")') | ||
% (user, branch, ctx)) | ||||
if allowbranches and not allowbranches(branch): | ||||
|
r26587 | raise error.Abort(_('acl: user "%s" not allowed on branch "%s"' | ||
|
r11092 | ' (changeset "%s")') | ||
% (user, branch, ctx)) | ||||
ui.debug('acl: branch access granted: "%s" on branch "%s"\n' | ||||
% (ctx, branch)) | ||||
|
r6766 | for f in ctx.files(): | ||
if deny and deny(f): | ||||
|
r26587 | raise error.Abort(_('acl: user "%s" denied on "%s"' | ||
|
r15207 | ' (changeset "%s")') % (user, f, ctx)) | ||
|
r6766 | if allow and not allow(f): | ||
|
r26587 | raise error.Abort(_('acl: user "%s" not allowed on "%s"' | ||
|
r15207 | ' (changeset "%s")') % (user, f, ctx)) | ||
ui.debug('acl: path access granted: "%s"\n' % ctx) | ||||