Skip to content

Java server side library created to improve security of the Mobile Connect solution

License

Notifications You must be signed in to change notification settings

hmunnin/java_server_side_library

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GSMA MobileConnect Java Server Side Library

Mobile Connect is a mobile identity service based on the OpenID Connect & OAuth2 where end users can authenticate themselves using their mobile phone via Mobile Connect. This allows them access to websites and applications without the need to remember passwords and usernames. It’s safe, secure and no personal information is shared without their permission.

Note: if you operate in the EU then you should use EU Discovery Service domain in discovery URL: eu.discover.mobileconnect.io

Quick Start

  1. Clone reporitory

  2. Open the configuration file [local path]\mobile-connect-demo\src\main\resources\config\OperatorData.json for setup the SDK using discovery and set 11 parameters:

{
  "clientID": your client Id,
  "clientSecret": your client Secret,
  "clientName": your client Name,
  "discoveryURL": your Discovery endpoint,
  "redirectURL": "<protocol>://<hostname>/server_side_api/discovery_callback",
  "xRedirect": "True",
  "includeRequestIP": "False",
  "apiVersion": api version: "mc_v1.1", "mc_v2.0" or "mc_di_r2_v2.3",
  "scope": scope,
  "acrValues":  acr_values,
  "MaxDiscoveryCacheSize": max cache size
}
  1. Open the configuration file [local path]\mobile-connect-demo\src\main\resources\config\WithoutDiscoveryData.json for setup the SDK in without discovery mode and set 17 parameters:
{
  "clientID": your client Id,
  "clientSecret": your client Secret,
  "clientName": your client Name,
  "discoveryURL": your Discovery endpoint,
  "redirectURL": "<protocol>://<hostname>/server_side_api/discovery_callback",
  "xRedirect": "True",
  "includeRequestIP": "True",
  "apiVersion": api version: "mc_v1.1", "mc_v2.0" or "mc_di_r2_v2.3",
  "scope": scope,
  "acrValues": acr_values,
  "MaxDiscoveryCacheSize": max cache size,
  "operatorUrls": {
    "authorizationUrl": authorize endpoint,
    "requestTokenUrl": token endpoint,
    "userInfoUrl": userinfo endpoint,
    "premiumInfoUri": premiuminfo endpoint,
    "providerMetadataUri": provider metadata endpoint
  }
}
  1. Open sector_identifier_uri.json file and specify the value of sector_identifier_uri with a single JSON array of redirect_uri values.
["<protocol>://<hostname>/server_side_api/discovery_callback"]
  1. Download and install any missing dependencies.

  2. Build the server side SDK using Maven repository:

cd java-server-side-sdk
mvn clean package
  1. Deploy mobile-connect.war

  2. Prepare client side application (IOS or Android application) or Demo App for Server Side application.

Support

If you encounter any issues which are not resolved by consulting the resources below then send us a message

Resources

About

Java server side library created to improve security of the Mobile Connect solution

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 99.4%
  • HTML 0.6%