# Modular user management

You and your team want **secure** and sustainable access to your IoT solution, with **full insight** and **control**. To achieve this, assigning the right roles and permissions is essential.

To achieve this, assinging the right roles and permissions is done in **GRIP**. This **Identity and Access Management** platform is developed by KPN, specifically designed for Business Users. It enables organizations to **securely** and **efficiently** manage access to their applications and services.

To assign roles, you must be an **admin** of the account. As an administrator, you can add or remove users and configuratie roles and permissions for your services.

### Before you start

To manage users and roles, you need **admin rights**

* **Already an admin?** Great! Let’s get started!
* **Not an admin yet?** Ask your organization’s **administrator** to grant you admin rights\
  Not sure who that is? [Contact](https://docs.kpnthings.com/kpn-things/the-portal-explained/support/contact-info) us and we’ll help you out

## Access the User Management section

You can access **GRIP** in **three ways**.

1. Via [KPN Things Portal](#log-in-with-kpn-things-portal)
2. Via [MijnKPN Zakelijk](#log-in-with-mijnkpn)
3. Via [direct link](#log-in-using-the-direct-link)

### Via KPN Things Portal

{% stepper %}
{% step %}

1. Go to [portal.kpnthings.com/manager](https://portal.kpnthings.com/manager) or go to [KPN Things Portal](https://portal.kpnthings.com) and click on **Things Manager**&#x20;
2. Click on your **Company** in the menu
3. Click on **User Profiles** under Account

<img src="https://1453626848-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6RrePMSAjRvOgcHjMBZ%2Fuploads%2FoY8wfCEj6hAaOUcRwD1m%2Fuser%20management_things%20manager.png?alt=media&#x26;token=556b62d8-d05f-4ef6-aa1b-c95518ad4925" alt="" data-size="original">
{% endstep %}

{% step %}
Click on the **Manage Users** link shown above the users overview.

<img src="https://1453626848-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6RrePMSAjRvOgcHjMBZ%2Fuploads%2Fyw5KloWXn8IWmPrbNejy%2Fuser%20management_manage%20users.png?alt=media&#x26;token=131561c0-b742-4963-bfa4-af3e288f73ff" alt="" data-size="original">
{% endstep %}

{% step %}
For **documentation** about how to manage users click [here](#managing-users-in-grip)
{% endstep %}
{% endstepper %}

### Via MijnKPN Zakelijk

{% stepper %}
{% step %}
Go to [https://mijnkpnzakelijk.kpn.com](https://mijnkpnzakelijk.kpn.com/)
{% endstep %}

{% step %}
Log in and select **Company Details** in the menu and click on **User Management**

<div align="left"><figure><img src="https://1453626848-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6RrePMSAjRvOgcHjMBZ%2Fuploads%2FbPVoKddYnrcgZb291SXB%2Fmenu_manage%20users.png?alt=media&#x26;token=7db16b95-744d-4dcc-aeab-467b53277393" alt="" width="147"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
For **documentation** about how to manage users click [here](#managing-users-in-grip)
{% endstep %}
{% endstepper %}

### Via direct link

{% stepper %}
{% step %}
Go to [grip-on-it.com](https://grip-on-it.com/)
{% endstep %}

{% step %}
Log in and select **Users**

<div align="left"><figure><img src="https://1453626848-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6RrePMSAjRvOgcHjMBZ%2Fuploads%2FK2rZ8mehlM8kAfgBfS68%2Fgrip_users.png?alt=media&#x26;token=a88701f2-afb3-4179-825c-e66adbd6f01a" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
For **documentation** about how to manage users click [here](#managing-users-in-grip)
{% endstep %}
{% endstepper %}

## Managing Users in GRIP

The information below explains **how to manage users**, including adding and removing users, and managing roles and permissions.

Once you have accessed the **User Management** section in **GRIP**, you can perform several actions to **control access** within your organization.

### **What functionalities do you have**

**Review existing users, add and delete users**\
View the list of all users in your organization, including their roles and assigned services. Invite new team members by creating users accounts or deleting users who no longer need access to your services.

**Edit or give permissions to an added or existing user**\
Modify user information, roles and permissions to ensure they have the correct level of access to your services.

{% hint style="info" %}
**Why this matters**\
Managing users and permissions in GRIP ensures that only **authorized** individuals can access your applications and IoT services. This helps maintain **security** and **compliance** across your organization.
{% endhint %}

## Review existing users, add and delete users

In the User Management table, you can see all current users along with their assigned roles and permissions. This overview helps you quickly check who has access to which services.

**Add, Remove or Modify Users**

1. To add a new user, click **Add User** at the top of the page
2. To modify a user, click the **three dots** ⋮ and select **Edit**
3. To remove a user, click the **three dots** ⋮ and select **Deactivate** or **Delete**

<div align="left"><figure><img src="https://1453626848-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6RrePMSAjRvOgcHjMBZ%2Fuploads%2FcLFiWgaO52mL5pyEeLoD%2Fuser%20management_edit%20user.png?alt=media&#x26;token=f16f9e69-9470-4456-a059-bcfa079b7811" alt="" width="563"><figcaption><p>Modify users</p></figcaption></figure></div>

{% hint style="info" %}
To give you the opportunity to **reactivate** an account without having to create it again, a **deleted user** will remain visible in the overview for **10 days** before it is completely removed.
{% endhint %}

## Edit or give permissions to an added or existing user

For a **New User** you click on the **Add User** at the top of the page and provide the general information.

{% stepper %}
{% step %}

### **Provide the general information**&#x20;

1. Fill in the **general details** of the new user
2. Select the **Send email to set password option** to send a password email immediately. This can also be done at a later time, for example after you’ve configured all roles and permissions.
3. Click the **Add User** button

<img src="https://1453626848-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6RrePMSAjRvOgcHjMBZ%2Fuploads%2FDg6PDkfFxY2gddCq4fnZ%2Fgrip_create%20user.png?alt=media&#x26;token=ca8f2e10-88ab-4e0e-add7-878464906e01" alt="" data-size="original">

{% hint style="success" %}
If the user is a **contact** person for **operational matters**, it is advisable to provide a **phone number** and the correct **language** setting so that our **service desk** can reach you when needed.
{% endhint %}

After adding the user, the next screen opens where you can optionally enter **additional** information about the user. This information is **not required** for using your account, but it can be used for your own administration.

4. Add **additional** general details *(optional)*
5. Add even more information like **job title** or **office location** *(optional)*
6. Select the **preferred** language setting
7. Click the **Save Changes** button

<img src="https://1453626848-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6RrePMSAjRvOgcHjMBZ%2Fuploads%2Fqthos5EGkJfM4f9xndrg%2Fusers_user%20information.png?alt=media&#x26;token=49c3fc02-fb1f-4f5f-a98c-79c9ea77ed8c" alt="" data-size="original">
{% endstep %}
{% endstepper %}

### Assigning Services and Roles

{% stepper %}
{% step %}

### Select Services and Roles

1. Navigate to the **Services and Roles** tab
2. If the user should be able to **manage** other users, enable the **Admin** role
3. Click **Save Changes**
4. Click **+ Assign services and roles** button to add specific **services**

<img src="https://1453626848-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6RrePMSAjRvOgcHjMBZ%2Fuploads%2FIzNRdlvxjDkSu2DYQpc8%2Fuser%20management_users.png?alt=media&#x26;token=4d8886ce-bf4f-4642-a7e7-c4433a11ca60" alt="" data-size="original">

Select the **appropriate** services and roles based on the user’s **responsibilities**. The example below grants the user **full access** to the features within the KPN IoT solution.

<img src="https://1453626848-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6RrePMSAjRvOgcHjMBZ%2Fuploads%2FwmtHxNfh4Q4sy11iY1YE%2Fuser%20management_full%20roles%20set.png?alt=media&#x26;token=fa0e2b4c-f8ec-4b8d-88fd-21f3b1d09abb" alt="" data-size="original">

{% hint style="danger" %}
The **admin** is **responsible** for assigning the correct permissions to the user. Please note that someone with admin rights can also grant **themselves** additional permissions.
{% endhint %}
{% endstep %}
{% endstepper %}

## Services and Roles explained

The below list shows the **available roles** for services that are used within the **KPN IOT solution** and describes what **levels** of access each of the roles gives to the user in **KPN Things portal**.

<div align="left"><figure><img src="https://1453626848-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6RrePMSAjRvOgcHjMBZ%2Fuploads%2FgwTGaVPXs98UDfco6wVU%2Fuser%20management_zakelijk%20identity.png?alt=media&#x26;token=4950def4-b5d5-4d45-9426-aa822988e5e6" alt="" width="280"><figcaption><p>The central identity solution behind every account</p></figcaption></figure></div>

Provides the user with an **Admin** account to access and give **assigned services**.

<table><thead><tr><th width="219">Role</th><th width="273.666748046875">Description</th><th>Access</th></tr></thead><tbody><tr><td><sub>Admin</sub></td><td><sub>Full user management, including own account.</sub></td><td><sub>View and manage services and roles of other users; add, modify or remove users.</sub></td></tr></tbody></table>

<div align="left"><figure><img src="https://1453626848-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6RrePMSAjRvOgcHjMBZ%2Fuploads%2FF5anOnz7rKxMWFddGH3D%2Fuser%20management_things.png?alt=media&#x26;token=42372be5-1b1f-47bb-9880-352bbbe84364" alt="" width="280"><figcaption><p>The foundation for your IoT applications</p></figcaption></figure></div>

The starting point for your IoT service and manage the IoT solution.

We advise that every user has a **Things Manager** and **Things Support** role.

{% hint style="warning" %}
**Make sure to select only one role per item**\
If you choose multiple roles - such as *Thing Manager - Admin* and *Thing Manager - Read Only -* the lowest role will **override** the highest.&#x20;

In this example, you would only have **Read Only** access.
{% endhint %}

#### **Things Creator**

These roles are **only needed** if you manage your devices, decoders and scripts via KPN Things. If only connectivity features are used, these roles are not required.

<table><thead><tr><th width="217.888916015625">Role</th><th width="275.888916015625">Description</th><th>Access</th></tr></thead><tbody><tr><td><sub>Things Creator - Admin</sub></td><td><sub>Full access to Things Creator tab.</sub></td><td><sub>Add modify or remove devices types, decoders and scripts.</sub></td></tr><tr><td><sub>Things Creator - Read Only</sub></td><td><sub>Read-only access to Things Creator tab.</sub></td><td><sub>View device types, decoders, and scripts.</sub></td></tr></tbody></table>

#### **Things Manager**

We recommend granting the user at least **KPN Things - Read Only** access. This ensures insights into the IoT solution and enables options such as making exports of **connectivity** items available.

<table><thead><tr><th width="217.888916015625">Role</th><th width="275.888916015625">Description</th><th>Access</th></tr></thead><tbody><tr><td><sub>Things Manager - Admin</sub></td><td><sub>Full access to Things Manager tab.</sub></td><td><sub>Add, modify, or remove devices, flows, destinations and manage connectivity.</sub></td></tr><tr><td><sub>Things Manager - Editor</sub></td><td><sub>Full access except for deleting to Things Manager tab.</sub></td><td><sub>Add, modify, or remove devices, flows, destinations and manage connectivity except the right to delete.</sub></td></tr><tr><td><sub>Things Manager - Read Only</sub></td><td><sub>Read only access to Things Manager tab.</sub></td><td><sub>View devices, flows, destinations and connectivity.</sub></td></tr></tbody></table>

#### **Things Support**

We advise that **every** user has access to this role in order to see important **documents** and access to links to **contact** information and **ServiceNow** be able to log tickets. Assigning this role also **subscribes** you to **service emails.**

{% hint style="danger" %}
To be able to log tickets in ServiceNow also the **ICT Manager** role must be granted in **Self Service Portal**.
{% endhint %}

<table><thead><tr><th width="217.888916015625">Role</th><th width="275.888916015625">Description</th><th>Access</th></tr></thead><tbody><tr><td><sub>Things Support - User</sub></td><td><sub>Access to the Things Support tab.</sub></td><td><sub>View news, release notes, documents, service status, reports and contact info and recieve service emails.</sub></td></tr></tbody></table>

<div align="left"><figure><img src="https://1453626848-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6RrePMSAjRvOgcHjMBZ%2Fuploads%2FhL6gScS5Wwo49MsVUGBZ%2Fuser%20management_self%20service%20portal.png?alt=media&#x26;token=eb5e4c79-7afc-43fe-9bde-d0736b35ca12" alt="" width="280"><figcaption><p>Provides access to the Service Portal for reporting incidents and service request</p></figcaption></figure></div>

The **Self Service Portal** allows users to register and track **tickets** for incidents, information requests, change requests, and complaints. We recommend granting access to all users and ensuring each user profile includes the correct **phone number** and **language setting** (found under the Location section in User Settings).&#x20;

{% hint style="warning" %}
The **'Things Support - User'** role must be assigned to access the **Self Service Portal** via [**Support tab**](https://docs.kpnthings.com/kpn-things/the-portal-explained/support/support-tickets) in the KPN Things Portal.&#x20;
{% endhint %}

<table><thead><tr><th width="219">Role</th><th width="273.666748046875">Description</th><th>Access</th></tr></thead><tbody><tr><td><sub>ICT Manager</sub></td><td><sup>Access to Self Service Portal.</sup></td><td><sup>Register and track tickets for incidents, information requests, change requests and complaints.</sup></td></tr></tbody></table>

<div align="left"><figure><img src="https://1453626848-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6RrePMSAjRvOgcHjMBZ%2Fuploads%2F2xeCd4m2OywT1RKQrpSX%2Fuser%20management_webshop.png?alt=media&#x26;token=4b3bad2b-3bdc-448b-8b3c-4b8637d97312" alt="" width="280"><figcaption><p>Provides access to te KPN Webshop</p></figcaption></figure></div>

Grants the user access to the **KPN Webshop**. If any of the webshop-related roles are assigned, the **Shop** tab will automatically become visible and accessible in the **KPN Things Portal**.

<table><thead><tr><th width="219">Role</th><th width="273.666748046875">Description</th><th>Access</th></tr></thead><tbody><tr><td><sub>Forecasting</sub></td><td><sub>Enables forecasting functionality.</sub></td><td><sub>Enables product forecasting for specific calendar periods, allowing KPN to align stock levels with expected demand</sub></td></tr><tr><td><sub>Quotation</sub></td><td><sup>Enables ordering and requesting quotations.</sup></td><td><sup>Enables to order products and request quotations for items that are not currently covered by an existing contract. Additionally, user can view the status and history of their orders.</sup></td></tr><tr><td><sub>Read Only</sub></td><td><sup>Read only access of products and prices.</sup></td><td><sup>View product details and prices, order status and order history.</sup></td></tr><tr><td><sub>Voucher Manager</sub></td><td><sup>Manage discount vouchers.</sup></td><td><sup>Process discount vouchers.</sup></td></tr></tbody></table>

{% hint style="warning" %}
Please note that you **must have** at least the **Quotation** role assigned to be able to **place orders**.
{% endhint %}

<div align="left"><figure><img src="https://1453626848-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6RrePMSAjRvOgcHjMBZ%2Fuploads%2FpmG9BdBrBi5Sqk6z9m3K%2Fuser%20management_zakelijk.png?alt=media&#x26;token=08fcb726-ee18-47c9-acc6-fead530506fd" alt="" width="280"><figcaption><p>Provide access to MijnKPN Zakelijk functions</p></figcaption></figure></div>

This provides the **user** with access to the **MijnKPN Zakelijk** service portal. It gives **access** to the available **services**.

<table><thead><tr><th width="219">Role</th><th width="273.666748046875">Description</th><th>Access</th></tr></thead><tbody><tr><td><sub>Facturen (Invoices)</sub></td><td><sup>View invoices in PDF format.</sup></td><td><sup>Allows user to view all invoices in PDF format that are linked to the same KPN Reference Number (KRN), which is your company’s unique identifier within KPN.</sup></td></tr></tbody></table>
