SMPP to CIMD2 gateway

Ozeki CIMD2 gateway can be used by SMS service providers to serve multiple customer using SMPP SMS clients. In this guide, we show you how to setup an authentication provider to create SMPP client accounts automatically.

Step 1 - Add new connection

The first step is to connect to the CIMD2 service provider. To do this, you need to create an CIMD2 client connection. Click on the "Add new connection ..." as you can see on the Figure 1.

add new connection
Figure 1 -Add new connection

Step 2 - CIMD2 Client connection

Select the CIMD2 Client connection from the list and click Install (Figure 2).

cimd2 client connection
Figure 2 - CIMD2 Client connection

Step 3 - CIMD2 client user data

Now enter the contact details like Host, port, username and password. And enter the phone number that the SMS Gateway uses to send the message. Finally click on the OK button (Figure 3).

cimd2 client user data
Figure 3 -CIMD2 client user data

Step 4 - Client Connected

Next step is to enable the connection. If the connection is established with the service provider you can see the green pipe ikon (Figure 4).

client connected
Figure 4 - Client Connected

Step 5 - Open Control Panel

We then need to establish a database connection so that we can authenticate users through the database. Open the Control Panel from the Start menu (Figure 5).

open control panel
Figure 5 - Open Control Panel

Step 6 - Create new Connection

In the Control Panel click on the Create new Connection button and select the Application type (Figure 6).

create new connection
Figure 6 - Create new Connection

Step 7 - Database conncetion

Then select the Database application type (Figure 7).

database conncetion
Figure 7 - Database conncetion

Step 8 - SQL queries type connection

Now select the SQL queries type (Figure 8).

sql queries type connection
Figure 8 - SQL queries type connection

Step 9 - Mysql connection

In this description we are now using a Mysql database so we choose the Mysql type but you choose the database in which your users are stored (Figure 9). The connection method is very similar for all database types.

mysql connection
Figure 9 - Mysql connection

Step 10 - Provide database connection details

In the Connection details page provide the server IP address, the port, the database name the UserID and the users Password then click on the OK button (Figure 10).

provide database connection details
Figure 10 - Provide database connection details

Step 11 - Database connected

In teh Connection page you can see if the database connection is established (Figure 11).

database connected
Figure 11 - Database connected

Step 12 - Open Advanced menu

The next step is to create an authentication provider for the users. To do this, click the Advanced button on the SMS gatway home page (Figure 12).

open advanced menu
Figure 12 - Open Advanced menu

Step 13 - Create new Authentication povider

In the advanced menu, select the Authentication providers section and click the Create new Authentication provider button. Then select the Database option (Figure 13).

create new authentication povider
Figure 13 - Create new Authentication povider

Step 14 - Specify SQL query

On the Authentication provider details page, select the previously created database connection and enter the SQL query what is used for authenticate the users (Figure 14).

specify sql query
Figure 14 - Specify SQL query

Step 15 - User database table

In this example, we use the database table shown in Figure 15 to store users.

user database table
Figure 15 - User database table

Step 16 - Create new Service

Now create the SMPP service that clients can connect to. In the advanced menu, select the Services section and click the Create new Service button (Figure 16).

create new service
Figure 16 - Create new Service

Step 17 - Create SMS Service

Select SMS service option (Figure 17).

create sms service
Figure 17 - Create SMS Service

Step 18 - SMPP Service

And then the SMPP type (Figure 18).

smpp service
Figure 18 - SMPP Service

Step 19 - Specify Connection details

On the SMPP Details page, enter the System ID of the service and the port you will use (Figure 19).

specify connection details
Figure 19 - Specify Connection details

Step 20 - Set authentication method

Then, on the Advanced tab, in the User authentication section, select the database authentication mode you created earlier and click OK (Figure 20).

set authentication method
Figure 20 - Set authentication method

Step 21 - SMPP service created

In the service menu you can see that the SMPP service is created. Click the Details button (Figure 21).

smpp service created
Figure 21 - SMPP service created

Step 22 - SMPP clients connected

On the events tab, you can see that clients have successfully connected using database authentication (Figure 22).

smpp clients connected
Figure 22 - SMPP clients connected

Step 23 - Users created

On the main page of the SMS Gateway, it can be seen that a separate SMPP User has been created for each client (Figure 23).

users created
Figure 23 - Users created

Step 24 - Message received from SMPP

When an SMS is received from a client, it is displayed on the corresponding user events tab (Figure 24).

message received from smpp
Figure 24 - Message received from SMPP

Step 25 - Message sent in CIMD2

The events tab of the CIMD2 connection shows that the sms was sent to the service provider using the CIMD2 protocol (Figure 25).

message sent in cimd2
Figure 25 - Message sent in CIMD2

More information