Include Page | ||||
---|---|---|---|---|
|
Panel | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
This topic is discussed in the Advanced Topics training video. |
Users of Grouper users sometimes need to create and manage entities in Grouper that are not part of a central subject source. An example is where Grouper integrates with an external database that has schemas needed for access management. These schemas must be represented in Grouper so they can be assigned to Groups/Roles/Permissions. Before Grouper 2.1 this could be solved by creating a group to represent the local entity, and not assigning members to the group. In Grouper 2.1 a "local entity" can be created in the folder structure.
...
Grouper entities have a subject source different than the Grouper subject source (though similar). Since there is an optional subjectIdentifier attribute, queries for search or findByIdentifier will consider that value. Also, the following subject attributes exist in addition to the group subject attributes (name, extension, displayName, description, etc) :
Attribute name | Meaning |
---|---|
entityIdAttribute | if there is an entity id attribute assigned, this is the value |
entityId | if there is an entity id attribute assigned, it is used, if not, then this is the name attribute |
entityExtension | if there is an entity id attribute assigned, this is the suffix after the entity folder name and colon, if not, then this is the extension (not of attribute) |
API
You can create a local entity with the EntitySave class:
...
You can create/edit/delete local entities on the UI in a folder you have CREATE on
Other screens are tweaked, e.g. on the permissions screen you can search for entities but not groups/roles for individual permissions:
. In 2.4 UI patch #27 this is in the new UI
...
...
...
Local entity icon:
...
View an entity
...
Menu has entity options
...
Delete a local entity
...
Edit a local entity
...
There is a privilege tab
...
Only entity privileges can be assigned
...
Limiting the scope of entities
...