Skip to content

settings.rst

Latest commit

 

History

History
168 lines (124 loc) · 4.89 KB

settings.rst

File metadata and controls

168 lines (124 loc) · 4.89 KB

Settings

OPENWISP_ORGANIZATION_USER_ADMIN

type: boolean
default: True

Indicates whether the admin section for managing OrganizationUser items is enabled or not.

OPENWISP_ORGANIZATION_OWNER_ADMIN

type: boolean
default: True

Indicates whether the admin section for managing OrganizationOwner items is enabled or not.

Refer to :ref:`organization_owners` for more information.

OPENWISP_USERS_SOCIALACCOUNT_ADMIN_NEEDED

type: boolean
default: auto-detected based on INSTALLED_APPS

Controls whether the social account admin (used to manage OAuth/SAML application credentials such as client IDs and secrets) is shown in the Django admin.

By default, this is set to True automatically when any app whose name starts with allauth.socialaccount.providers. is found in INSTALLED_APPS.

Set this to True explicitly when using custom or third-party allauth provider apps that do not follow the allauth.socialaccount.providers.* namespace convention, so that their SocialApp credentials can be managed in the Django admin.

OPENWISP_USERS_SOCIALACCOUNT_ADMIN_NEEDED = True

OPENWISP_USERS_AUTH_API

type: boolean
default: True

Indicates whether the :doc:`rest-api` is enabled or not.

OPENWISP_USERS_AUTH_THROTTLE_RATE

type: str
default: 100/day

Indicates the rate throttling for the :ref:`obtain_auth_token` API endpoint.

Please note that the current rate throttler is very basic and will also count valid requests for rate limiting. For more information, check Django-rest-framework throttling guide.

OPENWISP_USERS_AUTH_BACKEND_AUTO_PREFIXES

type: tuple
default: tuple()

A tuple or list of international prefixes which will be automatically tested by :ref:`the authentication backend of OpenWISP Users <UsersAuthenticationBackend>` when parsing phone numbers.

Each prefix will be prepended to the username string automatically and parsed with the phonenumbers library to find out if the result is a valid number of not.

This allows users to log in by using only the national phone number, without having to specify the international prefix.

OPENWISP_USERS_EXPORT_USERS_COMMAND_CONFIG

type: dict
default: 
{
    "fields": [
        "id",
        "username",
        "email",
        "password",
        "first_name",
        "last_name",
        "is_staff",
        "is_active",
        "date_joined",
        "phone_number",
        "birth_date",
        "location",
        "notes",
        "language",
        "organizations",
    ],
    "select_related": [],
}

This setting can be used to configure the exported fields for the :ref:`export_users` command.

The select_related property can be used to optimize the database query.

OPENWISP_USERS_USER_PASSWORD_EXPIRATION

type: integer
default: 0

Number of days after which a user's password will expire. In other words, it determines when users will be prompted to change their passwords.

If set to 0, this feature is disabled, and users are not required to change their passwords.

OPENWISP_USERS_STAFF_USER_PASSWORD_EXPIRATION

type: integer
default: 0

Similar to :ref:`OPENWISP_USERS_USER_PASSWORD_EXPIRATION`, but for staff users.
⚡