Files
threshold/website/content/docs/concepts/domain-model/groups.mdx
T
Michael Gaffney 1ac3660dca Docs: add domain model diagram and update meta data in domain model pages (#611)
* Docs: add domain model diagram

* Docs: fix meta data in domain model pages

* Docs: add Sessions to domain model
2020-10-10 16:40:06 -04:00

51 lines
1.2 KiB
Plaintext

---
layout: docs
page_title: Domain Model - Groups
sidebar_title: Groups
description: |-
The anatomy of a Boundary group
---
# Groups
Groups are collections of Users used only for access control purposes.
A Group is owned by one and only one Scope.
A Group can contain zero or more Users.
A Group inherits from Principal ("is-a" Principal)
allowing it to be associated with zero or more Roles.
All Users in a Group are granted the capabilities of all Roles the Group is associated with.
A Group is deleted when the Scope it belongs to is deleted.
The lifecycle of a Group is not tied to the lifecycle of any User or Role.
```shell-session
+-------------------------------------+
| Organization |
+--------------------------+----------+
| Group 1 | Group 2 |
+--------+--------+-------------------+
| User 1 | User 2 | User 3 | User 4 |
+--------+--------+--------+----------+
```
# Attributes
### ID
A group ID has a `g_` prefix followed by ten digits.
Example: `g_0123456789`
### Name
A group name is the friendly name of a group resource.
### Description
A group description is the friendly description of the group resource.
# Referenced By
- [User]()
- [Role]()
- [Organization]()