https://github.com/ppfeufer/aa-ma-securegroups
https://github.com/ppfeufer/aa-ma-securegroups
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/ppfeufer/aa-ma-securegroups
- Owner: ppfeufer
- License: gpl-3.0
- Created: 2022-08-05T02:11:38.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2025-04-07T20:04:26.000Z (about 2 months ago)
- Last Synced: 2025-04-07T20:42:57.356Z (about 2 months ago)
- Language: Python
- Size: 1.2 MB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
# Member Audit Secure Groups Integration for Alliance Auth
[](https://pypi.org/project/aa-ma-securegroups/)
[](https://github.com/ppfeufer/aa-ma-securegroups/blob/master/LICENSE)
[](https://pypi.org/project/aa-ma-securegroups/)
[](https://pypi.org/project/aa-ma-securegroups/)
[](https://results.pre-commit.ci/latest/github/ppfeufer/aa-ma-securegroups/master)
[](http://black.readthedocs.io/en/latest/)
[](https://discord.gg/zmh52wnfvM)
[](https://github.com/ppfeufer/aa-ma-securegroups/actions/workflows/automated-checks.yml)
[](https://codecov.io/gh/ppfeufer/aa-ma-securegroups)
[](https://weblate.ppfeufer.de/engage/alliance-auth-apps/)
[](https://github.com/ppfeufer/aa-ma-securegroups/blob/master/CODE_OF_CONDUCT.md)
[](https://ko-fi.com/N4N8CL1BY)
This is an integration between [Member Audit](https://gitlab.com/ErikKalkoken/aa-memberaudit) and [Secure Groups](https://github.com/pvyParts/allianceauth-secure-groups) for [Alliance Auth](https://gitlab.com/allianceauth/allianceauth) (AA).
______________________________________________________________________
- [What's the difference to Member Audit Securegroups](#whats-the-difference-to-member-audit-securegroups)
- [Features](#features)
- [Installation](#installation)
- [Requirements](#requirements)
- [Step 0.5: Migrating from Member Audit Securegroups](#step-05-migrating-from-member-audit-securegroups)
- [Step 1: Install the Package](#step-1-install-the-package)
- [Step 2: Config](#step-2-config)
- [Step 3: Finalize App Installation](#step-3-finalize-app-installation)
- [Filters](#filters)
- [Changelog](#changelog)
- [Translation Status](#translation-status)
- [Contributing](#contributing)
______________________________________________________________________
## What's the difference to Member Audit Securegroups
Pretty much nothing.
I took over Member Audit Securegroups in August 2022 from the original developer who
is no longer actively maintaining the app. After more than a year and the fact that
I have a distinct dislike for Gitlab, and the original developer didn't want to transfer
the PyPi repository to me, I decided it is time to make an actual fork of the app
which is now again actively maintained by me.
This app is fully compatible with the original, all that has changed is the `pip`
name from `aa-memberaudit-securegroups` to `aa-ma-securegroups`, and if
you had the original app installed, it is really easy to switch to this one, see
[Step 0.5: Migrating from Member Audit Securegroups](#step-05-migrating-from-member-audit-securegroups).
Thanks to [@rcmurphy](https://github.com/rcmurphy) for all her work on the [original
app](https://gitlab.com/eclipse-expeditions/aa-memberaudit-securegroups)!
- Activity Filter
- Asset Filter
- Character Age Filter
- Compliance Filter
- Corporation Role Filter
- Corporation Title Filter
- Skill Set Filter
- Skill Point Filter
- Time in Corporation Filter
> [!NOTE]
>
> **Member Audit Secure Groups Integration >= 1.0.0 needs at least Alliance Auth v4.0.0!**
>
> Please make sure to update your Alliance Auth instance _before_ you install this
> module or update to the latest version, otherwise an update to Alliance Auth will
> be pulled in unsupervised.
>
> The last version compatible with Alliance Auth v3 is `0.6.1`.
This integration needs [Member Audit](https://gitlab.com/ErikKalkoken/aa-memberaudit)
and [Secure Groups](https://github.com/pvyParts/allianceauth-secure-groups) to
function. Please make sure they are installed before continuing.
### Step 0.5: Migrating from Member Audit Securegroups
In case you have the original app installed, you need to uninstall it before
you can continue. To do so, simply run:
```shell
pip uninstall aa-memberaudit-securegroups
```
That's all, no need to worry about the DB related stuff, this app is fully
compatible with it and will use the DB tables from the original app. Now feel free
to continue with the installation.
### Step 1: Install the Package
Make sure you are in the virtual environment (venv) of your Alliance Auth
installation. Then install the newest release from PyPI:
```shell
pip install aa-ma-securegroups
```
Add `memberaudit_securegroups` to your `INSTALLED_APPS`.
### Step 3: Finalize App Installation
Run migrations:
```shell
python manage.py migrate
```
Restart your supervisor services for Auth
| Filter Name | Matches if... | Reversed Logic Possible |
| -------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| Activity Filter | User has *at least one* character active within the last X days | No |
| Asset Filter | User has *at least one* character with *any of* the assets defined | No |
| Character Age Filter | User has *at least one* character over X days old | No |
| Compliance Filter | User has *all* characters registered on Member Audit | Yes , if reversed, user has *at least one* character *not* registered on Member Audit |
| Corporation Role Filter | User has a character (main or alt) in a certain corpration with a certain role | No |
| Corporation Title Filter | User has a character (main or alt) in a certain corpration with a certain title | No |
| Skill Point Filter | User has *at least one* character with at least X skill points | No |
| Skill Set Filter | User has *at least one* character with *any of* the selected skill sets | No |
| Time in Corporation Filter | User's main character is *at least* more than X days in their corpration | Yes, if reversed, user's main character is *at most* X days in their corpration |
See [CHANGELOG.md]
[](https://weblate.ppfeufer.de/engage/alliance-auth-apps/)
Do you want to help translate this app into your language or improve the existing
translation? - [Join our team of translators][weblate engage]!
Do you want to contribute to this project? That's cool!
Please make sure to read the [Contribution Guidelines].\
(I promise, it's not much, just some basics)
[changelog.md]: https://github.com/ppfeufer/aa-ma-securegroups/blob/master/CHANGELOG.md
[contribution guidelines]: https://github.com/ppfeufer/aa-ma-securegroups/blob/master/CONTRIBUTING.md "Contribution Guidelines"
[weblate engage]: https://weblate.ppfeufer.de/engage/alliance-auth-apps/ "Weblate Translations"