2020-07-05 11:57:38 +00:00
|
|
|
"""
|
|
|
|
Django settings for etebase_server project.
|
|
|
|
|
|
|
|
Generated by 'django-admin startproject' using Django 3.0.3.
|
|
|
|
|
|
|
|
For more information on this file, see
|
|
|
|
https://docs.djangoproject.com/en/3.0/topics/settings/
|
|
|
|
|
|
|
|
For the full list of settings and their values, see
|
|
|
|
https://docs.djangoproject.com/en/3.0/ref/settings/
|
|
|
|
"""
|
|
|
|
|
2020-09-10 15:51:25 +00:00
|
|
|
import configparser
|
2024-06-08 21:51:44 +00:00
|
|
|
import os
|
|
|
|
|
2020-09-10 15:51:25 +00:00
|
|
|
from .utils import get_secret_from_file
|
2020-07-05 11:57:38 +00:00
|
|
|
|
|
|
|
# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
|
2022-05-08 16:15:21 +00:00
|
|
|
SOURCE_DIR = os.path.dirname(os.path.abspath(__file__))
|
|
|
|
BASE_DIR = os.path.dirname(SOURCE_DIR)
|
2020-07-05 11:57:38 +00:00
|
|
|
|
2020-11-14 15:04:41 +00:00
|
|
|
AUTH_USER_MODEL = "myauth.User"
|
2020-07-05 12:04:24 +00:00
|
|
|
|
2020-07-05 11:57:38 +00:00
|
|
|
|
|
|
|
# Quick-start development settings - unsuitable for production
|
|
|
|
# See https://docs.djangoproject.com/en/3.0/howto/deployment/checklist/
|
|
|
|
|
2020-09-10 15:51:25 +00:00
|
|
|
# SECURITY WARNING: keep the secret key used in production secret!
|
|
|
|
# See secret.py for how this is generated; uses a file 'secret.txt' in the root
|
|
|
|
# directory
|
|
|
|
SECRET_FILE = os.path.join(BASE_DIR, "secret.txt")
|
2020-07-05 11:57:38 +00:00
|
|
|
|
|
|
|
# SECURITY WARNING: don't run with debug turned on in production!
|
2020-09-27 06:42:01 +00:00
|
|
|
DEBUG = True
|
2020-07-05 11:57:38 +00:00
|
|
|
|
|
|
|
ALLOWED_HOSTS = []
|
|
|
|
|
2020-09-10 15:51:25 +00:00
|
|
|
# Database
|
|
|
|
# https://docs.djangoproject.com/en/2.0/ref/settings/#databases
|
|
|
|
|
|
|
|
DATABASES = {
|
2020-11-14 15:04:41 +00:00
|
|
|
"default": {
|
|
|
|
"ENGINE": "django.db.backends.sqlite3",
|
|
|
|
"NAME": os.environ.get("ETEBASE_DB_PATH", os.path.join(BASE_DIR, "db.sqlite3")),
|
2020-09-10 15:51:25 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2024-06-08 21:51:44 +00:00
|
|
|
DEFAULT_AUTO_FIELD = "django.db.models.AutoField"
|
2020-07-05 11:57:38 +00:00
|
|
|
|
|
|
|
# Application definition
|
|
|
|
|
|
|
|
INSTALLED_APPS = [
|
2020-11-14 15:04:41 +00:00
|
|
|
"django.contrib.admin",
|
|
|
|
"django.contrib.auth",
|
|
|
|
"django.contrib.contenttypes",
|
|
|
|
"django.contrib.sessions",
|
|
|
|
"django.contrib.messages",
|
|
|
|
"django.contrib.staticfiles",
|
2022-05-08 13:10:48 +00:00
|
|
|
"etebase_server.myauth.apps.MyauthConfig",
|
2022-05-08 14:32:29 +00:00
|
|
|
"etebase_server.django.apps.DjangoEtebaseConfig",
|
|
|
|
"etebase_server.django.token_auth.apps.TokenAuthConfig",
|
2020-07-05 11:57:38 +00:00
|
|
|
]
|
|
|
|
|
|
|
|
MIDDLEWARE = [
|
2020-11-14 15:04:41 +00:00
|
|
|
"django.middleware.security.SecurityMiddleware",
|
|
|
|
"django.contrib.sessions.middleware.SessionMiddleware",
|
|
|
|
"django.middleware.common.CommonMiddleware",
|
|
|
|
"django.middleware.csrf.CsrfViewMiddleware",
|
|
|
|
"django.contrib.auth.middleware.AuthenticationMiddleware",
|
|
|
|
"django.contrib.messages.middleware.MessageMiddleware",
|
|
|
|
"django.middleware.clickjacking.XFrameOptionsMiddleware",
|
2020-07-05 11:57:38 +00:00
|
|
|
]
|
|
|
|
|
2020-11-14 15:04:41 +00:00
|
|
|
ROOT_URLCONF = "etebase_server.urls"
|
2020-07-05 11:57:38 +00:00
|
|
|
|
|
|
|
TEMPLATES = [
|
|
|
|
{
|
2020-11-14 15:04:41 +00:00
|
|
|
"BACKEND": "django.template.backends.django.DjangoTemplates",
|
2022-05-08 16:15:21 +00:00
|
|
|
"DIRS": [os.path.join(SOURCE_DIR, "templates")],
|
2020-11-14 15:04:41 +00:00
|
|
|
"APP_DIRS": True,
|
|
|
|
"OPTIONS": {
|
|
|
|
"context_processors": [
|
|
|
|
"django.template.context_processors.debug",
|
|
|
|
"django.template.context_processors.request",
|
|
|
|
"django.contrib.auth.context_processors.auth",
|
|
|
|
"django.contrib.messages.context_processors.messages",
|
2020-07-05 11:57:38 +00:00
|
|
|
],
|
|
|
|
},
|
|
|
|
},
|
|
|
|
]
|
|
|
|
|
2020-11-14 15:04:41 +00:00
|
|
|
WSGI_APPLICATION = "etebase_server.wsgi.application"
|
2020-07-05 11:57:38 +00:00
|
|
|
|
|
|
|
|
|
|
|
# Password validation
|
|
|
|
# https://docs.djangoproject.com/en/3.0/ref/settings/#auth-password-validators
|
|
|
|
|
|
|
|
AUTH_PASSWORD_VALIDATORS = [
|
2020-12-14 14:12:34 +00:00
|
|
|
{
|
|
|
|
"NAME": "django.contrib.auth.password_validation.UserAttributeSimilarityValidator",
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"NAME": "django.contrib.auth.password_validation.MinimumLengthValidator",
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"NAME": "django.contrib.auth.password_validation.CommonPasswordValidator",
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"NAME": "django.contrib.auth.password_validation.NumericPasswordValidator",
|
|
|
|
},
|
2020-07-05 11:57:38 +00:00
|
|
|
]
|
|
|
|
|
|
|
|
|
|
|
|
# Internationalization
|
|
|
|
# https://docs.djangoproject.com/en/3.0/topics/i18n/
|
|
|
|
|
2020-11-14 15:04:41 +00:00
|
|
|
LANGUAGE_CODE = "en-us"
|
2020-07-05 11:57:38 +00:00
|
|
|
|
2020-11-14 15:04:41 +00:00
|
|
|
TIME_ZONE = "UTC"
|
2020-07-05 11:57:38 +00:00
|
|
|
|
|
|
|
USE_I18N = True
|
|
|
|
|
|
|
|
USE_L10N = True
|
|
|
|
|
|
|
|
USE_TZ = True
|
|
|
|
|
|
|
|
# Static files (CSS, JavaScript, Images)
|
|
|
|
# https://docs.djangoproject.com/en/3.0/howto/static-files/
|
|
|
|
|
2022-07-21 10:37:43 +00:00
|
|
|
STATIC_ROOT = os.path.join(BASE_DIR, "static")
|
2020-11-14 15:04:41 +00:00
|
|
|
STATIC_URL = "/static/"
|
2020-07-05 12:04:24 +00:00
|
|
|
|
2022-07-21 10:37:43 +00:00
|
|
|
MEDIA_ROOT = os.path.join(BASE_DIR, "media")
|
2020-11-14 15:04:41 +00:00
|
|
|
MEDIA_URL = "/user-media/"
|
2020-07-05 12:04:24 +00:00
|
|
|
|
2020-09-10 15:51:25 +00:00
|
|
|
# Define where to find configuration files
|
2020-11-07 19:21:34 +00:00
|
|
|
config_locations = [
|
2020-11-14 15:04:41 +00:00
|
|
|
os.environ.get("ETEBASE_EASY_CONFIG_PATH", ""),
|
|
|
|
"etebase-server.ini",
|
|
|
|
"/etc/etebase-server/etebase-server.ini",
|
2020-11-07 19:21:34 +00:00
|
|
|
]
|
|
|
|
|
Implement checking the username against LDAP (#64)
This commit adds code to allow users that prefer to do user management
via LDAP to do so. Since Etebase does not store the password (proof) in
a LDAP compatible fashion, we compromise and instead two checks: One while
registering an account to see if the username is the LDAP directory and
one whenever the API is accessed. To prevent too many LDAP requests, the
result of the request is cached for an configurable amount of hours.
Make sure you have python-ldap installed and can successfully import
ldap. Then, if you use the easy config, add the following to your
config:
```
; [...]
; Regular etesync configuration
[ldap]
bind_dn = <Your LDAP "user" to bind as. See Note 1>
bind_pw = <The password to authenticate as your bind user>
; Or if you have the password in a file:
; bind_pw_file = /path/to/the/file.txt
server = <The URL to your LDAP server>
search_base = <Your search base>
filter = <Your LDAP filter query. See Note 2>
; In case a cache TTL of 1 hour is too short for you, set `cache_ttl` to
the preferred
; amount of hours a cache entry should be viewed as valid:
; cache_ttl = 5
```
With this config, I am able to make the EteSync server check with my
LDAP server if a user should be able to login or register.
Note that if a user is allowed to login or register, the password of the
LDAP user will be ignored. This LDAP patch is nothing more than an
additional check before the actual authentication.
A successful LDAP check will be cached, if not configured (correctly),
for one hour, after which the LDAP query will be performed again.
Note 1: This commit only works with a bind user
Note 2: The query must be specified. If an LDAP query returns more than
one or no result, then the authentication fails. If your query needs to
include the username that currently tries to perform a login or
registration, you can use %%s, which will be subsituted for the used
username.
2022-06-13 10:29:43 +00:00
|
|
|
ETEBASE_CREATE_USER_FUNC = "etebase_server.django.utils.create_user_blocked"
|
|
|
|
|
2020-09-10 15:51:25 +00:00
|
|
|
# Use config file if present
|
|
|
|
if any(os.path.isfile(x) for x in config_locations):
|
|
|
|
config = configparser.ConfigParser()
|
|
|
|
config.read(config_locations)
|
|
|
|
|
2020-11-14 15:04:41 +00:00
|
|
|
section = config["global"]
|
2020-09-10 15:51:25 +00:00
|
|
|
|
2020-11-14 15:04:41 +00:00
|
|
|
SECRET_FILE = section.get("secret_file", SECRET_FILE)
|
|
|
|
STATIC_ROOT = section.get("static_root", STATIC_ROOT)
|
|
|
|
STATIC_URL = section.get("static_url", STATIC_URL)
|
|
|
|
MEDIA_ROOT = section.get("media_root", MEDIA_ROOT)
|
|
|
|
MEDIA_URL = section.get("media_url", MEDIA_URL)
|
|
|
|
LANGUAGE_CODE = section.get("language_code", LANGUAGE_CODE)
|
|
|
|
TIME_ZONE = section.get("time_zone", TIME_ZONE)
|
|
|
|
DEBUG = section.getboolean("debug", DEBUG)
|
2020-09-10 15:51:25 +00:00
|
|
|
|
2021-01-28 15:55:37 +00:00
|
|
|
if "redis_uri" in section:
|
|
|
|
ETEBASE_REDIS_URI = section.get("redis_uri")
|
|
|
|
|
2020-11-14 15:04:41 +00:00
|
|
|
if "allowed_hosts" in config:
|
|
|
|
ALLOWED_HOSTS = [y for x, y in config.items("allowed_hosts")]
|
2020-09-10 15:51:25 +00:00
|
|
|
|
2020-11-14 15:04:41 +00:00
|
|
|
if "database" in config:
|
|
|
|
DATABASES = {"default": {x.upper(): y for x, y in config.items("database")}}
|
2020-09-10 15:51:25 +00:00
|
|
|
|
2022-05-09 14:32:35 +00:00
|
|
|
if "database-options" in config:
|
|
|
|
DATABASES["default"]["OPTIONS"] = config["database-options"]
|
|
|
|
|
Implement checking the username against LDAP (#64)
This commit adds code to allow users that prefer to do user management
via LDAP to do so. Since Etebase does not store the password (proof) in
a LDAP compatible fashion, we compromise and instead two checks: One while
registering an account to see if the username is the LDAP directory and
one whenever the API is accessed. To prevent too many LDAP requests, the
result of the request is cached for an configurable amount of hours.
Make sure you have python-ldap installed and can successfully import
ldap. Then, if you use the easy config, add the following to your
config:
```
; [...]
; Regular etesync configuration
[ldap]
bind_dn = <Your LDAP "user" to bind as. See Note 1>
bind_pw = <The password to authenticate as your bind user>
; Or if you have the password in a file:
; bind_pw_file = /path/to/the/file.txt
server = <The URL to your LDAP server>
search_base = <Your search base>
filter = <Your LDAP filter query. See Note 2>
; In case a cache TTL of 1 hour is too short for you, set `cache_ttl` to
the preferred
; amount of hours a cache entry should be viewed as valid:
; cache_ttl = 5
```
With this config, I am able to make the EteSync server check with my
LDAP server if a user should be able to login or register.
Note that if a user is allowed to login or register, the password of the
LDAP user will be ignored. This LDAP patch is nothing more than an
additional check before the actual authentication.
A successful LDAP check will be cached, if not configured (correctly),
for one hour, after which the LDAP query will be performed again.
Note 1: This commit only works with a bind user
Note 2: The query must be specified. If an LDAP query returns more than
one or no result, then the authentication fails. If your query needs to
include the username that currently tries to perform a login or
registration, you can use %%s, which will be subsituted for the used
username.
2022-06-13 10:29:43 +00:00
|
|
|
if "ldap" in config:
|
|
|
|
ldap = config["ldap"]
|
|
|
|
LDAP_SERVER = ldap.get("server", "")
|
|
|
|
LDAP_SEARCH_BASE = ldap.get("search_base", "")
|
|
|
|
LDAP_FILTER = ldap.get("filter", "")
|
|
|
|
LDAP_BIND_DN = ldap.get("bind_dn", "")
|
|
|
|
LDAP_BIND_PW = ldap.get("bind_pw", "")
|
|
|
|
LDAP_BIND_PW_FILE = ldap.get("bind_pw_file", "")
|
|
|
|
LDAP_CACHE_TTL = ldap.get("cache_ttl", "")
|
|
|
|
|
|
|
|
if not LDAP_BIND_DN:
|
|
|
|
raise Exception("LDAP enabled but bind_dn is not set!")
|
|
|
|
if not LDAP_BIND_PW and not LDAP_BIND_PW_FILE:
|
|
|
|
raise Exception("LDAP enabled but both bind_pw and bind_pw_file are not set!")
|
|
|
|
|
|
|
|
# Configure EteBase to use LDAP
|
|
|
|
ETEBASE_CREATE_USER_FUNC = "etebase_server.myauth.ldap.create_user"
|
|
|
|
ETEBASE_API_PERMISSIONS_READ = ["etebase_server.myauth.ldap.is_user_in_ldap"]
|
2020-07-05 12:04:24 +00:00
|
|
|
|
2020-12-14 14:40:08 +00:00
|
|
|
# Efficient file streaming (for large files)
|
2022-06-04 15:05:13 +00:00
|
|
|
SENDFILE_BACKEND = "etebase_server.fastapi.sendfile.backends.simple"
|
2021-04-17 15:22:09 +00:00
|
|
|
SENDFILE_ROOT = MEDIA_ROOT
|
2020-12-14 14:40:08 +00:00
|
|
|
|
2022-07-21 10:37:43 +00:00
|
|
|
if "DJANGO_STATIC_ROOT" in os.environ:
|
|
|
|
STATIC_ROOT = os.environ["DJANGO_STATIC_ROOT"]
|
|
|
|
|
|
|
|
if "DJANGO_MEDIA_ROOT" in os.environ:
|
|
|
|
MEDIA_ROOT = os.environ["DJANGO_MEDIA_ROOT"]
|
|
|
|
|
2020-09-10 15:51:25 +00:00
|
|
|
# Make an `etebase_server_settings` module available to override settings.
|
2020-07-05 12:04:24 +00:00
|
|
|
try:
|
2024-06-08 21:56:36 +00:00
|
|
|
from etebase_server_settings import * # noqa: F403
|
2020-07-05 12:04:24 +00:00
|
|
|
except ImportError:
|
|
|
|
pass
|
2020-09-10 15:51:25 +00:00
|
|
|
|
2020-11-14 15:04:41 +00:00
|
|
|
if "SECRET_KEY" not in locals():
|
2020-09-10 15:51:25 +00:00
|
|
|
SECRET_KEY = get_secret_from_file(SECRET_FILE)
|