How o M2M User

What is an M2M user?

A “machine-to-machine” (M2M) user is basically a "device". In automated communication, M2M devices are designed to communicate with each other autonomously, without requiring human input. They can send and receive data or instructions to perform tasks, monitor conditions, or exchange information with other devices. An M2M user in Eccairs2, will use the exposed API methods allowing to perform tasks related to Submitting reports.

Setting Up an M2M user

What permissions does a user need to have?

Before a user can setup a M2M user, a dedicated role (M2M CRUD) is to be assigned to him. It is the E2 Support Team that will add this permission to the National Security Administrator. This will be done for the first time that an M2M user is to be created in one of the Authority’s organisations.

How to access the M2M creation?

Depending on the user’s permissions, the Organisation management can be opened

As a M2M user can only exist in an existing Organisation, the organisation is to be opened in detail

How to add the M2M user to the organisation?

Although a M2M user is not the same as a human user, they are created in the same way.

By clicking on the “new user” button, the user create account window opens

Click on the M2M tab which will open the M2M user creation window. If the M2M is not visible, this indicates that the user willing to create the M2M user doesn’t have the permission (M2M CRUD role) assigned to him. This M2M CRUD role is either to be given by the E2 support Team for the first time or is to be given by the Authority’s nation security administrator.

1.     Is the name of the Authority in which the M2M user is created. This is prefilled and cannot be modified. It is the Authority of the user that creates the M2M user

2.     Is the name of the organisation in which the M2M is to be created

3.     Is the username, the username is automatically generated by the system. It ensures that the username is unique throughout Eccairs2. As this is an automatically assigned username, that means, when creating a M2M user for the same organisation in another environment it will not be the same

4.     Is the email address to where the activation email for the M2M will be sent. Often this is the email address of the person responsible for the M2M interfacing

5.     Before access to E2 is allowed via a M2M interface, E2 is to know the IP-address(es) of the machine(s) with whom it will communicate. Here only one IP address can be added. If more than one IP address is to be added, then this is to be done via the Authority settings.

6.     The role assigned to the M2M user, this is Automatically done by the system and cannot be changed. If this is empty, then a configuration error has occurred, and it is key to create a service desk ticket.

Frequently asked questions

How many M2M user can an organisation have?

Only one M2M is allowed per organisation. The access to E2 is given via the whitelisted IP addresses so no need for extra M2M users

Who will activate the account?

As with all accounts, an activation email will be sent to the email address mentioned in the M2M user’s profile (4). The activation email will be valid for 6 hours

What to do if a M2M activation code has expired?

In the event an M2M activation code expired (> 72 hours), the M2M user can no longer be activated by the user. The activation code can be resent following these steps

1.     Enable the M2M Account

2.     Open the ECCAIRS logon screen and click forgot password

 An email will be sent to the email address linked to the username, which is not necessarily the same as the user resending the activation email

 What if the email address of the M2M user changed?

Like with all other accounts, email addresses can easily be modified.