Users & Organisation
Managing Users and Suborganizations.
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.
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 | ✅ | ✅ | ✅ | ✅ | ❌ | |
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.
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.
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.
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.
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)
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 2 months ago