You are here: Machine Registration > retrieveFingerprintRegistrationDetails

Retrieve Fingerprint Registration Details

Description

Obtains the registration details for a given fingerprint, such as the entitlement ID and friendly name of the machine registered with the fingerprint.

This Web service can be accessed by: ISV login and login by contact. The login by EID is not allowed.

Default Protocol Method Type URI
HTTPS GET retrieveFingerprintRegistrationDetails.xml

Post Parameters

Parameter Description Valid Values Optional
fingerprintValue The encoded fingerprint as obtained by using the getInfo Run-time API. String Either of fingerprintValue or customFingerprint is mandatory.
customFingerprint The host name of the machine specified during the fingerprint registration. String Either of fingerprintValue or customFingerprint is mandatory.
customerRefId

The reference ID of the customer.

String Yes

Sample Code

     import java.io.IOException;
import java.net.URLDecoder;

//..............................
//..............................
//..............................
import org.apache.http.params.HttpParams;
public class EMSSample {
                private static DefaultHttpClient httpclient = new DefaultHttpClient();
                private static Principal principal = null;
                private static StringBuffer query;
                //..............................
                //..............................
                //..............................
public static String retrieveFingerprintRegistrationDetails.xml()throws Exception  {
    if(!verifyLogin()){
                return "login failed";
    }
    HttpContext context = new BasicHttpContext();
    context.setAttribute(ClientContext.USER_TOKEN, principal);
         HttpGet get = new HttpGet("https://localhost:8443/ems/retrieveFingerprintRegistrationDetails.xml");
    query = new StringBuffer();
    setParameter("customFingerprint", "");
    setParameter("fingerprintValue", "%3Chasp_info%3E%0D%0A++%3Chost_fingerprint+type%3D%22SL-AdminMode%22+crc%3D%224006103506%22%3EMXhJSStdqD%2BqzsCZOf7aFww2QcypEjeMQCSptDqTMDIGQwIFE1CjlFV0zIUQDEbnYBKJMsCkmycJQChdKhw9YpgqCew1SVF3QXjlI3TOommQOBGyETG2qQyBMJfFVnFPmREZjClCaJ2wBNRico9gIijZu0nMqgkLVqU3lIk%3D%3C%2Fhost_fingerprint%3E%0D%0A++%3Chost_fingerprint+type%3D%22SL-UserMode%22+crc%3D%221689959577%22%3EMnhJSdMFAfNtUriYzCFBjKGANCnMhcMQYzAEBbogwppMDAxK4wgQpjJgPIjShfD1QwiwUpx1Qaz8uQKEpFmeEGMw4EERBVy8TxkMJjaolYgEjCGC0rEyw%2BTGcWGZ%3C%2Fhost_fingerprint%3E%0D%0A%3C%2Fhasp_info%3E");
    setParameter("customerRefId", "");
    get.setURI(new URI(URLDecoder.decode(get.getURI() + query.toString(),"UTF-8")));
    HttpResponse response = httpclient.execute(get, context);
    HttpEntity entity = response.getEntity();
    byte[] b = null;
    if (entity != null) {
        long l = entity.getContentLength();
         b = new byte[(int) l];
         entity.getContent().read(b);
         entity.consumeContent();
                }
                return new String(b);
                }
    static void setParameter(String key, String value) {
                if (query.toString().equals("")) {
                                query.append("?" + key + "=" + value + "&");
                } else {
                                query.append(key + "=" + value + "&");
                }
    }
    }

Sample Response

<emsResponse>
   <stat>ok</stat>
   <FingerPrintDetails>
      <CustomerList>
         <Customer>
            <CustomerRefId>C1</CustomerRefId>
            <FingerprintFriendlyName>fingerprint1</FingerprintFriendlyName>
            <EntitlementList>
               <Entitlement>
                  <Eid>5881d433-68b5-4bb8-8809-1ec6a7e439d5</Eid>
               </Entitlement>
            </EntitlementList>
         </Customer>
      </CustomerList>
   </FingerPrintDetails>
</emsResponse>
See Also:

Output Format for Failure

Error Codes

Error Code Description
101 You are not authorized to use this service.
128 You should log on first.
1105 Customer does not exist. Provide a valid Customer Reference Id.
1129 Error occurred while decoding the fingerprint value. Please contact the system administrator for further assistance.
1181 fingerprintValue is a required field. It can not be blank.
1182 customFingerprint is a required filed. It can not be blank.
1183 Either of fingerprintValue or customFingerprint is required. Both can not be blank.;
1184 No fingerprint registration details found for specified parameters.