mirror of
https://github.com/inventree/InvenTree.git
synced 2025-04-28 03:26:45 +00:00
8ec04028d5
* Added basic ldap support * Added new settings to config template * Added missing apk dependency to dockerfile * update requirements.txt * Remove requirements and added docs * Update advanced.md * Added more ldap options * allow direct bind * add ldap debug mode * add ldap global_options * add start_tls * use get_boolean_setting * Update advanced.md to use a warning box * fix: style * Update advanced.md * Remove ldap install instructions for non docker installs
70 lines
4.3 KiB
Markdown
70 lines
4.3 KiB
Markdown
---
|
|
title: Advanced Topics
|
|
---
|
|
|
|
## Version Information
|
|
|
|
Starting with version 0.12 (and later), InvenTree includes more version information.
|
|
|
|
To view this information, navigate to the "About" page in the top menu bar and select "copy version information" on the bottom corner.
|
|
|
|
### Contained Information
|
|
|
|
The version information contains the following information extracted form the instance:
|
|
|
|
| Name | Always | Sample | Source |
|
|
| --- | --- | --- | --- |
|
|
| InvenTree-Version | Yes | 0.12.0 dev | instance |
|
|
| Django Version | Yes | 3.2.19 | instance |
|
|
| Commit Hash | No | aebff26 | environment: `INVENTREE_COMMIT_HASH`, git |
|
|
| Commit Date | No | 2023-06-10 | environment: `INVENTREE_COMMIT_DATE`, git |
|
|
| Commit Branch | No | master | environment: `INVENTREE_PKG_BRANCH`, git |
|
|
| Database | Yes | postgresql | environment: `INVENTREE_DB_*`, config: `database` - see [config](./config.md#database-options) |
|
|
| Debug-Mode | Yes | False | environment: `INVENTREE_DEBUG`, config: `config` - see [config](./config.md#basic-options) |
|
|
| Deployed using Docker | Yes | True | environment: `INVENTREE_DOCKER` |
|
|
| Platform | Yes | Linux-5.15.0-67-generic-x86_64 | instance |
|
|
| Installer | Yes | PKG | environment: `INVENTREE_PKG_INSTALLER`, instance |
|
|
| Target | No | ubuntu:20.04 | environment: `INVENTREE_PKG_TARGET` |
|
|
| Active plugins | Yes | [{'name': 'InvenTreeBarcode', 'slug': 'inventreebarcode', 'version': '2.0.0'}] | instance |
|
|
|
|
|
|
### Installer codes
|
|
|
|
The installer code is used to identify the way InvenTree was installed. If you vendor InvenTree, you can and should set the installer code to your own value to make sure debugging goes smoothly.
|
|
|
|
| Code | Description | Official |
|
|
| --- | --- | --- |
|
|
| PKG | Installed using a package manager | Yes |
|
|
| GIT | Installed using git | Yes |
|
|
| DOC | Installed using docker | Yes |
|
|
| DIO | Installed using digital ocean marketplace[^1] | No |
|
|
|
|
[^1]: Starting with fresh installs of 0.12.0 this code is set. Versions installed before 0.12.0 do not have this code set even after upgrading to 0.12.0.
|
|
|
|
## Authentication
|
|
|
|
### LDAP
|
|
|
|
You can link your InvenTree server to an LDAP server.
|
|
|
|
!!! warning "Important"
|
|
This feature is currently only available for docker installs.
|
|
|
|
Next you can start configuring the connection. Either use the config file or set the environment variables.
|
|
|
|
| config key | ENV Variable | Description |
|
|
| --- | --- | --- |
|
|
| `ldap.enabled` | `INVENTREE_LDAP_ENABLED` | Set this to `True` to enable LDAP. |
|
|
| `ldap.debug` | `INVENTREE_LDAP_DEBUG` | Set this to `True` to activate debug mode, useful for troubleshooting ldap configurations. |
|
|
| `ldap.server_uri` | `INVENTREE_LDAP_SERVER_URI` | LDAP Server URI, e.g. `ldaps://example.org` |
|
|
| `ldap.start_tls` | `INVENTREE_LDAP_START_TLS` | Enable TLS encryption over the standard LDAP port, [see](https://django-auth-ldap.readthedocs.io/en/latest/reference.html#auth-ldap-start-tls). (You can set TLS options via `ldap.global_options`) |
|
|
| `ldap.bind_dn` | `INVENTREE_LDAP_BIND_DN` | LDAP bind dn, e.g. `cn=admin,dc=example,dc=org` |
|
|
| `ldap.bind_password` | `INVENTREE_LDAP_BIND_PASSWORD` | LDAP bind password |
|
|
| `ldap.search_base_dn` | `INVENTREE_LDAP_SEARCH_BASE_DN` | LDAP search base dn, e.g. `cn=Users,dc=example,dc=org` |
|
|
| `ldap.user_dn_template` | `INVENTREE_LDAP_USER_DN_TEMPLATE` | use direct bind as auth user, `ldap.bind_dn` and `ldap.bin_password` is not necessary then, e.g. `uid=%(user)s,dc=example,dc=org` |
|
|
| `ldap.global_options` | `INVENTREE_LDAP_GLOBAL_OPTIONS` | set advanced options as dict, e.g. TLS settings. For a list of all available options, see [python-ldap docs](https://www.python-ldap.org/en/latest/reference/ldap.html#ldap-options). (keys and values starting with OPT_ get automatically converted to `python-ldap` keys) |
|
|
| `ldap.search_filter_str`| `INVENTREE_LDAP_SEARCH_FILTER_STR` | LDAP search filter str, default: `uid=%(user)s` |
|
|
| `ldap.user_attr_map` | `INVENTREE_LDAP_USER_ATTR_MAP` | LDAP <-> Inventree user attribute map, can be json if used as env, in yml directly specify the object. default: `{"first_name": "givenName", "last_name": "sn", "email": "mail"}` |
|
|
| `ldap.always_update_user` | `INVENTREE_LDAP_ALWAYS_UPDATE_USER` | Always update the user on each login, default: `true` |
|
|
| `ldap.cache_timeout` | `INVENTREE_LDAP_CACHE_TIMEOUT` | cache timeout to reduce traffic with LDAP server, default: `3600` (1h) |
|