The OutSystems Platform provides the Users application for you to create, update, and delete end-users (users of your applications) and their roles. It also allows you to manage roles individually or in bulk by using groups.

Throughout this topic the term user refers to "users of your applications".

Managing Users

To open the Users application simply type http://<Server Name>/Users in your Web browser.

By default, the credentials are "admin/admin", and you should change them when you first access the application.

Creating a New User

To create a new user, simply go to the Users tab and click the 'Create a new User'. After filling in the user details like username, password and email, you can assign roles to the user, or add it to a group.

A user can be disabled, this prevents the user to log in and suspends all the permissions granted. To disable a user, in the user details screen, click the 'Set as Inactive' link. You can enable the user by following the same procedure, and choosing 'Set as Active'.

To permanently delete a user go to the edit screen, and on the right-hand side, click 'Delete this User'.

Assigning a Role to a User

Roles are created when you design your application, and allow you to grant access to functionality implemented in the applications: grant access to an application, specific screens, or specific tasks. Learn more About Roles.

Once your application is deployed, you can control which users have which roles: in the Users application, find and click the user to edit the details. Then simply choose one of the existing roles in the 'Roles' details.

In the example above, jamie.foster has been assigned with the ExpensesFinancialController role. This grants her access to approve expense reports in the Expenses application.

Using Groups

When creating a new user, it is often necessary to assign multiple roles to grant the user the necessary permissions. This takes time, specially when creating users in bulk.

Instead of manually assigning roles to users, you can create a Group of users and assign it the necessary roles. Then add and remove users to the group to grant these users with those permissions.

The 'Groups' tab allows you to:

Programmatic End-User Management

When integrating OutSystems Platform, it's common to perform end-user management in a centralized system. For this, The OutSystems Platform provides the Users API, an API exposed as an OutSystems application.

This makes it possible to develop your own applications to manage end-users directly or expose APIs to external systems using Web Services.

User Management in Multi-Tenant Applications

When developing Multi-tenant applications you have to ensure that:

Letting users from different tenants have the same username will make your login process inconsistent.

Learn more about End-User Management in Multi-tenant applications.

See Also

About Roles | About End-User Authentication | Users API | About Multi-Tenancy