5.1. Manage OX objects#

Use this page to manage OX App Suite objects. The OX Connector synchronizes these objects from the LDAP directory. The following instructions explain how to create and configure contexts, user accounts, groups, access profiles, functional accounts, and resources in the Management UI. Read them to control which directory objects are available in OX App Suite and how the connector provisions them.

To complete the following tasks, sign in to the Management UI with a user account that has domain administration rights.

See also

Management UI

in Nubus Manual 1.x [6] for information about the Management UI.

Sign-in

in Nubus Manual 1.x [6] for information about sign-in.

Delegated administration for management modules

in Nubus for UCS 5.2 - Operation Manual [1] for information about delegative administration.

5.1.1. Contexts#

OX App Suite uses contexts to collect users, groups, and resources for collaboration in a virtual space. Data from one context isn’t visible to other contexts. For more information about contexts, see App Suite Context management [7].

To view, add, update, or delete a context, navigate to Domain ‣ OX Contexts in the Management UI.

5.1.2. Users#

To add a user to OX App Suite, create a user account or update an existing one.

To create a user account:

  1. Navigate to Users ‣ Users in the Management UI.

  2. Select Add and the User template open-xchange groupware account.

  3. Select Next.

  4. Enter the required information. To enter additional attributes, select Advanced.

  5. Select Create user.

To update a user account:

  1. Navigate to Users ‣ Users in the Management UI.

  2. Select the username of the user account that you want to update.

  3. On the Apps tab, select the Open-Xchange checkbox. The Open-Xchange tab appears.

  4. Enter the user’s primary email address at General ‣ Primary email address (mailbox).

  5. Select Save.

See also

User management

in Nubus Manual 1.x [6] for information about user management in Nubus.

5.1.3. Groups#

The OX Connector app adds a group to the same context as the group members. When the last group member leaves the group, the connector removes the group from OX App Suite.

To enable a group for OX App Suite, follow these procedures:

To create a group:

  1. Navigate to Users ‣ Groups in the Management UI.

  2. Select Add.

  3. On the General tab, enter the required information and add users as group members.

  4. On the OX App Suite tab, select the Activate Group in OX checkbox.

  5. Select Create group.

To update a group:

  1. Navigate to Users ‣ Groups in the Management UI.

  2. Select the group that you want to edit.

  3. The Groups module in the Management UI automatically selects the Activate Group in OX checkbox when you edit a group. The Management UI displays a notification.

  4. To prevent OX provisioning, clear the Activate Group in OX checkbox on the OX App Suite tab.

  5. Select Save.

Warning

If you clear the Activate Group in OX checkbox while updating a group that exists in OX App Suite, the connector removes the group from OX App Suite.

To update a group from the command line, run the command in Listing 5.1. Replace GROUP_DN with the distinguished name (DN) of the group.

Listing 5.1 Update a group from the command line#
$ udm groups/group modify --dn GROUP_DN --set isOxGroup=OK

To remove a group from OX App Suite:

  1. Navigate to Users ‣ Groups in the Management UI.

  2. Select the group that you want to edit.

  3. On the OX App Suite tab, clear the Activate Group in OX checkbox.

  4. Select Save.

To remove a group from OX App Suite, run the command in Listing 5.2. Replace GROUP_DN with the distinguished name (DN) of the group.

Listing 5.2 Remove a group from the command line#
$ udm groups/group modify --dn GROUP_DN --set isOxGroup=Not

See also

Group management

in Nubus Manual 1.x [6] for information about group management in Nubus.

5.1.4. Access profiles#

The OX Connector provides access profiles for OX App Suite users. To view custom access profiles:

  1. Navigate to Domain ‣ LDAP directory in the Management UI.

  2. In the LDAP directory module, open open-xchange/accessprofiles/.

For limitations about plausibility verification, see No validation of access profile rights.

5.1.5. Functional accounts#

Deprecated since version 3.2.0: Open-Xchange deprecated this feature in favor of Shared accounts.

Added in version 2.0.0.

Functional accounts let users in the same context share a functional mailbox and its read status.

Use the oxmail/functional_account management module to add, update, or delete functional-account objects. When administrators grant a user permission, emails sent to functional-account addresses appear in the OX Mail view for that user.

Added in version 2.2.12.

The default directory position for oxmail/functional_account objects is: cn=functional_accounts,cn=open-xchange,$LDAP_BASE. Replace $LDAP_BASE with the LDAP base DN.

You can add default containers for oxmail/functional_account. The Management UI then prompts you to select a position when you create an object.

To add default containers:

  1. In the LDAP directory module, open the univention container.

  2. Open the default containers object.

  3. Select OX App Suite.

  4. Add containers to the Default container for OX functional accounts list.

Enter the distinguished names (DNs) of existing container objects. Each DN must include the LDAP base DN.

5.1.6. Resources#

Use OX Resources to manage bookable rooms and equipment. For more information about resource management, see App Suite Resource management [8].

To view resources, navigate to Domain ‣ OX Resources in the Management UI.