Integrate WSO2 IS

Enable Multi-Factor Authentication (MFA) using SMS One-Time Passwords (OTP) in your application by utilizing D7 API from WSO2.

Integration Steps

• Add MFA with SMS OTP

To configure a custom SMS provider, in the SMS Provider section click the Custom tab and fill the required fields.

SMS Provider URL: https://api.d7networks.com/messages/v1/send

Content Type: JSON

HTTP Method: POST

Headers: Authorization: Bearer YOUR_API_TOKEN_FROM_D7_DASHBOARD.( Get your API token from https://app.d7networks.com/api-tokens)

Payload Template:

{   
    "messages": 
    [     
        {         
            "originator": "WSO2",         
            "recipients": [{{mobile}}],         
            "content": "Your OTP code for login is: \{{body}},         
            "client_ref": "WSO2"          
        }     
    ]        
}

Please ensure to replace the originator with your registered sender id.

• Add MFA with WhatsApp OTP

For WhatsApp OTP, we currently use the custom SMS provider. To configure it, go to the SMS Provider section, select the Custom tab, and complete the required fields.

SMS Provider URL: https://api.d7networks.com/whatsapp/v2/send

Content Type: JSON

HTTP Method: POST

Headers: Authorization: Bearer YOUR_API_TOKEN_FROM_D7_DASHBOARD

Payload Template:

{
    "messages": [
        {
            "originator": "[phone]xx",
            "content": {
                "message_type": "TEMPLATE",
                "template": {
                    "template_id": "otp_test",
                    "language": "en",
                    "buttons":{
                        "actions": [
                            {
                                "action_index": "0",
                                "action_type": "url",
                                "action_payload": {{body}}
                            }
                        ]
                    }
                }
            },
            "recipients": [
                {
                    "recipient": {{mobile}}
                }
            ],
            "client_ref": "WSO2-WA"
        }
    ]
}

Please ensure to replace the originator with your registered WhatsApp number and the template_id with the ID of the template you’ve registered in the D7 User Dashboard.

• Enable MFA in Your Application

You can refer to the following link to enable MFA for your application in WSO2-IS: https://is.docs.wso2.com/en/latest/guides/authentication/mfa/add-smsotp-login/

• Verify Your Identity

Once enabled, customers will be able to verify their identity using their mobile number.

• Configure OTP expiry, alphanumeric characters, and OTP length settings.

1. Navigate to Connections.

2. Select SMS OTP > Setup > Settings.

3. Configure the desired settings for OTP expiry, alphanumeric characters, and OTP length.