@corellium/corellium-cli 1.3.8 → 1.4.0

package/coverage/cobertura-coverage.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" ?>
 <!DOCTYPE coverage SYSTEM "http://cobertura.sourceforge.net/xml/coverage-04.dtd">
-<coverage lines-valid="0" lines-covered="0" line-rate="NaN" branches-valid="0" branches-covered="0" branch-rate="NaN" timestamp="1729701253977" complexity="0" version="0.1">
+<coverage lines-valid="0" lines-covered="0" line-rate="NaN" branches-valid="0" branches-covered="0" branch-rate="NaN" timestamp="1736549777655" complexity="0" version="0.1">
   <sources>
     <source>/builds/middleware/corellium-cli</source>
   </sources>

package/coverage/lcov-report/index.html

@@ -86,7 +86,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2024-10-23T16:34:13.985Z
+                at 2025-01-10T22:56:17.672Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@corellium/corellium-cli",
-  "version": "1.3.8",
+  "version": "1.4.0",
   "description": "Corellium CLI Tool",
   "scripts": {
     "corellium": "node index.js",

package/src/commands/instances/create.js

@@ -33,6 +33,11 @@ async function builder (yargs) {
       describe: 'Project ID to associate with instance',
       demandOption: true
     })
+    .option('os-build', {
+      type: 'string',
+      describe: 'OS Build',
+      demandOption: false
+    })
     .option('name', {
       type: 'string',
       describe: 'Optional name of instance',
@@ -43,6 +48,18 @@ async function builder (yargs) {
       describe: 'Wait for the instance to be ready',
       demandOption: false
     })
+    .option('dyld-aslr', {
+      type: 'boolean',
+      describe: 'Enable ASLR for DYLD Shared Cache. (--no-dyld-aslr to disable)',
+      default: true,
+      demandOption: false
+    })
+    .option('app-aslr', {
+      type: 'boolean',
+      describe: 'Enable ASLR for Applications. (--no-app-aslr to disable)',
+      default: true,
+      demandOption: false
+    })
 }
 
 async function handler (argv) {
@@ -51,9 +68,34 @@ async function handler (argv) {
   const project = argv.project
   const name = argv.name
   const api = await getApi()
+  const bootOptions = {}
+  const additionalTags = []
+  const instanceOptions = { flavor, os, project, name }
+
+  if (argv['app-aslr'] === false) {
+    additionalTags.push('noappaslr')
+  }
+
+  if (argv['dyld-aslr'] === false) {
+    additionalTags.push('nodyldaslr')
+  }
+
+  // only define additional tags if any are present
+  if (additionalTags.length > 0) {
+    bootOptions.additionalTags = additionalTags
+  }
+
+  // only define bootOptions if it contains any values
+  if (Object.keys(bootOptions).length > 0) {
+    instanceOptions.bootOptions = bootOptions
+  }
+
+  if (argv['os-build']) {
+    instanceOptions.osbuild = argv['os-build']
+  }
 
   try {
-    const instance = await api.v1CreateInstance({ flavor, os, project, name })
+    const instance = await api.v1CreateInstance(instanceOptions)
     // Wait 360 attempts for the instance to be created (30 minutes)
     if (argv.wait) {
       await waitForState(instance.id, api.v1GetInstance.bind(api), 'on', 360)

package/src/commands/projects/index.js

@@ -1,7 +1,8 @@
 const subcommands = [
   require('./create'),
   require('./list'),
-  require('./delete')
+  require('./delete'),
+  require('./vpnConfig')
 ]
 
 let _yargs

package/src/commands/projects/vpnConfig.js

@@ -0,0 +1,40 @@
+const { handleError } = require('../../error')
+const fs = require('fs')
+const fsp = fs.promises
+const { getCorelliumApi } = require('../../corellium-api')
+
+async function builder (yargs) {
+  yargs.option('verbose', {
+    alias: 'v',
+    type: 'boolean',
+    describe: 'Console will receive verbose error output'
+  }).option('project', {
+    type: 'input',
+    describe: 'Id of the project to pull ovpn configuration from.',
+    string: true
+  }).option('path', {
+    type: 'input',
+    describe: 'Path to where to save the ovpn configuration file.',
+    string: true
+  })
+}
+
+async function handler (argv) {
+  const project = argv.project
+  const corellium = await getCorelliumApi()
+  const projectApi = await corellium.getProject(project)
+  const savePath = argv.path
+  try {
+    const vpnConfigBuffer = await projectApi.vpnConfig()
+    await fsp.writeFile(savePath, vpnConfigBuffer.toString())
+  } catch (err) {
+    handleError(err, 'vpnConfig failed', argv.verbose)
+  }
+}
+
+module.exports = {
+  builder,
+  handler,
+  command: 'vpnConfig [project] [path]',
+  describe: 'Download Openvpn config for a project'
+}

package/test/test.js

@@ -1,5 +1,6 @@
 const { exec } = require('child_process')
 const { promisify } = require('util')
+const fs = require('fs')
 const path = require('path')
 const execp = promisify(exec)
 const assert = require('node:assert').strict
@@ -10,6 +11,7 @@ test()
 async function test () {
   await testProjects()
   await testInstances()
+  await testProjectGetOvpnConfig()
 }
 
 async function testInstances () {
@@ -44,6 +46,20 @@ async function testProjects () {
   assert.equal(-1, projects.map(p => p.id).indexOf(projectId))
 }
 
+async function testProjectGetOvpnConfig () {
+  const projects = (await ej('project list'))
+  const defaultProject = projects.find((p) => p.name === 'Default Project')
+  assert.ok(defaultProject)
+
+  const instanceId = (await e(`instance create ranchu 12.0.0 ${defaultProject.id}`))
+  assert.ok(instanceId)
+
+  await e(`project vpnConfig ${defaultProject.id} ./test/test.ovpn`)
+  assert.ok(fs.existsSync('./test/test.ovpn'))
+
+  await e(`instance delete ${instanceId}`)
+}
+
 async function sleep (ms) {
   return new Promise((resolve) => setTimeout(resolve, ms))
 }