Manage Local Users in Studio

Last update: Edit

1 Introduction

Mendix gives you various ways to manage your App’s users.

With Mendix Studio Pro, you can configure an Administrator account directly in your security settings. See Administrator for more information.

With Mendix Studio on Tencent Cloud, it’s also possible to directly publish your app to your deployment environment and manage your app’s users locally from there. For your convenience, we’ve included the “Administration” module in the starter app template to make that happen. This article guides you through accessing this and managing users.

2 Accessing the Administrator Account

For each app published from Mendix Studio on Tencent Cloud, a default administrator user is created.

2.1 Administrator Properties

In the Administrator tab the following properties are available:

  • User name
  • Password
  • User role

2.1.1 User Name

The user name is used to sign into the application as the Administrator. Default: MxAdmin

2.1.2 Password

The password is used to sign into the application as the Administrator. You can change the password from the Developer Portal after publishing your app.

2.1.3 User Role

The user role assigned to the Administrator. For more information, see Security, Roles & Permissions. Default: Administrator

2.2 Changing the Default Administrator Password

You will want to change the default administrator password to allow you to log in and manage the users within your app.

To do this, follow the steps below:

  1. Go to the Environment details page of your app by opening the Developer Portal, selecting your app, and clicking Environments.

  2. Choose the environment where your app is published, and click Details.

  3. Open the General tab on the Environment Details page.

    You will see information about your running app. Most of the information is self-explanatory, but the status information gives you a quick summary of the status of the environment and the app deployed there.

    There are also buttons which allow you to perform various actions on your app and environment.

  4. Click Change Admin Password.

  5. Enter and confirm a New Password for the local admin user in your app.

    This enables you to change the password without having to change it in Studio Pro and redeploy the app.

  6. Click Apply Changes to enable the new password.

3 Managing App Users

Using your freshly updated login credentials, you are ready to start managing your users. The Administration module is included in every new blank app. This section describes how to log into your newly published app and visit the User Administration section.

3.1 Introduction

The Administration module, which is included in every new blank app, contains administration functionality to manage App Users and to see App statistics like runtime information, sessions and schedules events.

The administration module allows the following functions:

  • Management of User Accounts
  • Read-only overview of:
    • all active sessions
    • all schedules events
    • all runtime instances
    • Runtime statistics

3.2 Accessing User Management

This section describes how to access the user management screen(s) from the Administration module included in your Mendix App.

  1. Open your newly deployed app using its App URL

  2. Log in with the default Admin username and your newly changed Admin Password.

  3. Select the User Management option from your App’s navigation menu. You will see this option because you are logged in as administrator.

3.3 Managing User Accounts

This section describes how to create and manage user accounts from the Administration module as embedded in your Mendix App.

3.3.1 Creating a New Local User

Local users, their personal information, and authentication details are maintained within entirely within your Mendix app

Click New local user in the User Management Overview and fill out the required fields to create a new local user.

Under User role, select the appropriate role. Your app is configured by default with the Administrator and User roles.

3.3.2 Editing an Existing Local User

Select the user’s row in the overview and click Edit to edit an existing local user.

Change the user properties where necessary and click Save.

3.3.3 Creating or Editing Web Service Users

To access web services published by your app, other apps may need to authenticate themselves with your Mendix App.

The User Management Overview allows you to create Web Service Users. These are users which do not log into your app, but allow other (Mendix) apps to connect to your Mendix App when publishing Web Services. You can create dedicated a web service user account for each consumer of your Mendix App’s Web Services.

Simply select New web service user in the User Management Overview and fill out the required fields.