Obtain an authentication token

The system has to call a web service on the Mission Center with the learnerId to obtain an Authentication Token, which is a random and unique string (see documentation):

POST /api/learner-authorization/v1/learners/authToken
{
  "UserIdentifier": "46e11440-ea40-11e7-a88a-3d64957b0864"
}

The response should be either a 404 code if the learnerId has not been found, a 401 code if unauthorized or something like that:

{
  "authToken": "67ad8ef9452d5e7cda467238de7865facd765"
}

Which is the authentication token to be used in the next step.

Log the learner in the application

In order to log the learner in the application, the authentication token must be passed to the application by using a special function and by using the app bundle ID. Let's say your bundle Id is com.teachonmars.XXX, you can include this piece of code in your page:

function postAuthToken(authToken, isCreation = null) {
  post(`com.teachonmars.XXX://callback?name=autoLogin&authToken=${authToken}&profileCreation=${isCreation}`);
}
function post(url) {
  if (window.top == window) {
      window.location.href = url;
  } else {
      window.top.postMessage(url, "*");
  }
}

What you need to do now is call the postAuthToken function with the token, and the application will automatically log the learner in. For example:

<script type="javascript">
 var token = "67ad8ef9452d5e7cda467238de7865facd765";
 postAuthToken(token, true);
</script>

Log the learner in the web application

Instead of using the bundle ID, you will use this URL :

 https://XXX-webapp.teachonmars.com/login?authToken=