Add support for machine code generation

Author: artemlos

.idea/artifacts/cryptolens_jar.xml

@@ -11,21 +11,22 @@ Assuming you have referenced the `cryptolens.jar` file, the code below should ge
 
 ```java
 import io.cryptolens.Cryptolens;
+import io.cryptolens.Helpers;
 import io.cryptolens.LicenseKey;
 
 public class Main {
 
     public static void main(String[] args) {
-        String RSAPubKey = "<RSAKeyValue><Modulus>khbyu3/vAEBHi339fTuo2nUaQgSTBj0jvpt5xnLTTF35FLkGI+5Z3wiKfnvQiCLf+5s4r8JB/Uic/i6/iNjPMILlFeE0N6XZ+2pkgwRkfMOcx6eoewypTPUoPpzuAINJxJRpHym3V6ZJZ1UfYvzRcQBD/lBeAYrvhpCwukQMkGushKsOS6U+d+2C9ZNeP+U+uwuv/xu8YBCBAgGb8YdNojcGzM4SbCtwvJ0fuOfmCWZvUoiumfE4x7rAhp1pa9OEbUe0a5HL+1v7+JLBgkNZ7Z2biiHaM6za7GjHCXU8rojatEQER+MpgDuQV3ZPx8RKRdiJgPnz9ApBHFYDHLDzDw==</Modulus><Exponent>AQAB</Exponent></RSAKeyValue>";
+        String RSAPubKey = "<RSAKeyValue><Modulus>sGbvxwdlDbqFXOMlVUnAF5ew0t0WpPW7rFpI5jHQOFkht/326dvh7t74RYeMpjy357NljouhpTLA3a6idnn4j6c3jmPWBkjZndGsPL4Bqm+fwE48nKpGPjkj4q/yzT4tHXBTyvaBjA8bVoCTnu+LiC4XEaLZRThGzIn5KQXKCigg6tQRy0GXE13XYFVz/x1mjFbT9/7dS8p85n8BuwlY5JvuBIQkKhuCNFfrUxBWyu87CFnXWjIupCD2VO/GbxaCvzrRjLZjAngLCMtZbYBALksqGPgTUN7ZM24XbPWyLtKPaXF2i4XRR9u6eTj5BfnLbKAU5PIVfjIS+vNYYogteQ==</Modulus><Exponent>AQAB</Exponent></RSAKeyValue>";
 
         Cryptolens cryptolens = Cryptolens.getDefault();
-        cryptolens.setRSAPubKey(RSAPubKey);
+        cryptolens.setRSAPublicKey(RSAPubKey);
 
         Cryptolens.ActivateResponse response =
-                cryptolens.activate( "WyI0NjUiLCJBWTBGTlQwZm9WV0FyVnZzMEV1Mm9LOHJmRDZ1SjF0Vk52WTU0VzB2Il0="
-                        , 3646
-                        , "MPDWY-PQAOW-FKSCH-SGAAU"
-                        , "289jf2afs3"
+                cryptolens.activate( "WyIyNTk1IiwidVVrQm94OGlYS3pHZlhTc0x6Rm9mN1piektrT0FSd0REaFZ0ZXZJMSJd"
+                        , 3349
+                        , "ICVLD-VVSZR-ZTICT-YKGXL"
+                        , Helpers.GetMachineCode()
                 );
 
         if (!response.successful()) {
@@ -51,6 +52,7 @@ public class Main {
         System.out.println(licenseKey.getF1());
     }
 }
+
 ```
 
 In order to adjust this code to your products, several parameters needs to be changed, which we outline below:
@@ -59,6 +61,5 @@ In order to adjust this code to your products, several parameters needs to be ch
 * `token` - the access token (can be found [here](https://app.cryptolens.io/docs/api/v3/QuickStart#api-keys), in *API Keys* section).
 * `product_id` - the id of the product can be found on the product page (in the example above, it's 3646).
 * `key` - the license key to be verified (above it's MPDWY-PQAOW-FKSCH-SGAAU).
-* `machine_code` - the unique id of the device (we are working on adding a method similar to `Helpers.GetMachineCode()`). In the code above, we hard coded it to 289jf2afs3.
-
+* `machine_code` - the unique id of the device, which may require root access. Note, this value is not the same as the one generated by the .NET client.
 

.idea/workspace.xml

@@ -1,19 +1,20 @@
 import io.cryptolens.Cryptolens;
+import io.cryptolens.Helpers;
 import io.cryptolens.LicenseKey;
 
 public class Main {
 
     public static void main(String[] args) {
-        String RSAPubKey = "<RSAKeyValue><Modulus>khbyu3/vAEBHi339fTuo2nUaQgSTBj0jvpt5xnLTTF35FLkGI+5Z3wiKfnvQiCLf+5s4r8JB/Uic/i6/iNjPMILlFeE0N6XZ+2pkgwRkfMOcx6eoewypTPUoPpzuAINJxJRpHym3V6ZJZ1UfYvzRcQBD/lBeAYrvhpCwukQMkGushKsOS6U+d+2C9ZNeP+U+uwuv/xu8YBCBAgGb8YdNojcGzM4SbCtwvJ0fuOfmCWZvUoiumfE4x7rAhp1pa9OEbUe0a5HL+1v7+JLBgkNZ7Z2biiHaM6za7GjHCXU8rojatEQER+MpgDuQV3ZPx8RKRdiJgPnz9ApBHFYDHLDzDw==</Modulus><Exponent>AQAB</Exponent></RSAKeyValue>";
+        String RSAPubKey = "<RSAKeyValue><Modulus>sGbvxwdlDbqFXOMlVUnAF5ew0t0WpPW7rFpI5jHQOFkht/326dvh7t74RYeMpjy357NljouhpTLA3a6idnn4j6c3jmPWBkjZndGsPL4Bqm+fwE48nKpGPjkj4q/yzT4tHXBTyvaBjA8bVoCTnu+LiC4XEaLZRThGzIn5KQXKCigg6tQRy0GXE13XYFVz/x1mjFbT9/7dS8p85n8BuwlY5JvuBIQkKhuCNFfrUxBWyu87CFnXWjIupCD2VO/GbxaCvzrRjLZjAngLCMtZbYBALksqGPgTUN7ZM24XbPWyLtKPaXF2i4XRR9u6eTj5BfnLbKAU5PIVfjIS+vNYYogteQ==</Modulus><Exponent>AQAB</Exponent></RSAKeyValue>";
 
         Cryptolens cryptolens = Cryptolens.getDefault();
-        cryptolens.setRSAPubKey(RSAPubKey);
+        cryptolens.setRSAPublicKey(RSAPubKey);
 
         Cryptolens.ActivateResponse response =
-                cryptolens.activate( "WyI0NjUiLCJBWTBGTlQwZm9WV0FyVnZzMEV1Mm9LOHJmRDZ1SjF0Vk52WTU0VzB2Il0="
-                        , 3646
-                        , "MPDWY-PQAOW-FKSCH-SGAAU"
-                        , "289jf2afs3"
+                cryptolens.activate( "WyIyNTk1IiwidVVrQm94OGlYS3pHZlhTc0x6Rm9mN1piektrT0FSd0REaFZ0ZXZJMSJd"
+                        , 3349
+                        , "ICVLD-VVSZR-ZTICT-YKGXL"
+                        , Helpers.GetMachineCode()
                 );
 
         if (!response.successful()) {

README.md

@@ -4,7 +4,7 @@
   <groupId>io.cryptolens</groupId>
   <artifactId>cryptolens</artifactId>
   <packaging>jar</packaging>
-  <version>1.1</version>
+  <version>1.2</version>
   <name>cryptolens</name>
   <description>A client api to access Cryptolens Licensing API.</description>
   <url>https://github.com/cryptolens/cryptolens-java</url>
@@ -24,5 +24,10 @@
       <version>3.8.1</version>
       <scope>test</scope>
     </dependency>
+    <dependency>
+      <groupId>com.github.oshi</groupId>
+      <artifactId>oshi-core</artifactId>
+      <version>LATEST</version>
+    </dependency>
   </dependencies>
 </project>

example-app/src/Main.java

@@ -52,7 +52,7 @@ private void setModulusBase64(String modulus) {
      * Sets the RSA Public key to verify the response from the server. You can
      * find it here: https://app.cryptolens.io/docs/api/v3/QuickStart#api-key.
      */
-    public void setRSAPubKey (String RSAPubKey) {
+    public void setRSAPublicKey (String RSAPubKey) {
         int mstart = RSAPubKey.indexOf("<Modulus>");
         int mend = RSAPubKey.indexOf("</Modulus>");
 

pom.xml

@@ -0,0 +1,71 @@
+package io.cryptolens;
+
+import oshi.SystemInfo;
+import oshi.hardware.CentralProcessor;
+import oshi.hardware.ComputerSystem;
+import oshi.hardware.HardwareAbstractionLayer;
+import oshi.software.os.OperatingSystem;
+
+import java.nio.charset.StandardCharsets;
+import java.security.MessageDigest;
+
+public class Helpers {
+
+    /**
+     * Returns a unique identifier of the device. Note, root access may be required.
+     * Furthermore, this method is not the same as the one used in our .NET client.
+     */
+    public static String GetMachineCode() {
+
+        return SHA256(getRawDeviceID());
+    }
+
+    /**
+     * Return the sha256 checksum of a string.
+     */
+    private static String SHA256(String rawData) {
+
+        StringBuffer hexString = new StringBuffer();
+
+        try {
+            MessageDigest digest = MessageDigest.getInstance("SHA-256");
+            byte[] hash = digest.digest(rawData.getBytes(StandardCharsets.UTF_8));
+
+            //thanks to https://stackoverflow.com/a/5470268.
+
+            for (int i = 0; i < hash.length; i++) {
+                if ((0xff & hash[i]) < 0x10) {
+                    hexString.append("0"
+                            + Integer.toHexString((0xFF & hash[i])));
+                } else {
+                    hexString.append(Integer.toHexString(0xFF & hash[i]));
+                }
+            }
+
+            return hexString.toString();
+        } catch (Exception e) {
+            return null;
+        }
+    }
+
+    private static String getRawDeviceID()
+    {
+        //thanks to https://stackoverflow.com/a/37705082. may require root.
+        SystemInfo systemInfo = new SystemInfo();
+        OperatingSystem operatingSystem = systemInfo.getOperatingSystem();
+        HardwareAbstractionLayer hardwareAbstractionLayer = systemInfo.getHardware();
+        CentralProcessor centralProcessor = hardwareAbstractionLayer.getProcessor();
+        ComputerSystem computerSystem = hardwareAbstractionLayer.getComputerSystem();
+
+        String vendor = operatingSystem.getManufacturer();
+        String processorSerialNumber = computerSystem.getSerialNumber();
+        String processorIdentifier = centralProcessor.getIdentifier();
+        int processors = centralProcessor.getLogicalProcessorCount();
+
+        return vendor +
+                processorSerialNumber +
+                processorIdentifier +
+                processors;
+    }
+
+}

src/main/java/io/cryptolens/Cryptolens.java

@@ -34,5 +34,6 @@ public static Test suite()
     public void testApp()
     {
         assertTrue( true );
+
     }
 }