mirror of
https://github.com/Mailu/Mailu.git
synced 2024-12-14 10:53:30 +02:00
484 lines
16 KiB
Python
484 lines
16 KiB
Python
""" Mailu command line interface
|
|
"""
|
|
|
|
import sys
|
|
import os
|
|
import socket
|
|
import uuid
|
|
|
|
import click
|
|
import yaml
|
|
|
|
from flask import current_app as app
|
|
from flask.cli import FlaskGroup, with_appcontext
|
|
|
|
from mailu import models
|
|
from mailu.schemas import MailuSchema, Logger, RenderJSON
|
|
|
|
|
|
db = models.db
|
|
|
|
|
|
@click.group(cls=FlaskGroup, context_settings={'help_option_names': ['-?', '-h', '--help']})
|
|
def mailu():
|
|
""" Mailu command line
|
|
"""
|
|
|
|
|
|
@mailu.command()
|
|
@with_appcontext
|
|
def advertise():
|
|
""" Advertise this server against statistic services.
|
|
"""
|
|
if os.path.isfile(app.config['INSTANCE_ID_PATH']):
|
|
with open(app.config['INSTANCE_ID_PATH'], 'r') as handle:
|
|
instance_id = handle.read()
|
|
else:
|
|
instance_id = str(uuid.uuid4())
|
|
with open(app.config['INSTANCE_ID_PATH'], 'w') as handle:
|
|
handle.write(instance_id)
|
|
if not app.config['DISABLE_STATISTICS']:
|
|
try:
|
|
socket.gethostbyname(app.config['STATS_ENDPOINT'].format(instance_id))
|
|
except OSError:
|
|
pass
|
|
|
|
|
|
@mailu.command()
|
|
@click.argument('localpart')
|
|
@click.argument('domain_name')
|
|
@click.argument('password')
|
|
@click.option('-m', '--mode', default='create', metavar='MODE', help='''\b'create' (default): create user. it's an error if user already exists
|
|
'ifmissing': only update password if user is missing
|
|
'update': create user or update password if user exists
|
|
''')
|
|
@with_appcontext
|
|
def admin(localpart, domain_name, password, mode):
|
|
""" Create an admin user
|
|
"""
|
|
|
|
if not mode in ('create', 'update', 'ifmissing'):
|
|
raise click.ClickException(f'invalid mode: {mode!r}')
|
|
|
|
domain = models.Domain.query.get(domain_name)
|
|
if not domain:
|
|
domain = models.Domain(name=domain_name)
|
|
db.session.add(domain)
|
|
|
|
email = f'{localpart}@{domain_name}'
|
|
if user := models.User.query.get(email):
|
|
if mode == 'ifmissing':
|
|
print(f'user {email!r} exists, not updating')
|
|
return
|
|
elif mode == 'update':
|
|
user.set_password(password)
|
|
db.session.commit()
|
|
print("updated admin password")
|
|
else:
|
|
raise click.ClickException(f'user {email!r} exists, not created')
|
|
else:
|
|
user = models.User(
|
|
localpart=localpart,
|
|
domain=domain,
|
|
global_admin=True
|
|
)
|
|
db.session.add(user)
|
|
user.set_password(password)
|
|
db.session.commit()
|
|
print("created admin user")
|
|
|
|
|
|
@mailu.command()
|
|
@click.argument('localpart')
|
|
@click.argument('domain_name')
|
|
@click.argument('password')
|
|
@with_appcontext
|
|
def user(localpart, domain_name, password):
|
|
""" Create a user
|
|
"""
|
|
domain = models.Domain.query.get(domain_name)
|
|
if not domain:
|
|
domain = models.Domain(name=domain_name)
|
|
db.session.add(domain)
|
|
user = models.User(
|
|
localpart=localpart,
|
|
domain=domain,
|
|
global_admin=False,
|
|
change_pw_next_login=True,
|
|
)
|
|
user.set_password(password)
|
|
db.session.add(user)
|
|
db.session.commit()
|
|
|
|
|
|
@mailu.command()
|
|
@click.argument('localpart')
|
|
@click.argument('domain_name')
|
|
@click.argument('password')
|
|
@with_appcontext
|
|
def password(localpart, domain_name, password):
|
|
""" Change the password of an user
|
|
"""
|
|
email = f'{localpart}@{domain_name}'
|
|
user = models.User.query.get(email)
|
|
if user:
|
|
user.set_password(password, keep_only_session='')
|
|
user.change_pw_next_login=True
|
|
else:
|
|
print(f'User {email} not found.')
|
|
db.session.commit()
|
|
|
|
|
|
@mailu.command()
|
|
@click.argument('domain_name')
|
|
@click.option('-u', '--max-users')
|
|
@click.option('-a', '--max-aliases')
|
|
@click.option('-q', '--max-quota-bytes')
|
|
@with_appcontext
|
|
def domain(domain_name, max_users=-1, max_aliases=-1, max_quota_bytes=0):
|
|
""" Create a domain
|
|
"""
|
|
domain = models.Domain.query.get(domain_name)
|
|
if not domain:
|
|
domain = models.Domain(name=domain_name, max_users=max_users,
|
|
max_aliases=max_aliases, max_quota_bytes=max_quota_bytes)
|
|
db.session.add(domain)
|
|
db.session.commit()
|
|
|
|
|
|
@mailu.command()
|
|
@click.argument('localpart')
|
|
@click.argument('domain_name')
|
|
@click.argument('password_hash')
|
|
@with_appcontext
|
|
def user_import(localpart, domain_name, password_hash):
|
|
""" Import a user along with password hash
|
|
"""
|
|
domain = models.Domain.query.get(domain_name)
|
|
if not domain:
|
|
domain = models.Domain(name=domain_name)
|
|
db.session.add(domain)
|
|
user = models.User(
|
|
localpart=localpart,
|
|
domain=domain,
|
|
global_admin=False
|
|
)
|
|
user.set_password(password_hash, raw=True)
|
|
db.session.add(user)
|
|
db.session.commit()
|
|
|
|
|
|
# TODO: remove deprecated config_update function?
|
|
@mailu.command()
|
|
@click.option('-v', '--verbose')
|
|
@click.option('-d', '--delete-objects')
|
|
@with_appcontext
|
|
def config_update(verbose=False, delete_objects=False):
|
|
""" Sync configuration with data from YAML (deprecated)
|
|
"""
|
|
new_config = yaml.safe_load(sys.stdin)
|
|
# print new_config
|
|
domains = new_config.get('domains', [])
|
|
tracked_domains = set()
|
|
for domain_config in domains:
|
|
if verbose:
|
|
print(str(domain_config))
|
|
domain_name = domain_config['name']
|
|
max_users = domain_config.get('max_users', -1)
|
|
max_aliases = domain_config.get('max_aliases', -1)
|
|
max_quota_bytes = domain_config.get('max_quota_bytes', 0)
|
|
tracked_domains.add(domain_name)
|
|
domain = models.Domain.query.get(domain_name)
|
|
if not domain:
|
|
domain = models.Domain(name=domain_name,
|
|
max_users=max_users,
|
|
max_aliases=max_aliases,
|
|
max_quota_bytes=max_quota_bytes)
|
|
db.session.add(domain)
|
|
print(f'Added {domain_config}')
|
|
else:
|
|
domain.max_users = max_users
|
|
domain.max_aliases = max_aliases
|
|
domain.max_quota_bytes = max_quota_bytes
|
|
db.session.add(domain)
|
|
print(f'Updated {domain_config}')
|
|
|
|
users = new_config.get('users', [])
|
|
tracked_users = set()
|
|
user_optional_params = ('comment', 'quota_bytes', 'global_admin',
|
|
'enable_imap', 'enable_pop', 'forward_enabled',
|
|
'forward_destination', 'reply_enabled',
|
|
'reply_subject', 'reply_body', 'displayed_name',
|
|
'spam_enabled', 'spam_mark_as_read', 'email', 'spam_threshold')
|
|
for user_config in users:
|
|
if verbose:
|
|
print(str(user_config))
|
|
localpart = user_config['localpart']
|
|
domain_name = user_config['domain']
|
|
password_hash = user_config.get('password_hash', None)
|
|
domain = models.Domain.query.get(domain_name)
|
|
email = f'{localpart}@{domain_name}'
|
|
optional_params = {}
|
|
for k in user_optional_params:
|
|
if k in user_config:
|
|
optional_params[k] = user_config[k]
|
|
if not domain:
|
|
domain = models.Domain(name=domain_name)
|
|
db.session.add(domain)
|
|
user = models.User.query.get(email)
|
|
tracked_users.add(email)
|
|
tracked_domains.add(domain_name)
|
|
if not user:
|
|
user = models.User(
|
|
localpart=localpart,
|
|
domain=domain,
|
|
**optional_params
|
|
)
|
|
else:
|
|
for k in optional_params:
|
|
setattr(user, k, optional_params[k])
|
|
user.set_password(password_hash, raw=True)
|
|
db.session.add(user)
|
|
|
|
aliases = new_config.get('aliases', [])
|
|
tracked_aliases = set()
|
|
for alias_config in aliases:
|
|
if verbose:
|
|
print(str(alias_config))
|
|
localpart = alias_config['localpart']
|
|
domain_name = alias_config['domain']
|
|
if isinstance(alias_config['destination'], str):
|
|
destination = alias_config['destination'].split(',')
|
|
else:
|
|
destination = alias_config['destination']
|
|
wildcard = alias_config.get('wildcard', False)
|
|
domain = models.Domain.query.get(domain_name)
|
|
email = f'{localpart}@{domain_name}'
|
|
if not domain:
|
|
domain = models.Domain(name=domain_name)
|
|
db.session.add(domain)
|
|
alias = models.Alias.query.get(email)
|
|
tracked_aliases.add(email)
|
|
tracked_domains.add(domain_name)
|
|
if not alias:
|
|
alias = models.Alias(
|
|
localpart=localpart,
|
|
domain=domain,
|
|
wildcard=wildcard,
|
|
destination=destination,
|
|
email=email
|
|
)
|
|
else:
|
|
alias.destination = destination
|
|
alias.wildcard = wildcard
|
|
db.session.add(alias)
|
|
|
|
db.session.commit()
|
|
|
|
managers = new_config.get('managers', [])
|
|
# tracked_managers=set()
|
|
for manager_config in managers:
|
|
if verbose:
|
|
print(str(manager_config))
|
|
domain_name = manager_config['domain']
|
|
user_name = manager_config['user']
|
|
domain = models.Domain.query.get(domain_name)
|
|
manageruser = models.User.query.get(f'{user_name}@{domain_name}')
|
|
if manageruser not in domain.managers:
|
|
domain.managers.append(manageruser)
|
|
db.session.add(domain)
|
|
|
|
db.session.commit()
|
|
|
|
if delete_objects:
|
|
for user in db.session.query(models.User).all():
|
|
if not user.email in tracked_users:
|
|
if verbose:
|
|
print(f'Deleting user: {user.email}')
|
|
db.session.delete(user)
|
|
for alias in db.session.query(models.Alias).all():
|
|
if not alias.email in tracked_aliases:
|
|
if verbose:
|
|
print(f'Deleting alias: {alias.email}')
|
|
db.session.delete(alias)
|
|
for domain in db.session.query(models.Domain).all():
|
|
if not domain.name in tracked_domains:
|
|
if verbose:
|
|
print(f'Deleting domain: {domain.name}')
|
|
db.session.delete(domain)
|
|
|
|
db.session.commit()
|
|
|
|
|
|
@mailu.command()
|
|
@click.option('-v', '--verbose', count=True, help='Increase verbosity.')
|
|
@click.option('-s', '--secrets', is_flag=True, help='Show secret attributes in messages.')
|
|
@click.option('-d', '--debug', is_flag=True, help='Enable debug output.')
|
|
@click.option('-q', '--quiet', is_flag=True, help='Quiet mode - only show errors.')
|
|
@click.option('-c', '--color', is_flag=True, help='Force colorized output.')
|
|
@click.option('-u', '--update', is_flag=True, help='Update mode - merge input with existing config.')
|
|
@click.option('-n', '--dry-run', is_flag=True, help='Perform a trial run with no changes made.')
|
|
@click.argument('source', metavar='[FILENAME|-]', type=click.File(mode='r'), default=sys.stdin)
|
|
@with_appcontext
|
|
def config_import(verbose=0, secrets=False, debug=False, quiet=False, color=False,
|
|
update=False, dry_run=False, source=None):
|
|
""" Import configuration as YAML or JSON from stdin or file
|
|
"""
|
|
|
|
log = Logger(want_color=color or None, can_color=sys.stdout.isatty(), secrets=secrets, debug=debug)
|
|
log.lexer = 'python'
|
|
log.strip = True
|
|
log.verbose = 0 if quiet else verbose
|
|
log.quiet = quiet
|
|
|
|
context = {
|
|
'import': True,
|
|
'update': update,
|
|
'clear': not update,
|
|
'callback': log.track_serialize,
|
|
}
|
|
|
|
schema = MailuSchema(only=MailuSchema.Meta.order, context=context)
|
|
|
|
try:
|
|
# import source
|
|
with models.db.session.no_autoflush:
|
|
config = schema.loads(source)
|
|
# flush session to show/count all changes
|
|
if not quiet and (dry_run or verbose):
|
|
db.session.flush()
|
|
# check for duplicate domain names
|
|
config.check()
|
|
except Exception as exc:
|
|
if msg := log.format_exception(exc):
|
|
raise click.ClickException(msg) from exc
|
|
raise
|
|
|
|
# do not commit when running dry
|
|
if dry_run:
|
|
log.changes('Dry run. Not committing changes.')
|
|
db.session.rollback()
|
|
else:
|
|
log.changes('Committing changes.')
|
|
db.session.commit()
|
|
|
|
|
|
@mailu.command()
|
|
@click.option('-f', '--full', is_flag=True, help='Include attributes with default value.')
|
|
@click.option('-s', '--secrets', is_flag=True,
|
|
help='Include secret attributes (dkim-key, passwords).')
|
|
@click.option('-d', '--dns', is_flag=True, help='Include dns records.')
|
|
@click.option('-c', '--color', is_flag=True, help='Force colorized output.')
|
|
@click.option('-o', '--output-file', 'output', default=sys.stdout, type=click.File(mode='w'),
|
|
help='Save configuration to file.')
|
|
@click.option('-j', '--json', 'as_json', is_flag=True, help='Export configuration in json format.')
|
|
@click.argument('only', metavar='[FILTER]...', nargs=-1)
|
|
@with_appcontext
|
|
def config_export(full=False, secrets=False, color=False, dns=False, output=None, as_json=False, only=None):
|
|
""" Export configuration as YAML or JSON to stdout or file
|
|
"""
|
|
|
|
log = Logger(want_color=color or None, can_color=output.isatty())
|
|
|
|
only = only or MailuSchema.Meta.order
|
|
|
|
context = {
|
|
'full': full,
|
|
'secrets': secrets,
|
|
'dns': dns,
|
|
}
|
|
|
|
old_umask = os.umask(0o077)
|
|
try:
|
|
schema = MailuSchema(only=only, context=context)
|
|
if as_json:
|
|
schema.opts.render_module = RenderJSON
|
|
log.lexer = 'json'
|
|
log.strip = True
|
|
print(log.colorize(schema.dumps(models.MailuConfig())), file=output)
|
|
except Exception as exc:
|
|
if msg := log.format_exception(exc):
|
|
raise click.ClickException(msg) from exc
|
|
raise
|
|
finally:
|
|
os.umask(old_umask)
|
|
|
|
|
|
@mailu.command()
|
|
@click.argument('email')
|
|
@click.option('-r', '--really', is_flag=True)
|
|
@with_appcontext
|
|
def user_delete(email, really=False):
|
|
"""disable or delete user"""
|
|
if user := models.User.query.get(email):
|
|
if really:
|
|
db.session.delete(user)
|
|
else:
|
|
user.enabled = False
|
|
db.session.commit()
|
|
|
|
|
|
@mailu.command()
|
|
@click.argument('email')
|
|
@with_appcontext
|
|
def alias_delete(email):
|
|
"""delete alias"""
|
|
if alias := models.Alias.query.get(email):
|
|
db.session.delete(alias)
|
|
db.session.commit()
|
|
|
|
|
|
@mailu.command()
|
|
@click.argument('localpart')
|
|
@click.argument('domain_name')
|
|
@click.argument('destination')
|
|
@click.option('-w', '--wildcard', is_flag=True)
|
|
@with_appcontext
|
|
def alias(localpart, domain_name, destination, wildcard=False):
|
|
""" Create an alias
|
|
"""
|
|
domain = models.Domain.query.get(domain_name)
|
|
if not domain:
|
|
domain = models.Domain(name=domain_name)
|
|
db.session.add(domain)
|
|
alias = models.Alias(
|
|
localpart=localpart,
|
|
domain=domain,
|
|
wildcard=wildcard,
|
|
destination=destination.split(','),
|
|
email=f'{localpart}@{domain_name}'
|
|
)
|
|
db.session.add(alias)
|
|
db.session.commit()
|
|
|
|
|
|
@mailu.command()
|
|
@click.argument('domain_name')
|
|
@click.argument('max_users')
|
|
@click.argument('max_aliases')
|
|
@click.argument('max_quota_bytes')
|
|
@with_appcontext
|
|
def setlimits(domain_name, max_users, max_aliases, max_quota_bytes):
|
|
""" Set domain limits
|
|
"""
|
|
domain = models.Domain.query.get(domain_name)
|
|
domain.max_users = max_users
|
|
domain.max_aliases = max_aliases
|
|
domain.max_quota_bytes = max_quota_bytes
|
|
db.session.add(domain)
|
|
db.session.commit()
|
|
|
|
|
|
@mailu.command()
|
|
@click.argument('domain_name')
|
|
@click.argument('user_name')
|
|
@with_appcontext
|
|
def setmanager(domain_name, user_name='manager'):
|
|
""" Make a user manager of a domain
|
|
"""
|
|
domain = models.Domain.query.get(domain_name)
|
|
manageruser = models.User.query.get(f'{user_name}@{domain_name}')
|
|
domain.managers.append(manageruser)
|
|
db.session.add(domain)
|
|
db.session.commit()
|