CodeB enables the mobile device, with installed CodeB Apps, to function as the Identity Provider (IdP). To procure a Bearer Token directly from the mobile device using the OTT mechanism, the “MobileToken” Web Services API is essential.
API Endpoint:<BaseURL>/ws/mobile.asmx?op=MobileToken
Demo Server Example:https://auth.codeb.io/ws/mobile.asmx?op=MobileToken
Required Parameters:
- phoneNumber: Specifies the international phone number of the device equipped with the CodeB App.
- BindingPIN: Implemented by CodeB for spam protection, it prevents unauthorized parties from sending pop-up messages to mobile devices. It must be configured in the CodeB App’s OIDC Settings and adds an extra encryption layer to the OTT Message. The message is delivered only if the BindingPIN matches the one in the CodeB App.
Result:
The API returns an encoded JSON Web Token, ensuring secure and precise token acquisition directly from the mobile device.
Sample encoded JSON Web Token:
eyJrdHkiOiJSU0EiLCJlIjoiQVFBQiIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2IiwibiI6InNHVkJrcDJhdFJVYjZyZ25Ic3RYR3ZUYVNVSF9UcHZhTkgwRzM4aWdxWWpHdTk1NzRHQXNlREZ4NUVuX0xWN3d3Yklua00xRXVjS2p5ZHl2cER4c1FZM2I3UXVKd05zclk2LUdmVno5OFhtMmo4eldRZjQ0SldKRnFYV1M2amtkRjhOeEQ0YkpNU2JmbnhORExKUzFwRXIxZzh5N1duRnNpNURsMHhsYUdxMHlNU0tmX2U1aE5WTmk5MGFGYWFuNFRxR2hWNTcwZm10Wnp6MHZJSTQ4V0RqOExoM3ppMDU1UW0wODFfaE1CT0tDTDVpYUJrZzlwb3RXd19DZ0N2OHRlZWJJMVd4VzN4NGgzZVROaGktWUFmNVdOaXF0bGwxWllHeXlNY2VTQ01tRFNIWG51bXRIdVhRaWFYQS16ZzA2WkVYNjI3Z2p5UjUtdFp2MjBsMEdDdyJ9.eyJhcHAiOiJzbXMiLCJhdF9oYXNoIjoiTlBzY2NyeVhhVGZRcFpoSkZnZEd6ZyIsInZlciI6IjEuMCIsInNvY2lhbElkcFVzZXJJZCI6IkYyOTFBMjQ5IiwibUF1dGhJZCI6IjBiMDczNGRhYzBiMDRiZTg5Y2Y0NjIxYTgzYTQ2YjAzIiwicHJlZmVycmVkX3VzZXJuYW1lIjoiRjI5MUEyNDkiLCJuYW1laWRlbnRpZmllciI6IkYyOTFBMjQ5IiwiZ2l2ZW5fbmFtZSI6IlN0ZWZhbiIsIm5vbmNlIjoiMjI2MDgiLCJjbGllbnRfaWQiOiJDb2RlQiBXZWIgU2VydmljZXMiLCJjX2hhc2giOiJOUHNjY3J5WGFUZlFwWmhKRmdkR3pnIiwibmJmIjoxNjk1ODUwMjcwLCJlbWFpbF9hZGRyZXNzIjoic3RlZmFuQGNvZGViLmlvIiwiaWRwIjoiQ29kZUIgU01TIiwiYXpwIjoiQ29kZUIgV2ViIFNlcnZpY2VzIiwiYXV0aF90aW1lIjoxNjk1ODUwNDUwLCJuYW1lIjoiU3RlZmFuIEVuZ2VsYmVydCIsIm5pY2tuYW1lIjoiU3RlZmFuIiwicGhvbmVfbnVtYmVyIjoiMzU2Nzk1NjcwMzQiLCJpZCI6IkYyOTFBMjQ5Iiwic3RhdGUiOiIyMjYwOCIsImZhbWlseV9uYW1lIjoiRW5nZWxiZXJ0IiwianRpIjoiMTAwNTEiLCJzdWIiOiJGMjkxQTI0OSIsImlzcyI6Imh0dHBzOi8vd3d3LmNvZGViLmlvIiwiYXVkIjoiQ29kZUIgV2ViIFNlcnZpY2VzIiwiaWF0IjoxNjk1ODUwNDUwLCJleHAiOjE2OTU5MzY4NTB9.QScgY_Wtbcjwfu0qzPW7gawtMpZXAvuhCndu6js9JOe9NE-llGMpHihmcUGwiS6GEYXFIzxMsts59fS2UUWCNJ1SoAQfIalD7YXUveTyc9D4mShhBrsG1epYJzGe1mtzjeRnI5DO7sDbWwT_fgrX6eEQAATpi_Z2HHMNuQxigkzgIl6KHamEwAsNLf5X79ZP6oo1cnLdHLZCuuqlmcsBpJn5eXZE-yMFKTM1MQ1DZL3HBkbuyM3WTTf_HyOzp8qeW9jmHIRtT4naVErMx0KK09TQp6M65ogDEi6HdBNgl4fobMJU1pAfCOfbapg2ozPxJ9w9zL0NtUxa4OmxpHW-Ng