Ubuntu

This connectivity package provides support for managing users and groups in Ubuntu Linux.

Supported objects and operations

System objects	Omada Identity Data Model	Operations
Users	Accounts	Create, read, update, delete
Password	Accounts	Set and reset
Ubuntu Primary and Secondary Groups	Resource	Read
Ubuntu Primary Group Assignments	Resource assignment	Create*, read, delete
Ubuntu Secondary Group Assignments	Resource assignment	Create, read, delete

(*) Omada is not configured to change the primary groups of users. Instead, it is designed to grant another user access to a primary group.

Minimum required permissions

Sudo privileges may be necessary for certain tasks. You will also need userID and password for SSH authentication.

Implementation notes

1. The account status is determined based on the Account expires date obtained from the chage command. If other authentication methods are used that do not adhere to this expiration date, extend the scripts to read and manage the account status correctly.
2. By default, Omada reads both primary and secondary groups in Ubuntu. To exclude primary groups, add the following expression to your queries and mappings. Go to Resources > Parameters > Filter, and enter groupType=="Ubuntu Secondary Group.
3. By default, Omada retrieves the assignments between Ubuntu primary group and users. If you prefer not to import this information into Omada, disable the queries and mappings related to Ubuntu primary group - resource assignments.
4. In Ubuntu, a new group is created with the same name as the user. This group is known as the user's primary group.
5. In Ubuntu, the newly created user is added to their corresponding group as their primary group.
6. In Ubuntu, a home directory for the new user is created. By default, this directory is located at /home/username, where username is the name of the new user.
7. In Ubuntu, the new user is assigned a default shell, usually /bin/bash, unless otherwise specified.

Primary group	Secondary group
The main group associated with a user. Storage: Defined in /etc/passwd. Usage: Default group for file and directory creation.	Additional groups a user can belong to. Storage: Listed in /etc/group. Usage: Provide extra permissions and access.

Network requirements

Standard TCP port 22 for SSH or any other port configured for the SSH server.

---

Prerequisites

None.