Skip to content

Users

Person entities represent user accounts in Entu. Each person can authenticate and is referenced throughout the system for rights assignment and ownership tracking.

Adding Users

  1. Create a new entity of type Person
  2. Enter the person's email address in the entu_user field
  3. Click Send Invitation — the user receives a link to complete sign-in

User Rights

By default, a newly created person entity has no specific rights. They can only access entities shared at the domain level or rights inherited from a parent entity. To grant additional access, reference the person in the appropriate rights property on the relevant entities:

PropertyAccess
_ownerFull control
_editorView and edit (not rights properties)
_expanderView and create children
_viewerRead-only
_noaccessExplicitly blocked, overrides inherited rights

Automatic User Creation

If you want to allow access to all users who authenticate via OAuth, Entu can automatically create a person entity for them on first login — no manual setup required.

WARNING

Auto-created users are regular users. They will have access to all entities and properties that use domain sharing. Make sure your sharing settings are intentional before enabling this.

Access Control

Because the new person entity has _inheritrights: true and is parented under the add_user target, it automatically inherits whatever rights are set on that parent. Grant rights to the parent container once — all auto-created users inherit them.

To restrict a specific user after auto-creation, add _noaccess directly on their person entity. Explicit rights on the child always override inherited ones.

See Entities → Access Rights for more.

Requirements

All of the following must be true for auto-creation to trigger:

  1. The database entity has an add_user property referencing the parent entity where new person entities will be created (e.g. a "Users" folder)
  2. A person entity type definition exists in the database (_type: entity, name: person)
  3. The authentication request includes the db query parameter
  4. No existing person entity already has entu_user matching the OAuth email