User Management

The 1NCE Customer Portal offers the option to create multiple user accounts which allows for different user roles and access rights. In the "User" tab a root owner of the account can create and edit new user accounts. A general overview of all current users of the 1NCE organization is provided in a list view.

1255 — List view of all current active user accounts of the organization.

User Roles

The following roles for additional user accounts are available:

Role	Description
Owner	Initial user of the organization that cannot be changed. Includes all functionalities and access to the entire organization. New users can have the Owner role assigned as well. The owner also has access to the Management API. Can administer users with Admin, User, API User, Read Only, and 3rd party access role. To administer Owner, please submit a service request.
Admin	Includes all functionalities and access to the entire organization. Can administer users with User, API User, Read Only, and 3rd party access role. This user role has no access the Management API.
User	Can manage SIM Cards in the Portal, but has no access to orders and top-ups, and cannot trigger new orders or manage users. This user role has no access to the Mangement API.
API User	User role only for accessing the 1NCE API. Uses client_secret and client_id as username and password for the API authentication. Has the account number as prefix in the client_id. All endpoints are available for this role including new orders.
Read Only	User role designed to allow Read-only access to the Portal. This user role has no access to the Mangement API.
3rd party access	User role designed for allowing 3rd Party Users limited access to the Portal. This user role has no access to the Mangement API.

User Roles Details

See the following table for an exact overview of the roles and the permissions for each component of the 1NCE Portal.

Portal Areas		Owner	Admin	User	Read Only	3rd Party Access	API User
Dashboard	See All	✅	✅	✅	✅	✅	❌
	Reorder Button	✅	✅	❌	❌	❌
	Latest Order Widget	✅	✅	✅	✅	❌
My SIMs	See All	✅	✅	✅	✅	✅
	SIM State	✅	✅	✅	❌	❌
	IMEI Lock	✅	✅	✅	❌	❌
	Auto-Top-Up	✅	✅	❌	❌	❌
	Reset Connectivity	✅	✅	✅	❌	✅
	SIM List Export	✅	✅	✅	❌	✅
	Reorder / Top-Up	✅	✅	❌	❌	❌
	Send SMS	✅	✅	✅	❌	✅
Configuration	Network Settings	✅	✅	✅	❌	✅
	Breakout Settings	✅	✅	❌	❌	✅
	Monthly Limit	✅	✅	✅	❌	✅
	IMEI Lock	✅	✅	✅	❌	❌
	Auto-Top-Up	✅	✅	❌	❌	❌
	Data Streams	✅	✅	❌	❌	✅
	SMS Forwarder	✅	✅	✅	❌	✅
	OpenVPN	✅	✅	✅	❌	✅
	Management API	✅	✅	✅	❌	✅
1NCE OS	Tab Available	✅	✅	✅	✅	✅
Account	See All	✅	✅	✅	✅	✅
	Customer Data	✅	✅	❌	❌	❌
	User Data	✅	✅	✅	✅	✅
	Add New E-Mail	✅	✅	❌	❌	❌
	Billing and Shipping Address	✅	✅	❌	❌	❌
	Payment Details	✅	✅	❌	❌	❌
Orders	See All	✅	✅	✅	✅	❌
	Download Invoices	✅	✅	✅	✅	❌
	Trigger New Order	✅	✅	❌	❌	❌
	Download Affected SIMs	✅	✅	✅	✅	❌
Users	See All	✅	✅	✅	✅	✅
	Administer Own User	✅	✅	✅	✅	✅
	Administer Owner	❌	❌	❌	❌	❌
	Administer Admin	✅	❌	❌	❌	❌
	Administer User	✅	✅	❌	❌	❌
Administer API User	✅	✅	❌	❌	❌
Administer Read Only	✅	✅	❌	❌	❌
Administer 3rd party access	✅	✅	❌	❌	❌
Organisation	See All	✅	✅	✅	✅	✅
	Add Organisation	✅	✅	❌	❌	❌
	SIM Transfer	✅	✅	❌	❌	❌
Performance	See All	✅	✅	✅	✅	✅
Support	See All	✅	✅	✅	✅	❌
Support	New Service Request	✅	✅	✅	❌	❌
API Access		✅	❌	❌	❌	❌	✅

User Creation

A new user can be created using the "New User" button on the top right. The mandatory details depend on the type of the user that needs to be created. The e-mail address is used for the confirmation of the account as well as the login name for the 1NCE services. Customers have to make sure that the entered e-mail address is valid and can receive messages. After creating a new user an e-mail is sent to the new mail address requesting to set an initial new password for the 1NCE Customer Portal.
For the API role, the client_id represents the username and the client_secret the password. The client_id has the account number with an underscore as prefix. The client_secret needs to be set during the user creation as there is no e-mail address attached to this user role.

1131 — New User popup for creating a new user and attaching a user role.

User Account Alteration

By clicking on a user shown in the list of current users, the details of this account can be changed or deleted. Changes can be applied by editing the boxes in the form and saving the new data. A user can be deleted by clicking on the "Delete" button in the Edit User popup.

1132 — User Edit popup windows used for editing user details or deleting a user.

Organization Management

❗️
AWS Marketplace Accounts
Please note that Organization Management is not available for AWS Marketplace accounts.

In the "Organisation" tab, a list of all sub-organizations of the main 1NCE user account are shown and can be managed. This feature enables a customer to create independent organizations, e.g., for their subsidiary or sub-contractor.

1701 — The Organisation tab shows a list view of all sub-orgs of the current 1NCE user account.

Organisation Creation

Creating a new organization requires the role Owner or Admin to be logged in. To create a new organization, users have to click on the "New Organisation" button in the top right corner of the page. The creation process of a new organization is structured in a few simple steps. All the required data have to be entered in the shown forms.

3362 — Multi-step process of creating a new sub-organization.

After validating the content summary and submitting the request, the new owner will be notified and asked to set up their password via e-mail, so that they can access the customer portal. Please note that the process of creating a sub-organization will not be finalized until the new owner has set the password.
All existing features are active for the new organization. An order of SIM cards can be placed in the new organization by using the "Reorder" button on the dashboard and go through the regular ordering process. Alternatively, the master organization can order the SIM cards and transfer them to the sub-organization afterwards. The master organization can see the total number of SIMs ordered by each organization, but without having direct access unless a dedicated account has been created by the sub-org entity.

Organization SIM Transfer

If there are any sub-organizations, the "Organization" tab also offers the possibility to transfer SIMs from the master organization and vice versa. A direct transfer from sub- to sub-organization is not possible. The transfer of SIMs can also be done using the 1NCE API. Customers can transfer just one single SIM, a range of SIMs, or several ranges of SIMs. Here are some helpful tips for transferring several ranges:

The file with the ranges can either be .CSV or .TXT format
Single SIM ICCID, use the ICCID as Start- and End Range like “ICCID1;ICCID1”
Ensure no duplicate ICCID in the file as this will lead to errors in processing
Do not put a semicolon at the end of each line
There is no need to use quotation marks at all (not mandatory)

1111 — SIM transfer dialog for transferring SIMs to other sub-organizations.

Sub-Organization Deletion

Sub-Organizations can be deleted directly from the portal. To delete an organization customers have to choose the respective sub-organization and click "Delete". A sub-organization can only be deleted after it is fully created and has no SIMs or open workflows running (e.g. open invoices or open SIM actions).

Users & Organisation

User Management

User Roles

User Roles Details

User Creation

User Account Alteration

Organization Management

❗️
AWS Marketplace Accounts

Organisation Creation

Organization SIM Transfer

Sub-Organization Deletion

User Management

User Roles

User Roles Details

User Creation

User Account Alteration

Organization Management

❗️AWS Marketplace Accounts

Organisation Creation

Organization SIM Transfer

Sub-Organization Deletion

❗️
AWS Marketplace Accounts