1NCE Home1NCE Shop1NCE Portal

Users & Organisation

Managing Users and Suborganizations.

Suggest Edits

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:

RoleDescription
OwnerInitial user of the organization that cannot be changed. Includes all functionalities and access to the entire organization. Can administer new users, admins and other owners. New users can have the Owner role assigned as well. The owner also has access to the Management API.
AdminIncludes all functionalities and access to the entire organization, has access to the user management, but can only administer users. This user role has no access the the Management API.
UserCan manage SIM Cards in the Portal, has no access to orders and top-ups, can not trigger new orders or manage users. This user role has no access to the Mangement API.
API UserUser 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.

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 Owners ✅ ❌ ❌ ❌ ❌
Administer Admins ✅ ❌ ❌ ❌ ❌
Administer Users ✅ ✅ ❌ ❌ ❌
Organisation See All ✅ ✅ ✅ ✅ ✅
Add Organisation ✅ ✅ ❌ ❌ ❌
SIM Transfer ✅ ✅ ❌ ❌ ❌
Performance See All ✅ ✅ ✅ ✅ ✅
Support See All ✅ ✅ ✅ ✅ ❌
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).

Updated about 9 hours ago