Page tree

Are you looking for the latest documentation for the current versions of Nexus' products?

__

Skip to end of metadata
Go to start of metadata

This article describes requirements on a content provider that shall be used to store authentication images or card layout images for mobile virtual smart cards in 4.6 - Nexus Personal Mobile.  

General requirements

To use a content provider with Hermod, to provide authentication images or card layout images on a mobile virtual smart card, the following requirements apply:

  • The connection to a content provider must be set up in the Hermod client. See Add API user and callback URL in Hermod
  • The content provider must have an API, according to the specification below. 

POST /getcontent 

The content provider API must include a POST request for getting the image data, according to this specification. 

Method

POST

Body

The content provider API must accept the following JSON data, where the contentId value can for example be a <uuid>:

Example: POST /getcontent command
{
   "contentId":"67d21afb-e830-4fee-a691-00a997ffbe1a"
}


Recommendation

To simplify the implementation of the content provider service, "contentId" can also define the specific use case, by combining the unique identifier <uuid> with another string, such as "PROV:<uuid>" for provisioning mobile virtual smart cards with visual ID and "AUTH:<uuid>" for authentication images.


Example response for card layout images

The content provider API must return the following JSON data: 

Example response
{
   "data":[
      {
         "content_encoding":"base64",
         "content_type":"image/jpeg",
         "key":"front",
         "data":"VmVyaWZpZXJh......ZW4gw6RyIHLDpHR0"
      },
      {
         "content_encoding":"base64",
         "content_type":"image/jpeg",
         "key":"back",
         "data":"VmVyaWZpZXJh......ZW4gw6RyIHLDpHR0"
      }
   ]
}

The value in key must match the value of "key" in the visualData section in the Hermod API provisioning message, for example "key":"front" or "key":"back". See example in 4.6 - Provision mobile virtual smart card with visual ID


Example response for authentication images

The content provider API must return the following JSON data: 

Example response
{
   "data":[
      {
         "content_encoding":"base64",
         "content_type":"image/jpeg",
         "key":"auth_image",
         "data":"VmVyaWZpZXJh......ZW4gw6RyIHLDpHR0"
      }
   ]
}

The value in key must match the value of "key" in the description section in the Hermod API authenticate message, i.e. "key":"auth_image" . See example in 4.6 - Use authentication images from a content provider service