website: Flesh out docs split.
website: Copy files during build. website: Allow for mixed env builds. website: Reduce build size. website: Expose build. website: Add build memory debugging. WIP: Disable broken links check to compare memory usage. website: Update deps. website: Clean up API paths. website: Flesh out 3.8 fixes. Format. website: Update ignore paths. Website: Clean up integrations build. website: Fix paths. website: Optimize remark. website: Update deps. website: Format. website: Remove linking. website: Fix paths. wip: Attempt API only build. Prep. Migrate render to runtime. Tidy sidebar. Clean up templates. docs: Move directory. WIP docs: Flesh out split. website: Fix issue where routes have collisions.
This commit is contained in:
35
docs/topics/users-sources/groups/group_ref.md
Normal file
35
docs/topics/users-sources/groups/group_ref.md
Normal file
@ -0,0 +1,35 @@
|
||||
---
|
||||
title: Group properties and attributes
|
||||
---
|
||||
|
||||
## Object properties
|
||||
|
||||
The group object has the following properties:
|
||||
|
||||
- `name`: The group's display name.
|
||||
- `is_superuser`: A boolean field that determines if the group's users are superusers.
|
||||
- `parent`: The parent group of this group.
|
||||
- `attributes`: Dynamic attributes, see [Attributes](#attributes).
|
||||
|
||||
## Examples
|
||||
|
||||
These are examples of how group objects can be used within authentik policies and property mappings.
|
||||
|
||||
### List all group members
|
||||
|
||||
Use the following examples to list all users that are members of a group:
|
||||
|
||||
```python title="Get all members of a group object"
|
||||
group.users.all()
|
||||
```
|
||||
|
||||
```python title="Specify a group object based on name and return all of its members"
|
||||
from authentik.core.models import Group
|
||||
Group.objects.get(name="name of group").users.all()
|
||||
```
|
||||
|
||||
## Attributes
|
||||
|
||||
By default, authentik group objects are created with no attributes, however custom attributes can be set.
|
||||
|
||||
See [the user reference](../user/user_ref.mdx#attributes) for well-known attributes.
|
||||
Reference in New Issue
Block a user