From 4438c7d6e0b652d93bfdd5c4d080acd84e6303c0 Mon Sep 17 00:00:00 2001
From: Nabil Adouani <nabil.adouani@gmail.com>
Date: Wed, 19 Apr 2017 18:14:05 +0200
Subject: [PATCH 01/32] Bump footer's version

---
 ui/app/views/components/app-container.component.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ui/app/views/components/app-container.component.html b/ui/app/views/components/app-container.component.html
index 3d305a9a5..b8ef66415 100644
--- a/ui/app/views/components/app-container.component.html
+++ b/ui/app/views/components/app-container.component.html
@@ -8,7 +8,7 @@
 <footer class="main-footer">
 	<div class="container">
 		<div class="pull-right hidden-xs">
-			<strong>Version</strong>: 1.0.1
+			<strong>Version</strong>: 1.0.2
 		</div>
 		<strong>Copyright &copy; 2016-2017 <a href="http://www.thehive-project.org" target="_blank">TheHive Project</a></strong> All rights reserved.
 	</div>

From 2fb0814dbf815e4f3770529dd08ccc6943d467cb Mon Sep 17 00:00:00 2001
From: Nabil Adouani <nabil.adouani@gmail.com>
Date: Fri, 21 Apr 2017 15:03:38 +0200
Subject: [PATCH 02/32] #18 Display analyzer's license and author

---
 app/models/Analyzer.scala         |  3 +++
 app/models/ExternalAnalyzer.scala |  3 +++
 app/models/JsonFormat.scala       |  5 ++++-
 app/services/Analyzer.scala       | 11 ++++++++++-
 ui/app/views/analyzers.html       |  7 ++++++-
 5 files changed, 26 insertions(+), 3 deletions(-)

diff --git a/app/models/Analyzer.scala b/app/models/Analyzer.scala
index 3a6fcb319..ce853ac97 100644
--- a/app/models/Analyzer.scala
+++ b/app/models/Analyzer.scala
@@ -9,5 +9,8 @@ abstract class Analyzer {
   val version: String
   val description: String
   val dataTypeList: Seq[String]
+  val author: String
+  val url: String
+  val license: String
   val id = (name + "_" + version).replaceAll("\\.", "_")
 }
diff --git a/app/models/ExternalAnalyzer.scala b/app/models/ExternalAnalyzer.scala
index 74edf9e93..2ce882b5a 100644
--- a/app/models/ExternalAnalyzer.scala
+++ b/app/models/ExternalAnalyzer.scala
@@ -19,6 +19,9 @@ case class ExternalAnalyzer(
     version: String,
     description: String,
     dataTypeList: Seq[String],
+    author: String,
+    url: String,
+    license: String,
     command: Path,
     config: JsObject)(implicit val ec: ExecutionContext) extends Analyzer {
 
diff --git a/app/models/JsonFormat.scala b/app/models/JsonFormat.scala
index 3d526a3c6..b2536890c 100644
--- a/app/models/JsonFormat.scala
+++ b/app/models/JsonFormat.scala
@@ -18,6 +18,9 @@ object JsonFormat {
     "version" → analyzer.version,
     "description" → analyzer.description,
     "dataTypeList" → analyzer.dataTypeList,
+    "author" → analyzer.author,
+    "url" → analyzer.url,
+    "license" → analyzer.license,
     "id" → analyzer.id))
 
   implicit val fileArtifactWrites = OWrites[FileArtifact](fileArtifact ⇒ Json.obj(
@@ -40,4 +43,4 @@ object JsonFormat {
     "date" → job.date,
     "artifact" → job.artifact))
 
-}
\ No newline at end of file
+}
diff --git a/app/services/Analyzer.scala b/app/services/Analyzer.scala
index 34ebf7534..c64eef8b2 100644
--- a/app/services/Analyzer.scala
+++ b/app/services/Analyzer.scala
@@ -63,11 +63,20 @@ class AnalyzerSrv(
       command ← (info \ "command").asOpt[String] orElse {
         log.warn(s"command is missing in $infoFile"); None
       }
+      author ← (info \ "author").asOpt[String] orElse {
+        log.warn(s"author is missing in $infoFile"); None
+      }
+      url ← (info \ "url").asOpt[String] orElse {
+        log.warn(s"url is missing in $infoFile"); None
+      }
+      license ← (info \ "license").asOpt[String] orElse {
+        log.warn(s"license is missing in $infoFile"); None
+      }
       config = (info \ "config").asOpt[JsObject].getOrElse(JsObject(Nil))
       baseConfig = (info \ "baseConfig").asOpt[String].flatMap(c ⇒ (analyzerConfig \ c).asOpt[JsObject]).getOrElse(JsObject(Nil))
       absoluteCommand = analyzerPath.resolve(Paths.get(command.replaceAll("[\\/]", File.separator)))
       _ = log.info(s"Register analyzer $name $version (${(name + "_" + version).replaceAll("\\.", "_")})")
-    } yield ExternalAnalyzer(name, version, description, dataTypeList, absoluteCommand, globalConfig deepMerge baseConfig deepMerge config)(analyzeExecutionContext)
+    } yield ExternalAnalyzer(name, version, description, dataTypeList, author, url, license, absoluteCommand, globalConfig deepMerge baseConfig deepMerge config)(analyzeExecutionContext)
   }
 
   private[services] def readInfo(file: Path): JsValue = {
diff --git a/ui/app/views/analyzers.html b/ui/app/views/analyzers.html
index 8f3934925..3d5b5d3d3 100644
--- a/ui/app/views/analyzers.html
+++ b/ui/app/views/analyzers.html
@@ -32,7 +32,12 @@ <h3 class="box-title">Data types</h3>
             </div>
             <div class="box box-primary" dir-paginate="analyzer in vm.analyzers | filter:vm.search | itemsPerPage: 25">
                 <div class="box-header with-border">
-                    <h3 class="box-title">{{analyzer.name}} <small>(Version: {{analyzer.version}})</small></h3>
+                    <h3 class="box-title">
+                        <span class="mr-xxs">{{analyzer.name}}</span>
+                        <small class="mr-xxs"><strong>Version:</strong> {{analyzer.version}}</small>
+                        <small class="mr-xxs" ng-if="analyzer.author"><strong>Author:</strong> {{analyzer.author}}</small>
+                        <small class="mr-xxs" ng-if="analyzer.license"><strong>License:</strong> {{analyzer.license}}</small>
+                    </h3>
                     <div class="box-tools pull-right">
                         <a href ng-click="vm.run(analyzer)"><i class="fa fa-play"></i> Run</a>
                     </div>

From 1c635f3c821d0becb68f20907e6b5ea25fd35f93 Mon Sep 17 00:00:00 2001
From: To-om <toom@thehive-project.org>
Date: Mon, 1 May 2017 10:20:14 +0200
Subject: [PATCH 03/32] #19 code cleanup

---
 app/Module.scala                              |  2 +-
 .../{Analyzer.scala => AnalyzerCtrl.scala}    |  4 +-
 app/controllers/Asset.scala                   |  4 +-
 app/controllers/{Job.scala => JobCtrl.scala}  | 20 ++++---
 app/models/Analyzer.scala                     |  2 +-
 app/models/Analyzer.scala.orig                | 16 ++++++
 app/models/Analyzer.scala.rej                 |  9 ++++
 app/models/Artifact.scala                     |  2 +-
 app/models/JsonFormat.scala                   | 54 +++++++++----------
 app/models/JsonFormat.scala.orig              | 46 ++++++++++++++++
 app/models/JsonFormat.scala.rej               | 51 ++++++++++++++++++
 .../{Analyzer.scala => AnalyzerSrv.scala}     |  0
 app/services/Job.scala                        | 10 ++--
 app/util/JsonConfig.scala                     | 18 +++----
 install/docker/entrypoint                     |  0
 install/empty                                 |  0
 16 files changed, 175 insertions(+), 63 deletions(-)
 rename app/controllers/{Analyzer.scala => AnalyzerCtrl.scala} (93%)
 rename app/controllers/{Job.scala => JobCtrl.scala} (66%)
 create mode 100644 app/models/Analyzer.scala.orig
 create mode 100644 app/models/Analyzer.scala.rej
 create mode 100644 app/models/JsonFormat.scala.orig
 create mode 100644 app/models/JsonFormat.scala.rej
 rename app/services/{Analyzer.scala => AnalyzerSrv.scala} (100%)
 create mode 100644 install/docker/entrypoint
 create mode 100644 install/empty

diff --git a/app/Module.scala b/app/Module.scala
index 5a042f5ef..5c8cfc88d 100644
--- a/app/Module.scala
+++ b/app/Module.scala
@@ -10,7 +10,7 @@ import services.JobActor
 
 class Module(environment: Environment, configuration: Configuration) extends AbstractModule with ScalaModule with AkkaGuiceSupport {
 
-  override def configure() = {
+  override def configure(): Unit = {
     bindActor[JobActor]("JobActor")
 
     if (environment.mode == Mode.Prod)
diff --git a/app/controllers/Analyzer.scala b/app/controllers/AnalyzerCtrl.scala
similarity index 93%
rename from app/controllers/Analyzer.scala
rename to app/controllers/AnalyzerCtrl.scala
index 644571788..2892635c9 100644
--- a/app/controllers/Analyzer.scala
+++ b/app/controllers/AnalyzerCtrl.scala
@@ -38,7 +38,7 @@ class AnalyzerCtrl @Inject() (
   private[controllers] def readFileArtifact(request: Request[AnyContent]) = {
     for {
       parts ← request.body.asMultipartFormData
-      filePart ← parts.file("data").headOption
+      filePart ← parts.file("data")
       attrList ← parts.dataParts.get("_json")
       attrStr ← attrList.headOption
       attr ← Json.parse(attrStr).asOpt[JsObject]
@@ -47,7 +47,7 @@ class AnalyzerCtrl @Inject() (
       ("filename" → JsString(filePart.filename)))
   }
 
-  def analyze(analyzerId: String) = Action.async { request ⇒
+  def analyze(analyzerId: String): Action[AnyContent] = Action.async { request ⇒
     readDataArtifact(request)
       .orElse(readFileArtifact(request))
       .map { artifact ⇒
diff --git a/app/controllers/Asset.scala b/app/controllers/Asset.scala
index 102cd11ab..5ca4ddcd3 100644
--- a/app/controllers/Asset.scala
+++ b/app/controllers/Asset.scala
@@ -12,12 +12,12 @@ trait AssetCtrl {
 
 @Singleton
 class AssetCtrlProd @Inject() (errorHandler: HttpErrorHandler) extends Assets(errorHandler) with AssetCtrl {
-  def get(file: String) = at("/ui", file)
+  def get(file: String): Action[AnyContent] = at("/ui", file)
 }
 
 @Singleton
 class AssetCtrlDev @Inject() (environment: Environment) extends ExternalAssets(environment) with AssetCtrl {
-  def get(file: String) = {
+  def get(file: String): Action[AnyContent] = {
     if (file.startsWith("bower_components/")) {
       at("ui", file)
     }
diff --git a/app/controllers/Job.scala b/app/controllers/JobCtrl.scala
similarity index 66%
rename from app/controllers/Job.scala
rename to app/controllers/JobCtrl.scala
index 2a96ca0a1..ede14b709 100644
--- a/app/controllers/Job.scala
+++ b/app/controllers/JobCtrl.scala
@@ -6,40 +6,38 @@ import scala.annotation.implicitNotFound
 import scala.concurrent.ExecutionContext
 import scala.concurrent.duration.Duration
 import scala.util.{ Failure, Success }
-
 import play.api.libs.json.{ JsString, Json }
-import play.api.mvc.{ Action, Controller }
-
+import play.api.mvc.{ Action, AnyContent, Controller }
 import models.JsonFormat.{ jobStatusWrites, jobWrites }
 import services.JobSrv
 
 class JobCtrl @Inject() (
     jobSrv: JobSrv,
     implicit val ec: ExecutionContext) extends Controller {
-  def list(dataTypeFilter: Option[String], dataFilter: Option[String], analyzerFilter: Option[String], start: Int, limit: Int) = Action.async { request ⇒
+  def list(dataTypeFilter: Option[String], dataFilter: Option[String], analyzerFilter: Option[String], start: Int, limit: Int): Action[AnyContent] = Action.async { request ⇒
     jobSrv.list(dataTypeFilter, dataFilter, analyzerFilter, start, limit).map {
       case (total, jobs) ⇒ Ok(Json.toJson(jobs)).withHeaders("X-Total" → total.toString)
     }
   }
 
-  def get(jobId: String) = Action.async { request ⇒
+  def get(jobId: String): Action[AnyContent] = Action.async { request ⇒
     jobSrv.get(jobId).map { job ⇒
       Ok(Json.toJson(job))
     }
   }
 
-  def remove(jobId: String) = Action.async { request ⇒
+  def remove(jobId: String): Action[AnyContent] = Action.async { request ⇒
     jobSrv.remove(jobId).map(_ ⇒ Ok(""))
   }
 
-  def report(jobId: String) = Action.async { request ⇒
+  def report(jobId: String): Action[AnyContent] = Action.async { request ⇒
     jobSrv
       .get(jobId)
       .map { job ⇒
         val report = job.report.value match {
-          case Some(Success(report)) ⇒ report
-          case Some(Failure(error))  ⇒ JsString(error.getMessage)
-          case None                  ⇒ JsString("Running")
+          case Some(Success(_report)) ⇒ _report
+          case Some(Failure(error))   ⇒ JsString(error.getMessage)
+          case None                   ⇒ JsString("Running")
         }
         Ok(jobWrites.writes(job) +
           ("status" → jobStatusWrites.writes(job.status)) +
@@ -47,7 +45,7 @@ class JobCtrl @Inject() (
       }
   }
 
-  def waitReport(jobId: String, atMost: String) = Action.async { request ⇒
+  def waitReport(jobId: String, atMost: String): Action[AnyContent] = Action.async { request ⇒
     for {
       job ← jobSrv.get(jobId)
       (status, report) ← jobSrv.waitReport(jobId, Duration(atMost))
diff --git a/app/models/Analyzer.scala b/app/models/Analyzer.scala
index ce853ac97..438aadd32 100644
--- a/app/models/Analyzer.scala
+++ b/app/models/Analyzer.scala
@@ -12,5 +12,5 @@ abstract class Analyzer {
   val author: String
   val url: String
   val license: String
-  val id = (name + "_" + version).replaceAll("\\.", "_")
+  val id: String = (name + "_" + version).replaceAll("\\.", "_")
 }
diff --git a/app/models/Analyzer.scala.orig b/app/models/Analyzer.scala.orig
new file mode 100644
index 000000000..ce853ac97
--- /dev/null
+++ b/app/models/Analyzer.scala.orig
@@ -0,0 +1,16 @@
+package models
+
+import scala.concurrent.Future
+import play.api.libs.json.JsObject
+
+abstract class Analyzer {
+  def analyze(artifact: Artifact): Future[JsObject]
+  val name: String
+  val version: String
+  val description: String
+  val dataTypeList: Seq[String]
+  val author: String
+  val url: String
+  val license: String
+  val id = (name + "_" + version).replaceAll("\\.", "_")
+}
diff --git a/app/models/Analyzer.scala.rej b/app/models/Analyzer.scala.rej
new file mode 100644
index 000000000..1520d1f06
--- /dev/null
+++ b/app/models/Analyzer.scala.rej
@@ -0,0 +1,9 @@
+--- app/models/Analyzer.scala
++++ app/models/Analyzer.scala
+@@ -9,5 +9,5 @@ abstract class Analyzer {
+   val version: String
+   val description: String
+   val dataTypeList: Seq[String]
+-  val id = (name + "_" + version).replaceAll("\\.", "_")
++  val id: String = (name + "_" + version).replaceAll("\\.", "_")
+ }
diff --git a/app/models/Artifact.scala b/app/models/Artifact.scala
index c71a63439..db18edce6 100644
--- a/app/models/Artifact.scala
+++ b/app/models/Artifact.scala
@@ -13,7 +13,7 @@ class FileArtifact(val data: File, val attributes: JsObject) extends Artifact(at
   }
 }
 object FileArtifact {
-  def apply(data: File, attributes: JsObject) = {
+  def apply(data: File, attributes: JsObject): FileArtifact = {
     val tempFile = File.createTempFile("cortex-", "-datafile")
     data.renameTo(tempFile)
     new FileArtifact(tempFile, attributes)
diff --git a/app/models/JsonFormat.scala b/app/models/JsonFormat.scala
index b2536890c..6302fcc6b 100644
--- a/app/models/JsonFormat.scala
+++ b/app/models/JsonFormat.scala
@@ -1,42 +1,36 @@
 package models
 
-import scala.annotation.implicitNotFound
-
-import play.api.libs.json.Json
 import play.api.libs.json.Json.toJsFieldJsValueWrapper
-import play.api.libs.json.Writes
-import scala.concurrent.Future
-import play.api.libs.json.JsObject
-import scala.util.Success
-import scala.util.Failure
-import play.api.libs.json.JsString
-import play.api.libs.json.OWrites
+import play.api.libs.json._
 
 object JsonFormat {
-  implicit val analyzerWrites = Writes[Analyzer](analyzer ⇒ Json.obj(
-    "name" → analyzer.name,
-    "version" → analyzer.version,
-    "description" → analyzer.description,
-    "dataTypeList" → analyzer.dataTypeList,
-    "author" → analyzer.author,
-    "url" → analyzer.url,
-    "license" → analyzer.license,
-    "id" → analyzer.id))
-
-  implicit val fileArtifactWrites = OWrites[FileArtifact](fileArtifact ⇒ Json.obj(
-    "attributes" → fileArtifact.attributes))
-
-  implicit val dataArtifactWrites = Json.writes[DataArtifact]
-  implicit val dataActifactReads = Json.reads[DataArtifact]
-
-  implicit val artifactWrites = OWrites[Artifact](artifact ⇒ artifact match {
+  implicit val analyzerWrites: OWrites[Analyzer] = OWrites[Analyzer] { analyzer ⇒
+    Json.obj(
+      "name" → analyzer.name,
+      "version" → analyzer.version,
+      "description" → analyzer.description,
+      "dataTypeList" → analyzer.dataTypeList,
+      "author" → analyzer.author,
+      "url" → analyzer.url,
+      "license" → analyzer.license,
+      "id" → analyzer.id)
+  }
+
+  implicit val fileArtifactWrites: OWrites[FileArtifact] = OWrites[FileArtifact] { fileArtifact ⇒
+    Json.obj("attributes" → fileArtifact.attributes)
+  }
+
+  implicit val dataArtifactWrites: OWrites[DataArtifact] = Json.writes[DataArtifact]
+  implicit val dataActifactReads: Reads[DataArtifact] = Json.reads[DataArtifact]
+
+  implicit val artifactWrites: OWrites[Artifact] = OWrites[Artifact] {
     case dataArtifact: DataArtifact ⇒ dataArtifactWrites.writes(dataArtifact)
     case fileArtifact: FileArtifact ⇒ fileArtifactWrites.writes(fileArtifact)
-  })
+  }
 
-  implicit val jobStatusWrites = Writes[JobStatus.Type](jobStatus ⇒ JsString(jobStatus.toString))
+  implicit val jobStatusWrites: Writes[JobStatus.Type] = Writes[JobStatus.Type](jobStatus ⇒ JsString(jobStatus.toString))
 
-  implicit val jobWrites = OWrites[Job](job ⇒ Json.obj(
+  implicit val jobWrites: OWrites[Job] = OWrites[Job](job ⇒ Json.obj(
     "id" → job.id,
     "analyzerId" → job.analyzerId,
     "status" → job.status,
diff --git a/app/models/JsonFormat.scala.orig b/app/models/JsonFormat.scala.orig
new file mode 100644
index 000000000..b2536890c
--- /dev/null
+++ b/app/models/JsonFormat.scala.orig
@@ -0,0 +1,46 @@
+package models
+
+import scala.annotation.implicitNotFound
+
+import play.api.libs.json.Json
+import play.api.libs.json.Json.toJsFieldJsValueWrapper
+import play.api.libs.json.Writes
+import scala.concurrent.Future
+import play.api.libs.json.JsObject
+import scala.util.Success
+import scala.util.Failure
+import play.api.libs.json.JsString
+import play.api.libs.json.OWrites
+
+object JsonFormat {
+  implicit val analyzerWrites = Writes[Analyzer](analyzer ⇒ Json.obj(
+    "name" → analyzer.name,
+    "version" → analyzer.version,
+    "description" → analyzer.description,
+    "dataTypeList" → analyzer.dataTypeList,
+    "author" → analyzer.author,
+    "url" → analyzer.url,
+    "license" → analyzer.license,
+    "id" → analyzer.id))
+
+  implicit val fileArtifactWrites = OWrites[FileArtifact](fileArtifact ⇒ Json.obj(
+    "attributes" → fileArtifact.attributes))
+
+  implicit val dataArtifactWrites = Json.writes[DataArtifact]
+  implicit val dataActifactReads = Json.reads[DataArtifact]
+
+  implicit val artifactWrites = OWrites[Artifact](artifact ⇒ artifact match {
+    case dataArtifact: DataArtifact ⇒ dataArtifactWrites.writes(dataArtifact)
+    case fileArtifact: FileArtifact ⇒ fileArtifactWrites.writes(fileArtifact)
+  })
+
+  implicit val jobStatusWrites = Writes[JobStatus.Type](jobStatus ⇒ JsString(jobStatus.toString))
+
+  implicit val jobWrites = OWrites[Job](job ⇒ Json.obj(
+    "id" → job.id,
+    "analyzerId" → job.analyzerId,
+    "status" → job.status,
+    "date" → job.date,
+    "artifact" → job.artifact))
+
+}
diff --git a/app/models/JsonFormat.scala.rej b/app/models/JsonFormat.scala.rej
new file mode 100644
index 000000000..e6924f842
--- /dev/null
+++ b/app/models/JsonFormat.scala.rej
@@ -0,0 +1,51 @@
+--- app/models/JsonFormat.scala
++++ app/models/JsonFormat.scala
+@@ -1,39 +1,30 @@
+ package models
+ 
+-import scala.annotation.implicitNotFound
+-
+-import play.api.libs.json.Json
+ import play.api.libs.json.Json.toJsFieldJsValueWrapper
+-import play.api.libs.json.Writes
+-import scala.concurrent.Future
+-import play.api.libs.json.JsObject
+-import scala.util.Success
+-import scala.util.Failure
+-import play.api.libs.json.JsString
+-import play.api.libs.json.OWrites
++import play.api.libs.json._
+ 
+ object JsonFormat {
+-  implicit val analyzerWrites = Writes[Analyzer](analyzer ⇒ Json.obj(
++  implicit val analyzerWrites: Writes[Analyzer] = Writes[Analyzer](analyzer ⇒ Json.obj(
+     "name" → analyzer.name,
+     "version" → analyzer.version,
+     "description" → analyzer.description,
+     "dataTypeList" → analyzer.dataTypeList,
+     "id" → analyzer.id))
+ 
+-  implicit val fileArtifactWrites = OWrites[FileArtifact](fileArtifact ⇒ Json.obj(
++  implicit val fileArtifactWrites: OWrites[FileArtifact] = OWrites[FileArtifact](fileArtifact ⇒ Json.obj(
+     "attributes" → fileArtifact.attributes))
+ 
+-  implicit val dataArtifactWrites = Json.writes[DataArtifact]
+-  implicit val dataActifactReads = Json.reads[DataArtifact]
++  implicit val dataArtifactWrites: OWrites[DataArtifact] = Json.writes[DataArtifact]
++  implicit val dataActifactReads: Reads[DataArtifact] = Json.reads[DataArtifact]
+ 
+-  implicit val artifactWrites = OWrites[Artifact](artifact ⇒ artifact match {
++  implicit val artifactWrites: OWrites[Artifact] = OWrites[Artifact] {
+     case dataArtifact: DataArtifact ⇒ dataArtifactWrites.writes(dataArtifact)
+     case fileArtifact: FileArtifact ⇒ fileArtifactWrites.writes(fileArtifact)
+-  })
++  }
+ 
+-  implicit val jobStatusWrites = Writes[JobStatus.Type](jobStatus ⇒ JsString(jobStatus.toString))
++  implicit val jobStatusWrites: Writes[JobStatus.Type] = Writes[JobStatus.Type](jobStatus ⇒ JsString(jobStatus.toString))
+ 
+-  implicit val jobWrites = OWrites[Job](job ⇒ Json.obj(
++  implicit val jobWrites: OWrites[Job] = OWrites[Job](job ⇒ Json.obj(
+     "id" → job.id,
+     "analyzerId" → job.analyzerId,
+     "status" → job.status,
diff --git a/app/services/Analyzer.scala b/app/services/AnalyzerSrv.scala
similarity index 100%
rename from app/services/Analyzer.scala
rename to app/services/AnalyzerSrv.scala
diff --git a/app/services/Job.scala b/app/services/Job.scala
index 1e8742da9..0d40c210a 100644
--- a/app/services/Job.scala
+++ b/app/services/Job.scala
@@ -25,7 +25,7 @@ class JobSrv @Inject() (
     @Named("JobActor") jobActor: ActorRef,
     implicit val ec: ExecutionContext,
     implicit val system: ActorSystem) {
-  import JobActor._
+  import services.JobActor._
   implicit val timeout = Timeout(5.seconds)
 
   def list(dataTypeFilter: Option[String], dataFilter: Option[String], analyzerFilter: Option[String], start: Int, limit: Int): Future[(Int, Seq[Job])] = {
@@ -72,7 +72,7 @@ class JobSrv @Inject() (
       case duration: FiniteDuration ⇒
         val prom = Promise[(JobStatus.Type, JsValue)]()
         val timeout = system.scheduler.scheduleOnce(duration) { prom.success((JobStatus.Failure, JsString("Timeout"))); () }
-        statusResult onComplete { case _ ⇒ timeout.cancel() }
+        statusResult.onComplete(_ ⇒ timeout.cancel())
         Future.firstCompletedOf(List(statusResult, prom.future))
     }
   }
@@ -95,7 +95,7 @@ class JobActor(
     analyzerSrv: AnalyzerSrv,
     implicit val ec: ExecutionContext) extends Actor {
 
-  import JobActor._
+  import services.JobActor._
   @Inject def this(
     configuration: Configuration,
     analyzerSrv: AnalyzerSrv,
@@ -128,7 +128,7 @@ class JobActor(
         dataTypeFilter.fold(true)(j.artifact.dataTypeFilter) &&
           dataFilter.fold(true)(j.artifact.dataFilter) &&
           analyzerFilter.fold(true)(j.analyzerId.contains))
-      sender ! JobList(filteredJobs.size, filteredJobs.drop(start).take(limit))
+      sender ! JobList(filteredJobs.size, filteredJobs.slice(start, start + limit))
     case GetJob(jobId) ⇒ sender ! jobs.find(_.id == jobId).getOrElse(JobNotFound)
     case RemoveJob(jobId) ⇒
       removeJob(jobs, jobId) match {
@@ -148,5 +148,5 @@ class JobActor(
       context.become(jobState(jobs.takeWhile(_.date after limitDate)))
   }
 
-  override def receive = jobState(Nil)
+  override def receive: Receive = jobState(Nil)
 }
\ No newline at end of file
diff --git a/app/util/JsonConfig.scala b/app/util/JsonConfig.scala
index 0c91d548a..f02445e9e 100644
--- a/app/util/JsonConfig.scala
+++ b/app/util/JsonConfig.scala
@@ -1,25 +1,23 @@
 package util
 
-import scala.BigDecimal
-import scala.collection.JavaConversions.asScalaBuffer
-
+import com.typesafe.config.ConfigValueType.{ BOOLEAN, NULL, NUMBER, STRING }
+import com.typesafe.config.{ ConfigList, ConfigObject, ConfigValue }
 import play.api.Configuration
-import play.api.libs.json.{ JsArray, JsBoolean, JsNull, JsNumber, JsObject, JsString, OWrites, Writes }
+import play.api.libs.json._
 
-import com.typesafe.config.{ ConfigList, ConfigObject, ConfigValue }
-import com.typesafe.config.ConfigValueType.{ BOOLEAN, NULL, NUMBER, STRING }
+import scala.collection.JavaConversions.asScalaBuffer
 
 object JsonConfig {
-  implicit val configValueWrites: Writes[ConfigValue] = Writes((value: ConfigValue) ⇒ value match {
-    case v: ConfigObject             ⇒ configWrites.writes(Configuration(v.toConfig()))
+  implicit def configValueWrites: Writes[ConfigValue] = Writes[ConfigValue] {
+    case v: ConfigObject             ⇒ configWrites.writes(Configuration(v.toConfig))
     case v: ConfigList               ⇒ JsArray(v.toSeq.map(x ⇒ configValueWrites.writes(x)))
     case v if v.valueType == NUMBER  ⇒ JsNumber(BigDecimal(v.unwrapped.asInstanceOf[java.lang.Number].toString))
     case v if v.valueType == BOOLEAN ⇒ JsBoolean(v.unwrapped.asInstanceOf[Boolean])
     case v if v.valueType == NULL    ⇒ JsNull
     case v if v.valueType == STRING  ⇒ JsString(v.unwrapped.asInstanceOf[String])
-  })
+  }
 
-  implicit val configWrites = OWrites { (cfg: Configuration) ⇒
+  implicit def configWrites: OWrites[Configuration] = OWrites[Configuration] { cfg ⇒
     JsObject(cfg.subKeys.map(key ⇒ key → configValueWrites.writes(cfg.underlying.getValue(key))).toSeq)
   }
 }
\ No newline at end of file
diff --git a/install/docker/entrypoint b/install/docker/entrypoint
new file mode 100644
index 000000000..e69de29bb
diff --git a/install/empty b/install/empty
new file mode 100644
index 000000000..e69de29bb

From 8cfa56bdbcc7ecbf4fb61250569149eb32e88ee4 Mon Sep 17 00:00:00 2001
From: To-om <toom@thehive-project.org>
Date: Tue, 2 May 2017 10:59:37 +0200
Subject: [PATCH 04/32] #20 package Cortex with rpm, deb and docker

---
 build.sbt                   | 157 +++++++++++++++++++++---------------
 conf/logback.xml            |  39 +++++++++
 install/cortex              | 116 ++++++++++++++++----------
 install/cortex.conf         |  74 ++++++++---------
 install/cortex.service      |  14 ++--
 install/docker/entrypoint   |  55 +++++++++++++
 project/Bintray.scala       |   6 +-
 project/BuildSettings.scala |   2 +-
 8 files changed, 300 insertions(+), 163 deletions(-)
 create mode 100644 conf/logback.xml
 mode change 100644 => 100755 install/docker/entrypoint

diff --git a/build.sbt b/build.sbt
index b149c99fc..706bb08db 100644
--- a/build.sbt
+++ b/build.sbt
@@ -15,9 +15,9 @@ libraryDependencies ++= Seq(
 
 resolvers += "scalaz-bintray" at "http://dl.bintray.com/scalaz/releases"
 
-releaseVersionUIFile := baseDirectory.value / "ui" / "package.json"
+Release.releaseVersionUIFile := baseDirectory.value / "ui" / "package.json"
 
-changelogFile := baseDirectory.value / "CHANGELOG.md"
+Release.changelogFile := baseDirectory.value / "CHANGELOG.md"
 
 publishArtifact in (Compile, packageDoc) := false
 
@@ -30,83 +30,110 @@ run := {
   (run in Compile).evaluated
   frontendDev.value
 }
-
 mappings in packageBin in Assets ++= frontendFiles.value
 
 // Install files //
-
-mappings in Universal ++= {
-  val dir = baseDirectory.value / "install"
-  (dir.***) pair relativeTo(dir.getParentFile)
+mappings in Universal ~= {
+  _.flatMap {
+    case (file, "conf/application.conf") => Nil
+    case (file, "conf/apllication.sample") => Seq(file -> "conf/application.conf")
+    case other => Seq(other)
+  } ++ Seq(
+    file("install/cortex.service") -> "install/cortex.service",
+    file("install/cortex.conf") -> "install/cortex.conf",
+    file("install/cortex") -> "install/cortex"
+  )
 }
 
-// Release //
-import ReleaseTransformations._
-
-import Release._
-
-bintrayOrganization := Some("cert-bdf")
-
-bintrayRepository := "cortex"
-
-publish := {
-  publishRelease.value
-  publishLatest.value
+// Package //
+maintainer := "Thomas Franco <toom@thehive-project.org"
+packageSummary := "-"
+packageDescription := """--""".stripMargin
+defaultLinuxInstallLocation := "/opt"
+linuxPackageMappings ~= { _.map { pm =>
+  val mappings = pm.mappings.filterNot {
+    case (file, path) => path.startsWith("/opt/cortex/install") || path.startsWith("/opt/cortex/conf")
+  }
+  com.typesafe.sbt.packager.linux.LinuxPackageMapping(mappings, pm.fileData).withConfig()
+} :+ packageMapping(
+  file("install/cortex.service") -> "/etc/systemd/system/cortex.service",
+  file("install/cortex.conf") -> "/etc/init/cortex.conf",
+  file("install/cortex") -> "/etc/init.d/cortex",
+  file("conf/application.sample") -> "/etc/cortex/application.conf",
+  file("conf/logback.xml") -> "/etc/cortex/logback.xml"
+).withConfig()
 }
 
-releaseProcess := Seq[ReleaseStep](
-  checkUncommittedChanges,
-  checkSnapshotDependencies,
-  getVersionFromBranch,
-  runTest,
-  releaseMerge,
-  checkoutMaster,
-  setReleaseVersion,
-  setReleaseUIVersion,
-  generateChangelog,
-  commitChanges,
-  tagRelease,
-  publishArtifacts,
-  checkoutDevelop,
-  setNextVersion,
-  setNextUIVersion,
-  commitChanges,
-  //commitNextVersion,
-  pushChanges)
-
+packageBin := {
+  (packageBin in Universal).value
+  (packageBin in Debian).value
+  //(packageBin in Rpm).value
+}
+// DEB //
+//debianPackageRecommends := Seq("elasticsearch")
+debianPackageDependencies += "java8-runtime-headless | java8-runtime"
+maintainerScripts in Debian := maintainerScriptsFromDirectory(
+  baseDirectory.value / "install" / "debian",
+  Seq(DebianConstants.Postinst, DebianConstants.Prerm, DebianConstants.Postrm)
+)
+linuxEtcDefaultTemplate in Debian := (baseDirectory.value / "install" / "etc_default_cortex").asURL
+linuxMakeStartScript in Debian := None
+
+// RPM //
+rpmRelease := "8"
+rpmVendor in Rpm := "TheHive Project"
+rpmUrl := Some("http://thehive-project.org/")
+rpmLicense := Some("AGPL")
+rpmRequirements += "java-1.8.0-openjdk-headless"
+maintainerScripts in Rpm := maintainerScriptsFromDirectory(
+  baseDirectory.value / "install" / "rpm",
+  Seq(RpmConstants.Pre, RpmConstants.Preun, RpmConstants.Postun)
+)
+linuxPackageSymlinks in Rpm := Nil
+rpmPrefix := Some(defaultLinuxInstallLocation.value)
+linuxEtcDefaultTemplate in Rpm := (baseDirectory.value / "install" / "etc_default_cortex").asURL
 
 // DOCKER //
+import com.typesafe.sbt.packager.docker.{ Cmd, ExecCmd }
 
-dockerBaseImage := "certbdf/thehive:latest"
-
-packageName in Docker := "thehive-cortex"
-
+defaultLinuxInstallLocation in Docker := "/opt/cortex"
 dockerRepository := Some("certbdf")
-
 dockerUpdateLatest := true
-
-mappings in Universal += file("docker/entrypoint") -> "bin/entrypoint"
-
-mappings in Universal ~= { _.filterNot {
-  case (_, name) => name.startsWith("conf/") && name != "conf/keepme"
-}}
-import com.typesafe.sbt.packager.docker.{ ExecCmd, Cmd }
-
-dockerCommands := dockerCommands.value.map {
-  case ExecCmd("ENTRYPOINT", _*) => ExecCmd("ENTRYPOINT", "bin/entrypoint")
-  case cmd                       => cmd
+dockerEntrypoint := Seq("/opt/cortex/entrypoint")
+dockerExposedPorts := Seq(9000)
+mappings in Docker ++= Seq(
+  file("install/docker/entrypoint") -> "/opt/cortex/entrypoint",
+  file("conf/logback.xml") -> "/etc/cortex/logback.xml",
+  file("install/empty") -> "/var/log/cortex/application.log")
+mappings in Docker ~= (_.filterNot {
+  case (_, filepath) => filepath == "/opt/cortex/conf/application.conf"
+})
+
+dockerCommands ~= { dc =>
+  val (dockerInitCmds, dockerTailCmds) = dc.splitAt(4)
+  dockerInitCmds ++
+    Seq(
+      Cmd("USER", "root"),
+      ExecCmd("RUN", "bash", "-c",
+        "apt-get update && " +
+          "apt-get install -y --no-install-recommends python-pip python2.7-dev ssdeep libfuzzy-dev libfuzzy2 libimage-exiftool-perl libmagic1 build-essential git && " +
+          "cd /opt && " +
+          "git clone -b develop https://github.com/CERT-BDF/Cortex-Analyzers.git && " +
+          "pip install $(cat Cortex-Analyzers/analyzers/*/requirements.txt | grep -v hashlib | sort -u)"),
+      Cmd("ADD", "var", "/var"),
+      Cmd("ADD", "etc", "/etc"),
+      ExecCmd("RUN", "chown", "-R", "daemon:daemon", "/var/log/cortex")) ++
+    dockerTailCmds
 }
 
-dockerCommands := dockerCommands.value.head +:
-  Cmd("USER", "root") +:
-  ExecCmd("RUN", "bash", "-c",
-    "apt-get update && " +
-    "apt-get install -y --no-install-recommends python-pip python2.7-dev ssdeep libfuzzy-dev libfuzzy2 libimage-exiftool-perl libmagic1 build-essential git && " +
-    "cd /opt && " +
-    "git clone https://github.com/CERT-BDF/Cortex-Analyzers.git && " +
-    "pip install $(cat Cortex-Analyzers/analyzers/*/requirements.txt | grep -v hashlib | sort -u)") +:
-  Cmd("EXPOSE", "9001") +:
-  dockerCommands.value.tail
+// Bintray //
+bintrayOrganization := Some("cert-bdf")
+bintrayRepository := "cortex"
+publish := {
+  (publish in Docker).value
+  PublishToBinTray.publishRelease.value
+  PublishToBinTray.publishLatest.value
+}
 
 // Scalariform //
 import scalariform.formatter.preferences._
diff --git a/conf/logback.xml b/conf/logback.xml
new file mode 100644
index 000000000..2f1ff1748
--- /dev/null
+++ b/conf/logback.xml
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<configuration debug="false">
+
+	<conversionRule conversionWord="coloredLevel"
+		converterClass="play.api.libs.logback.ColoredLevel" />
+
+	<appender name="FILE" class="ch.qos.logback.core.FileAppender">
+		<file>/var/log/cortex/application.log</file>
+		<encoder>
+			<pattern>%date [%level] from %logger in %thread - %message%n%xException</pattern>
+		</encoder>
+	</appender>
+
+	<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
+		<encoder>
+			<pattern>%coloredLevel %logger{15} - %message%n%xException{10}
+			</pattern>
+		</encoder>
+	</appender>
+
+	<appender name="ASYNCFILE" class="ch.qos.logback.classic.AsyncAppender">
+		<appender-ref ref="FILE" />
+	</appender>
+
+	<appender name="ASYNCSTDOUT" class="ch.qos.logback.classic.AsyncAppender">
+		<appender-ref ref="STDOUT" />
+	</appender>
+
+	<logger name="play" level="INFO" />
+	<logger name="application" level="INFO" />
+
+	<logger name="com.gargoylesoftware.htmlunit.javascript" level="OFF" />
+
+	<root level="INFO">
+		<appender-ref ref="ASYNCFILE" />
+		<appender-ref ref="ASYNCSTDOUT" />
+	</root>
+
+</configuration>
\ No newline at end of file
diff --git a/install/cortex b/install/cortex
index 29b24aedc..17a896ad8 100755
--- a/install/cortex
+++ b/install/cortex
@@ -5,73 +5,101 @@
 # Required-Stop:     $remote_fs $syslog
 # Default-Start:     2 3 4 5
 # Default-Stop:      0 1 6
-# Short-Description: Cortex: a FOSS Information Security Incident Management Platform
+# Short-Description: cortex: Powerful Observable Analysis Engine
 ### END INIT INFO
 
 NAME=cortex
-DAEMONDIR=/opt/cortex
-DAEMON=$DAEMONDIR/bin/cortex
-PIDDIR=/var/run/cortex
-PIDFILE=$PIDDIR/pid
-DAEMONUSER=cortex
-CONFIGFILE=/etc/cortex/application.conf
-LISTENPORT=9000
-DAEMON_OPTS=
+DAEMON=/opt/cortex/bin/cortex
+PIDFILE=/var/run/cortex/pid
+DAEMON_USER=cortex
+DAEMON_ARGS="-Dconfig.file=/etc/cortex/application.conf -Dlogger.file=/etc/cortex/logback.xml -Dpidfile.path=/dev/null"
 PATH=/sbin:/bin:/usr/sbin:/usr/bin
 
-test -x $DAEMON || exit 0
+# Exit if the package is not installed
+[ -x "$DAEMON" ] || exit 0
 
-if test -f /etc/default/$NAME
-then
-    . /etc/default/$NAME
-fi
+# Read configuration variable file if it is present
+[ -r /etc/default/$NAME ] && . /etc/default/$NAME
 
+# Load the VERBOSE setting and other rcS variables
+. /lib/init/vars.sh
+
+# Define LSB log_* functions.
+# Depend on lsb-base (>= 3.2-14) to ensure that this file is present
+# and status_of_proc is working.
 . /lib/lsb/init-functions
 
+#
+# Function that starts the daemon/service
+#
+do_start() {
+        # Return
+        #   0 if daemon has been started
+        #   1 if daemon was already running
+        #   2 if daemon could not be started
+        start-stop-daemon --start --quiet --pidfile $PIDFILE --user $DAEMON_USER --exec $DAEMON --test > /dev/null \
+                || return 1
+        start-stop-daemon --start --quiet --pidfile $PIDFILE --user $DAEMON_USER --exec $DAEMON -- \
+                $DAEMON_ARGS \
+                || return 2
+}
+
+#
+# Function that stops the daemon/service
+#
+do_stop() {
+        # Return
+        #   0 if daemon has been stopped
+        #   1 if daemon was already stopped
+        #   2 if daemon could not be stopped
+        #   other if a failure occurred
+        start-stop-daemon --stop --quiet --retry=TERM/30/KILL/5 --pidfile $PIDFILE --name $NAME
+        RETVAL="$?"
+        [ "$RETVAL" = 2 ] && return 2
+        # Wait for children to finish too if this is a daemon that forks
+        # and if the daemon is only ever run from this initscript.
+        # If the above conditions are not satisfied then add some other code
+        # that waits for the process to drop all resources that could be
+        # needed by services started subsequently.  A last resort is to
+        # sleep for some time.
+        start-stop-daemon --stop --quiet --oknodo --retry=0/30/KILL/5 --exec $DAEMON
+        [ "$?" = 2 ] && return 2
+        # Many daemons don't delete their pidfiles when they exit.
+        rm -f $PIDFILE
+        return "$RETVAL"
+}
+
 check_for_upstart() {
   if init_is_upstart; then
+    echo "Your are using upstart. This script should not be used"
     exit $1
   fi
 }
 
-check_config_file() {
-  if test ! -e $CONFIGFILE
-  then
-    mkdir -p $(dirname $CONFIGFILE) 2>/dev/null || true
-    cat >> $CONFIGFILE <<- _EOF_
-      # Secret key
-      # ~~~~~
-      # The secret key is used to secure cryptographics functions.
-      # If you deploy your application to several instances be sure to use the same key!
-     play.crypto.secret="$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 64 | head -n 1)"
-_EOF_
-    chown $DAEMONUSER $CONFIGFILE
-    chmod o-rwx $CONFIGFILE
-  fi
-}
-
 case "$1" in
   start)
     check_for_upstart 1
-    check_config_file
-    log_daemon_msg "Starting Cortex" $NAME || true
-    if start-stop-daemon --start --quiet --oknodo --pidfile $PIDFILE --chdir $DAEMONDIR --exec $DAEMON -- -Dconfig.file=$CONFIGFILE -Dhttp.port=$LISTENPORT -Dpidfile.path=$PIDFILE $DAEMON_OPTS
-    then
-      log_end_msg 0 || true
-    else
-      log_end_msg 1 || true
+    if [ "$ENABLED" = no ]; then
+      echo "The service cortex is disabled (/etc/default/cortex)"
+      exit 1
     fi
+
+    [ "$VERBOSE" != no ] && log_daemon_msg "Starting $DESC" "$NAME"
+    do_start
+    case "$?" in
+      0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
+      2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
+    esac
     ;;
 
   stop)
     check_for_upstart 1
-    log_daemon_msg "Stopping Cortex" $NAME || true
-    if start-stop-daemon --stop --quiet --oknodo --pidfile $PIDFILE
-    then
-      log_end_msg 0 || true
-    else
-      log_end_msg 1 || true
-    fi
+    [ "$VERBOSE" != no ] && log_daemon_msg "Stopping $DESC" "$NAME"
+    do_stop
+    case "$?" in
+      0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
+      2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
+    esac
     ;;
 
   status)
diff --git a/install/cortex.conf b/install/cortex.conf
index 4cf80c3db..c12bd23fe 100644
--- a/install/cortex.conf
+++ b/install/cortex.conf
@@ -1,49 +1,41 @@
-# cortex - a FOSS Information Security Incident Management Platform
-#
+# generated upstart config
+
+description "Powerful Observable Analysis Engine"
+author "Thomas Franco <toom@thehive-project.org>"
 
-description	"Cortex"
+# Stanzas
+#
+# Stanzas control when and how a process is started and stopped
+# See a list of stanzas here: http://upstart.ubuntu.com/wiki/Stanzas#respawn
 
+# When to start the service
 start on runlevel [2345]
-stop on runlevel [!2345]
 
+
+# When to stop the service
+stop on runlevel [016]
+
+
+# Automatically restart process if crashed. Tries 1 times every 60 seconds
 respawn
-respawn limit 10 5
-umask 022
-
-
-env DAEMON=/opt/cortex/bin/cortex
-env PIDFILE=/var/run/cortex.pid
-env DAEMONUSER=cortex
-env CONFIGFILE=/etc/cortex/application.conf
-env LISTENPORT=9000
-env DAEMON_OPTS=
-env DEFAULTFILE=/etc/default/cortex
-
-
-pre-start script
-    echo Starting Cortex
-    if [ -f "$DEFAULTFILE" ]; then
-        . "$DEFAULTFILE"
-    fi
-
-    if test ! -e $CONFIGFILE
-    then
-        mkdir -p $(dirname $CONFIGFILE) 2>/dev/null || true
-        cat >> $CONFIGFILE <<- _EOF_
-          # Secret key
-          # ~~~~~
-          # The secret key is used to secure cryptographics functions.
-          # If you deploy your application to several instances be sure to use the same key!
-          play.crypto.secret="$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 64 | head -n 1)"
-_EOF_
-        chown $DAEMONUSER $CONFIGFILE
-        chmod o-rwx $CONFIGFILE
-    fi
-
-    test -x $DAEMON || { echo $DAEMON not found; stop; exit 0; }
-end script
+respawn limit 1 60
+
+normal exit 0
+
+# set the working directory of the job processes
+chdir /opt/cortex
 
+# Start the process
 script
-    cd $(dirname $DAEMON)/..
-    $DAEMON -Dconfig.file=$CONFIGFILE -Dhttp.port=$LISTENPORT -Dpidfile.path=$PIDFILE $DAEMON_OPTS
+  DAEMON_USER="cortex"
+  DAEMON_ARGS="-Dconfig.file=/etc/cortex/application.conf -Dlogger.file=/etc/cortex/logback.xml -Dpidfile.path=/dev/null"
+
+  . /etc/default/cortex
+
+  if [ "$ENABLED" = no ]; then
+    echo "The service cortex is disabled (/etc/default/cortex)"
+    exit 0
+  fi
+
+  exec sudo -u $DAEMON_USER bin/cortex $DAEMON_ARGS
 end script
diff --git a/install/cortex.service b/install/cortex.service
index e4e37d90c..3f235d827 100644
--- a/install/cortex.service
+++ b/install/cortex.service
@@ -1,23 +1,19 @@
 [Unit]
-Description=Cortex
-Documentation=https://cortex-project.org
+Description=cortex
+Documentation=https://thehive-project.org
 Wants=network-online.target
 After=network-online.target
 
 [Service]
-Environment=PID_DIR=/var/run/cortex
 WorkingDirectory=/opt/cortex
 
 User=cortex
 Group=cortex
 
-RuntimeDirectory=cortex
-RuntimeDirectoryMode=0750
-
 ExecStart=/opt/cortex/bin/cortex \
-                        -Dconfig.file=/etc/cortex/application.conf \
-                        -Dhttp.port=9000 \
-			-Dpidfile.path=${PID_DIR}/pid
+	-Dconfig.file=/etc/cortex/application.conf \
+	-Dlogger.file=/etc/cortex/logback.xml \
+	-Dpidfile.path=/dev/null
 
 StandardOutput=journal
 StandardError=inherit
diff --git a/install/docker/entrypoint b/install/docker/entrypoint
old mode 100644
new mode 100755
index e69de29bb..08f2fd167
--- a/install/docker/entrypoint
+++ b/install/docker/entrypoint
@@ -0,0 +1,55 @@
+#!/bin/bash
+
+CONFIG_SECRET=1
+CONFIG=1
+CONFIG_FILE=/etc/cortex/application.conf
+ANALYZER_PATH=/opt/Cortex-Analyzers/analyzers
+
+function usage {
+	cat <<- _EOF_
+		Available options:
+		--no-config		| do not try to configure Cortex (add secret and analyzers location)
+		--no-config-secret	| do not add random secret to configuration
+		--secret <secret>	| secret to secure sessions
+		--analyzer-path <path>	| where analyzers are located
+	_EOF_
+	exit 1
+}
+
+STOP=0
+while test $# -gt 0 -o $STOP = 1
+do
+	case "$1" in
+		"--no-config")		CONFIG=0;;
+		"--no-config-secret")	CONFIG_SECRET=0;;
+		"--secret")		shift; SECRET=$1;;
+		"--analyzer-path")	shift; ANALYZER_PATH=$1;;
+		"--")			STOP=1;;
+		*)			usage
+	esac
+	shift
+done
+
+if test $CONFIG = 1
+then
+	CONFIG_FILE=$(mktemp).conf
+	if test $CONFIG_SECRET = 1
+	then
+		if test -z "$SECRET"
+		then
+			SECRET=$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 64 | head -n 1)
+		fi
+		echo Using secret: $SECRET
+		echo play.crypto.secret=\"$SECRET\" >> $CONFIG_FILE
+	fi
+
+	echo analyzer.path=\"$ANALYZER_PATH\" >> $CONFIG_FILE
+
+	echo 'include file("/etc/cortex/application.conf")' >> $CONFIG_FILE
+fi
+
+exec bin/cortex \
+	-Dconfig.file=$CONFIG_FILE \
+	-Dlogger.file=/etc/cortex/logback.xml \
+	-Dpidfile.path=/dev/null \
+	$@
diff --git a/project/Bintray.scala b/project/Bintray.scala
index 7c3ad44e2..0d12083f2 100644
--- a/project/Bintray.scala
+++ b/project/Bintray.scala
@@ -15,8 +15,8 @@ import bintray.BintrayKeys.{ bintrayEnsureCredentials, bintrayOrganization, bint
 import com.typesafe.sbt.packager.universal.UniversalPlugin.autoImport.Universal
 
 object PublishToBinTray extends Plugin {
-  val publishRelease = taskKey[Unit]("Publish binary in bintray")
-  val publishLatest = taskKey[Unit]("Publish latest binary in bintray")
+  val publishRelease: TaskKey[Unit] = taskKey[Unit]("Publish binary in bintray")
+  val publishLatest: TaskKey[Unit] = taskKey[Unit]("Publish latest binary in bintray")
 
   override def settings = Seq(
     publishRelease := {
@@ -54,7 +54,7 @@ object PublishToBinTray extends Plugin {
 
   private def asStatusAndBody = new FunctionHandler({ r => (r.getStatusCode, r.getResponseBody) })
 
-  def removeVersion(credential: BintrayCredentials, org: Option[String], repoName: String, packageName: String, version: String, log: Logger) = {
+  def removeVersion(credential: BintrayCredentials, org: Option[String], repoName: String, packageName: String, version: String, log: Logger): Unit = {
     val BintrayCredentials(user, key) = credential
     val client: Client = Client(user, key, new Http())
     val repo: Client#Repo = client.repo(org.getOrElse(user), repoName)
diff --git a/project/BuildSettings.scala b/project/BuildSettings.scala
index cbb82d3a2..01995195b 100644
--- a/project/BuildSettings.scala
+++ b/project/BuildSettings.scala
@@ -2,7 +2,7 @@ import sbt.Keys._
 import sbt._
 
 object BasicSettings extends AutoPlugin {
-  override def trigger = allRequirements
+  override def trigger: PluginTrigger = allRequirements
 
   override def projectSettings = Seq(
     organization := "org.cert-bdf",

From 96f44f04e3b0c30f44c832e6c4535c6f366ae6e2 Mon Sep 17 00:00:00 2001
From: Jerome Leonard <jerome@upbeat.fr>
Date: Wed, 3 May 2017 12:11:23 +0200
Subject: [PATCH 05/32] #21 create intermediate program to load misp-modules
 from Cortex

---
 contrib/misp-modules-loader.py | 66 ++++++++++++++++++++++++++++++++++
 1 file changed, 66 insertions(+)
 create mode 100644 contrib/misp-modules-loader.py

diff --git a/contrib/misp-modules-loader.py b/contrib/misp-modules-loader.py
new file mode 100644
index 000000000..9f2718467
--- /dev/null
+++ b/contrib/misp-modules-loader.py
@@ -0,0 +1,66 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+
+import sys
+import os
+import getopt
+import json
+
+
+
+# modules_path = "./misp-modules/misp_modules/modules/expansion"
+# sys.path.append(modules_path)
+
+def run(argv):
+    try:
+        opts, args = getopt.getopt(argv, 'hp:i:r:', ["help","path=", "info=","run="])
+    except getopt.GetoptError as err:
+        print(__file__ + " --info <misp-module>")
+        print(__file__ + " --path <misp-modules path> --run <misp-module>")
+        print(str(err))
+        sys.exit(2)
+
+    module = None
+    path = None
+    for opt,arg in opts:
+
+        # TODO: check if module exist else exit
+        if opt in ('-h', '--help'):
+            print(__file__ + " --info <misp-module>")
+            print(__file__ + " --run <misp-module>")
+            sys.exit()
+
+        elif opt in ('-p', '--path'):
+            path = arg
+            sys.path.append(path)
+
+        elif opt in ('-r', '--run'):
+            module = arg
+            if path:
+                m = __import__(module)
+
+                data = json.load(sys.stdin)
+                print(json.dumps(m.handler(json.dumps(data))))
+                sys.exit(0)
+
+            else:
+                print("add module path")
+
+        elif opt in ('-i','--info'):
+            module = arg
+            print(module)
+            m = __import__(module)
+            print(({'name': module, 'mispattributes': m.mispattributes,
+                        'moduleinfo':m.moduleinfo}))
+
+
+
+
+if __name__ == '__main__':
+    if len(sys.argv[1:]) > 0:
+        run(sys.argv[1:])
+    else:
+        print(__file__ + " --info <misp-module>")
+        print(__file__ + " --run <misp-module>")
+        sys.exit(2)

From fa812a86a42ac19c738934d19ee824a64cd1be72 Mon Sep 17 00:00:00 2001
From: Jerome Leonard <jerome@upbeat.fr>
Date: Wed, 3 May 2017 12:36:45 +0200
Subject: [PATCH 06/32] #21 manage module path

---
 contrib/misp-modules-loader.py | 17 ++++++++---------
 1 file changed, 8 insertions(+), 9 deletions(-)

diff --git a/contrib/misp-modules-loader.py b/contrib/misp-modules-loader.py
index 9f2718467..e8afc72f8 100644
--- a/contrib/misp-modules-loader.py
+++ b/contrib/misp-modules-loader.py
@@ -8,16 +8,18 @@
 import json
 
 
+def mod(path):
+    dirname = os.path.dirname(path)
+    name = os.path.basename(path).split('.')[0]
+    return [dirname, name]
 
-# modules_path = "./misp-modules/misp_modules/modules/expansion"
-# sys.path.append(modules_path)
 
 def run(argv):
     try:
         opts, args = getopt.getopt(argv, 'hp:i:r:', ["help","path=", "info=","run="])
     except getopt.GetoptError as err:
         print(__file__ + " --info <misp-module>")
-        print(__file__ + " --path <misp-modules path> --run <misp-module>")
+        print(__file__ + "  --run <misp-module>")
         print(str(err))
         sys.exit(2)
 
@@ -31,14 +33,11 @@ def run(argv):
             print(__file__ + " --run <misp-module>")
             sys.exit()
 
-        elif opt in ('-p', '--path'):
-            path = arg
-            sys.path.append(path)
-
         elif opt in ('-r', '--run'):
-            module = arg
+            path = arg
             if path:
-                m = __import__(module)
+                sys.path.append(mod(path)[0])
+                m = __import__(mod(path)[1])
 
                 data = json.load(sys.stdin)
                 print(json.dumps(m.handler(json.dumps(data))))

From 5ad33a842b2aeaf01cfcbd6a2760b40f207f105f Mon Sep 17 00:00:00 2001
From: Jerome Leonard <jerome@upbeat.fr>
Date: Wed, 3 May 2017 12:39:46 +0200
Subject: [PATCH 07/32] #21 manage module path

---
 contrib/misp-modules-loader.py | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/contrib/misp-modules-loader.py b/contrib/misp-modules-loader.py
index e8afc72f8..0d868d447 100644
--- a/contrib/misp-modules-loader.py
+++ b/contrib/misp-modules-loader.py
@@ -48,7 +48,14 @@ def run(argv):
 
         elif opt in ('-i','--info'):
             module = arg
-            print(module)
+            if path:
+                sys.path.append(mod(path)[0])
+                m = __import__(mod(path)[1])
+
+                data = json.load(sys.stdin)
+                print(json.dumps(m.handler(json.dumps(data))))
+                sys.exit(0)
+
             m = __import__(module)
             print(({'name': module, 'mispattributes': m.mispattributes,
                         'moduleinfo':m.moduleinfo}))

From c042bc6ff664445b08d94f7785f6f714aa0c321f Mon Sep 17 00:00:00 2001
From: Jerome Leonard <jerome@upbeat.fr>
Date: Wed, 3 May 2017 12:43:05 +0200
Subject: [PATCH 08/32] #21 manage module path

---
 contrib/misp-modules-loader.py | 12 +++---------
 1 file changed, 3 insertions(+), 9 deletions(-)

diff --git a/contrib/misp-modules-loader.py b/contrib/misp-modules-loader.py
index 0d868d447..48d3bb079 100644
--- a/contrib/misp-modules-loader.py
+++ b/contrib/misp-modules-loader.py
@@ -16,7 +16,7 @@ def mod(path):
 
 def run(argv):
     try:
-        opts, args = getopt.getopt(argv, 'hp:i:r:', ["help","path=", "info=","run="])
+        opts, args = getopt.getopt(argv, 'hp:i:r:', ["help", "info=","run="])
     except getopt.GetoptError as err:
         print(__file__ + " --info <misp-module>")
         print(__file__ + "  --run <misp-module>")
@@ -47,17 +47,11 @@ def run(argv):
                 print("add module path")
 
         elif opt in ('-i','--info'):
-            module = arg
+            path = arg
             if path:
                 sys.path.append(mod(path)[0])
                 m = __import__(mod(path)[1])
-
-                data = json.load(sys.stdin)
-                print(json.dumps(m.handler(json.dumps(data))))
-                sys.exit(0)
-
-            m = __import__(module)
-            print(({'name': module, 'mispattributes': m.mispattributes,
+                print(({'name': module, 'mispattributes': m.mispattributes,
                         'moduleinfo':m.moduleinfo}))
 
 

From 7196b821e522af11533b13c5cb512995b5e87c25 Mon Sep 17 00:00:00 2001
From: Jerome Leonard <jerome@upbeat.fr>
Date: Wed, 3 May 2017 14:48:45 +0200
Subject: [PATCH 09/32] #21 use misp_modules builtin functions to list and get
 information from modules (need to install misp_modules)

---
 contrib/misp-modules-loader.py | 40 +++++++++++++++++-----------------
 1 file changed, 20 insertions(+), 20 deletions(-)

diff --git a/contrib/misp-modules-loader.py b/contrib/misp-modules-loader.py
index 48d3bb079..d3bfdcc77 100644
--- a/contrib/misp-modules-loader.py
+++ b/contrib/misp-modules-loader.py
@@ -7,16 +7,21 @@
 import getopt
 import json
 
+import misp_modules
 
-def mod(path):
-    dirname = os.path.dirname(path)
-    name = os.path.basename(path).split('.')[0]
-    return [dirname, name]
+"""
+git clone https://github.com/MISP/misp-modules.git
+cd misp_modules
+pip3 -r REQUIREMENTS
+pip3 install .
+"""
 
 
 def run(argv):
+
+    mhandlers, modules = misp_modules.load_package_modules()
     try:
-        opts, args = getopt.getopt(argv, 'hp:i:r:', ["help", "info=","run="])
+        opts, args = getopt.getopt(argv, 'lh:i:r:', ["list", "help", "info=","run="])
     except getopt.GetoptError as err:
         print(__file__ + " --info <misp-module>")
         print(__file__ + "  --run <misp-module>")
@@ -33,26 +38,21 @@ def run(argv):
             print(__file__ + " --run <misp-module>")
             sys.exit()
 
-        elif opt in ('-r', '--run'):
-            path = arg
-            if path:
-                sys.path.append(mod(path)[0])
-                m = __import__(mod(path)[1])
+        elif opt in ('-l', '--list'):
+                print(modules)
+                sys.exit(0)
 
+        elif opt in ('-r', '--run'):
+                module = arg
                 data = json.load(sys.stdin)
-                print(json.dumps(m.handler(json.dumps(data))))
+                print(json.dumps(mhandlers[module].handler(json.dumps(data))))
                 sys.exit(0)
 
-            else:
-                print("add module path")
-
         elif opt in ('-i','--info'):
-            path = arg
-            if path:
-                sys.path.append(mod(path)[0])
-                m = __import__(mod(path)[1])
-                print(({'name': module, 'mispattributes': m.mispattributes,
-                        'moduleinfo':m.moduleinfo}))
+            module = arg
+
+            print(({'name': module, 'mispattributes': mhandlers[module].mispattributes,
+                    'moduleinfo':mhandlers[module].moduleinfo}))
 
 
 

From 52bea41e2bf6f18fff7693e21a198dcd4742bf9d Mon Sep 17 00:00:00 2001
From: Jerome Leonard <jerome@upbeat.fr>
Date: Wed, 3 May 2017 15:04:07 +0200
Subject: [PATCH 10/32] #21 fix json issues

---
 contrib/misp-modules-loader.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/contrib/misp-modules-loader.py b/contrib/misp-modules-loader.py
index d3bfdcc77..8ffb19397 100644
--- a/contrib/misp-modules-loader.py
+++ b/contrib/misp-modules-loader.py
@@ -39,7 +39,7 @@ def run(argv):
             sys.exit()
 
         elif opt in ('-l', '--list'):
-                print(modules)
+                print(json.dumps(modules))
                 sys.exit(0)
 
         elif opt in ('-r', '--run'):
@@ -51,7 +51,7 @@ def run(argv):
         elif opt in ('-i','--info'):
             module = arg
 
-            print(({'name': module, 'mispattributes': mhandlers[module].mispattributes,
+            print(json.dumps({'name': module, 'mispattributes': mhandlers[module].mispattributes,
                     'moduleinfo':mhandlers[module].moduleinfo}))
 
 

From fa9babda398d1249c764823fe60832558eb3fc76 Mon Sep 17 00:00:00 2001
From: Jerome Leonard <jerome@upbeat.fr>
Date: Wed, 3 May 2017 15:27:32 +0200
Subject: [PATCH 11/32] #21 return only expansion modules

---
 contrib/misp-modules-loader.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/contrib/misp-modules-loader.py b/contrib/misp-modules-loader.py
index 8ffb19397..fb0ed9e83 100644
--- a/contrib/misp-modules-loader.py
+++ b/contrib/misp-modules-loader.py
@@ -39,8 +39,9 @@ def run(argv):
             sys.exit()
 
         elif opt in ('-l', '--list'):
-                print(json.dumps(modules))
-                sys.exit(0)
+            modules = [m for m in modules if mhandlers['type:' +  m ] == "expansion"]
+            print(json.dumps(modules))
+            sys.exit(0)
 
         elif opt in ('-r', '--run'):
                 module = arg

From c32353434b2d99e187e4ed69a917c2026fc693cf Mon Sep 17 00:00:00 2001
From: To-om <toom@thehive-project.org>
Date: Wed, 3 May 2017 12:16:30 +0200
Subject: [PATCH 12/32] #21 Add misp integration

---
 app/controllers/MispCtrl.scala |  29 +++++
 app/models/Artifact.scala      |  16 ++-
 app/models/MispModule.scala    |  73 +++++++++++
 app/services/Analyzer.scala    |  34 +++--
 app/services/Job.scala         |  29 ++---
 app/services/MispSrv.scala     | 228 +++++++++++++++++++++++++++++++++
 conf/routes                    |   4 +
 7 files changed, 383 insertions(+), 30 deletions(-)
 create mode 100644 app/controllers/MispCtrl.scala
 create mode 100644 app/models/MispModule.scala
 create mode 100644 app/services/MispSrv.scala

diff --git a/app/controllers/MispCtrl.scala b/app/controllers/MispCtrl.scala
new file mode 100644
index 000000000..312708b65
--- /dev/null
+++ b/app/controllers/MispCtrl.scala
@@ -0,0 +1,29 @@
+package controllers
+
+import javax.inject.Inject
+
+import play.api.libs.json.{ JsObject, JsValue }
+import play.api.mvc.{ Action, AnyContent, Controller }
+import services.MispSrv
+
+import scala.concurrent.ExecutionContext
+
+class MispCtrl @Inject() (mispSrv: MispSrv, implicit val ec: ExecutionContext) extends Controller {
+
+  def modules: Action[AnyContent] = Action { _ ⇒
+    Ok(mispSrv.moduleList)
+  }
+
+  def query: Action[JsValue] = Action.async(parse.json) { request ⇒
+    val module = (request.body \ "module").asOpt[String].getOrElse(sys.error("module not present in request"))
+    val (mispType, dataJson) = request.body.as[JsObject].fields
+      .collectFirst {
+        case kv @ (k, _) if k != "module" ⇒ kv
+      }
+      .getOrElse(sys.error("invalid request"))
+    val data = dataJson.asOpt[String].getOrElse(sys.error("data has invalid type (expected string)"))
+    mispSrv.query(module, mispType, data)
+      .map(Ok(_))
+  }
+}
+
diff --git a/app/models/Artifact.scala b/app/models/Artifact.scala
index c71a63439..b4a8f033e 100644
--- a/app/models/Artifact.scala
+++ b/app/models/Artifact.scala
@@ -1,23 +1,31 @@
 package models
 
-import play.api.libs.json.JsObject
 import java.io.File
+import java.nio.file.Files
+
+import play.api.libs.json.JsObject
 
 abstract class Artifact(attributes: JsObject) {
-  def dataTypeFilter(filter: String): Boolean = (attributes \ "dataType").asOpt[String].fold(false)(_.toLowerCase.contains(filter.toLowerCase))
+  def dataType: String = (attributes \ "dataType").asOpt[String].getOrElse("other")
+  def dataTypeFilter(filter: String): Boolean = dataType.toLowerCase.contains(filter.toLowerCase)
   def dataFilter(filter: String): Boolean = false
 }
 class FileArtifact(val data: File, val attributes: JsObject) extends Artifact(attributes) {
-  override def finalize {
+  override def finalize() {
     data.delete()
   }
 }
 object FileArtifact {
-  def apply(data: File, attributes: JsObject) = {
+  def apply(data: File, attributes: JsObject): FileArtifact = {
     val tempFile = File.createTempFile("cortex-", "-datafile")
     data.renameTo(tempFile)
     new FileArtifact(tempFile, attributes)
   }
+  def apply(data: Array[Byte], attributes: JsObject): FileArtifact = {
+    val tempFile = File.createTempFile("cortex-", "-datafile")
+    Files.write(tempFile.toPath, data)
+    new FileArtifact(tempFile, attributes)
+  }
   def unapply(fileArtifact: FileArtifact) = Some(fileArtifact.data → fileArtifact.attributes)
 }
 case class DataArtifact(data: String, attributes: JsObject) extends Artifact(attributes) {
diff --git a/app/models/MispModule.scala b/app/models/MispModule.scala
new file mode 100644
index 000000000..4e01ec929
--- /dev/null
+++ b/app/models/MispModule.scala
@@ -0,0 +1,73 @@
+package models
+
+import java.io._
+import java.nio.file.Path
+import java.nio.file.Files
+
+import org.apache.commons.codec.binary.{ Base64, Base64InputStream }
+import play.api.libs.json.{ JsObject, JsValue, Json }
+import services.MispSrv
+
+import scala.collection.JavaConverters._
+import scala.concurrent.{ ExecutionContext, Future }
+import scala.sys.process.{ BasicIO, Process, ProcessIO }
+import scala.sys.process._
+
+case class MispModule(
+  name: String,
+    version: String,
+    description: String,
+    dataTypeList: Seq[String],
+    author: String,
+    modulePath: Path,
+    loaderCommand: String)(implicit val ec: ExecutionContext) extends Analyzer {
+
+  val license = "AGPL-3.0"
+  val url = "https://github.com/MISP/misp-modules"
+
+  private def stringStream(string: String): InputStream = {
+    new ByteArrayInputStream(string.getBytes)
+  }
+  def analyze(artifact: Artifact): Future[JsObject] = {
+    val input = artifact match {
+      case DataArtifact(data, _) ⇒
+        stringStream(Json.obj(artifact.dataType → data).toString)
+      case FileArtifact(data, _) ⇒
+        new SequenceInputStream(Iterator(
+          stringStream("""{"file":""""),
+          new Base64InputStream(new FileInputStream(data), true),
+          stringStream("\"}")).asJavaEnumeration)
+    }
+    val output = (s"$loaderCommand --run $modulePath" #< input).!!
+    Future {
+      Json.parse(output).as[JsObject]
+    }
+  }
+}
+
+object MispModule {
+  def apply(
+    loaderCommand: String,
+    modulePath: Path,
+    mispSrv: MispSrv)(implicit ec: ExecutionContext): Option[MispModule] = {
+    val moduleInfo = Json.parse(s"$loaderCommand --info $modulePath".!!)
+    for {
+      name ← (moduleInfo \ "name").asOpt[String]
+      version ← (moduleInfo \ "moduleinfo" \ "version").asOpt[String]
+      description ← (moduleInfo \ "moduleinfo" \ "description").asOpt[String]
+      dataTypeList ← (moduleInfo \ "mispattributes" \ "input")
+        .asOpt[Seq[String]]
+        .map(_.map(mispSrv.mispType2dataType(_)))
+      author ← (moduleInfo \ "moduleinfo" \ "author").asOpt[String]
+    } yield MispModule(name, version, description, dataTypeList, author, modulePath, loaderCommand)
+  }
+}
+
+//{'mispattributes': {
+//   'input': ['ip-src', 'ip-dst', 'domain|ip'],
+//   'output': ['hostname']
+// },
+// 'moduleinfo': {
+//  'version': '0.1',
+// 'author': 'Andreas Muehlemann',
+// 'description': 'Simple Reverse DNS expansion service to resolve reverse DNS from MISP attributes', 'module-type': ['expansion', 'hover']}}
\ No newline at end of file
diff --git a/app/services/Analyzer.scala b/app/services/Analyzer.scala
index c64eef8b2..d063747d9 100644
--- a/app/services/Analyzer.scala
+++ b/app/services/Analyzer.scala
@@ -2,37 +2,41 @@ package services
 
 import java.io.File
 import java.nio.file.{ Files, Path, Paths }
-
 import javax.inject.Inject
 
-import scala.collection.JavaConversions.iterableAsScalaIterable
-import scala.concurrent.ExecutionContext
-
 import akka.actor.ActorSystem
-
-import play.api.{ Configuration, Logger }
+import models.{ Analyzer, ExternalAnalyzer, MispModule }
 import play.api.libs.json.{ JsObject, JsValue, Json }
-
-import models.{ Analyzer, ExternalAnalyzer }
+import play.api.{ Configuration, Logger }
 import util.JsonConfig.configWrites
+
+import scala.collection.JavaConversions.iterableAsScalaIterable
+import scala.concurrent.ExecutionContext
 import scala.util.Try
 
 class AnalyzerSrv(
+    mispSrv: MispSrv,
     analyzerPath: Path,
     analyzerConfig: JsObject,
+    mispModulesPath: Path,
+    mispModuleLoaderCommand: Option[String],
     akkaSystem: ActorSystem) {
   @Inject def this(
+    mispSrv: MispSrv,
     configuration: Configuration,
     akkaSystem: ActorSystem) =
     this(
+      mispSrv,
       Paths.get(configuration.getString("analyzer.path").getOrElse(".")),
       configWrites.writes(configuration.getConfig("analyzer.config").getOrElse(Configuration.empty)),
+      Paths.get(configuration.getString("misp.modules.path").getOrElse(".")),
+      configuration.getString("misp.modules.loader"),
       akkaSystem)
 
   lazy val log = Logger(getClass)
   lazy val analyzeExecutionContext: ExecutionContext = akkaSystem.dispatchers.lookup("analyzer")
 
-  lazy val externalAnalyzers: Seq[Analyzer] = getExternalAnalyzers
+  private lazy val externalAnalyzers: Seq[Analyzer] = getExternalAnalyzers
   def list: Seq[Analyzer] = externalAnalyzers // ::: javaAnalyzers
   def get(analyzerId: String): Option[Analyzer] = list.find(_.id == analyzerId)
   def listForType(dataType: String): Seq[Analyzer] = list.filter(_.dataTypeList.contains(dataType))
@@ -79,6 +83,18 @@ class AnalyzerSrv(
     } yield ExternalAnalyzer(name, version, description, dataTypeList, author, url, license, absoluteCommand, globalConfig deepMerge baseConfig deepMerge config)(analyzeExecutionContext)
   }
 
+  private[services] def getMispModules: Seq[Analyzer] = {
+    for {
+      moduleFile ← Try(Files.newDirectoryStream(mispModulesPath).toSeq).getOrElse {
+        log.warn(s"MISP modules directory ($mispModulesPath) is not found")
+        Nil
+      }
+      loaderCommand ← mispModuleLoaderCommand
+      if Files.isRegularFile(moduleFile) && moduleFile.toString.endsWith(".py")
+      mispModule ← MispModule(loaderCommand, moduleFile, mispSrv)(analyzeExecutionContext)
+    } yield mispModule
+  }
+
   private[services] def readInfo(file: Path): JsValue = {
     val source = scala.io.Source.fromFile(file.toFile)
     try {
diff --git a/app/services/Job.scala b/app/services/Job.scala
index 1e8742da9..c66a7b455 100644
--- a/app/services/Job.scala
+++ b/app/services/Job.scala
@@ -1,31 +1,26 @@
 package services
 
 import java.util.Date
-
 import javax.inject.{ Inject, Named }
 
-import scala.annotation.implicitNotFound
-import scala.concurrent.{ ExecutionContext, Future, Promise }
-import scala.concurrent.duration.{ DurationInt, FiniteDuration }
-import scala.concurrent.duration.Duration
-import scala.concurrent.duration.Duration.Infinite
-import scala.util.Random
-
 import akka.actor.{ Actor, ActorRef, ActorSystem, actorRef2Scala }
 import akka.pattern.ask
 import akka.util.Timeout
-
-import play.api.{ Configuration, Logger }
+import models.{ Analyzer, Artifact, Job, JobStatus }
 import play.api.libs.json.{ JsString, JsValue }
+import play.api.{ Configuration, Logger }
 
-import models.{ Analyzer, Artifact, Job, JobStatus }
+import scala.concurrent.duration.Duration.Infinite
+import scala.concurrent.duration.{ Duration, DurationInt, FiniteDuration }
+import scala.concurrent.{ ExecutionContext, Future, Promise }
+import scala.util.Random
 
 class JobSrv @Inject() (
     analyzerSrv: AnalyzerSrv,
     @Named("JobActor") jobActor: ActorRef,
     implicit val ec: ExecutionContext,
     implicit val system: ActorSystem) {
-  import JobActor._
+  import services.JobActor._
   implicit val timeout = Timeout(5.seconds)
 
   def list(dataTypeFilter: Option[String], dataFilter: Option[String], analyzerFilter: Option[String], start: Int, limit: Int): Future[(Int, Seq[Job])] = {
@@ -71,8 +66,8 @@ class JobSrv @Inject() (
       case _: Infinite ⇒ statusResult
       case duration: FiniteDuration ⇒
         val prom = Promise[(JobStatus.Type, JsValue)]()
-        val timeout = system.scheduler.scheduleOnce(duration) { prom.success((JobStatus.Failure, JsString("Timeout"))); () }
-        statusResult onComplete { case _ ⇒ timeout.cancel() }
+        val timeout = system.scheduler.scheduleOnce(duration) { prom.success((JobStatus.InProgress, JsString("Timeout"))); () }
+        statusResult.onComplete(_ ⇒ timeout.cancel())
         Future.firstCompletedOf(List(statusResult, prom.future))
     }
   }
@@ -95,7 +90,7 @@ class JobActor(
     analyzerSrv: AnalyzerSrv,
     implicit val ec: ExecutionContext) extends Actor {
 
-  import JobActor._
+  import services.JobActor._
   @Inject def this(
     configuration: Configuration,
     analyzerSrv: AnalyzerSrv,
@@ -128,7 +123,7 @@ class JobActor(
         dataTypeFilter.fold(true)(j.artifact.dataTypeFilter) &&
           dataFilter.fold(true)(j.artifact.dataFilter) &&
           analyzerFilter.fold(true)(j.analyzerId.contains))
-      sender ! JobList(filteredJobs.size, filteredJobs.drop(start).take(limit))
+      sender ! JobList(filteredJobs.size, filteredJobs.slice(start, start + limit))
     case GetJob(jobId) ⇒ sender ! jobs.find(_.id == jobId).getOrElse(JobNotFound)
     case RemoveJob(jobId) ⇒
       removeJob(jobs, jobId) match {
@@ -148,5 +143,5 @@ class JobActor(
       context.become(jobState(jobs.takeWhile(_.date after limitDate)))
   }
 
-  override def receive = jobState(Nil)
+  override def receive: Receive = jobState(Nil)
 }
\ No newline at end of file
diff --git a/app/services/MispSrv.scala b/app/services/MispSrv.scala
new file mode 100644
index 000000000..869c8c13a
--- /dev/null
+++ b/app/services/MispSrv.scala
@@ -0,0 +1,228 @@
+package services
+
+import javax.inject.Inject
+
+import models.JsonFormat.dataActifactReads
+import models.{ DataArtifact, FileArtifact }
+import org.apache.commons.codec.binary.Base64
+import play.api.Logger
+import play.api.libs.json.{ JsArray, JsObject, JsValue, Json }
+
+import scala.concurrent.{ ExecutionContext, Future }
+
+class MispSrv @Inject() (analyzerSrv: AnalyzerSrv) {
+  private[MispSrv] lazy val logger = Logger(getClass)
+
+  def moduleList: JsValue = {
+    JsArray(analyzerSrv.list.map { analyzer ⇒
+      Json.obj(
+        "name" → analyzer.id,
+        "type" → "expansion",
+        "mispattributes" → Json.obj(
+          "input" → analyzer.dataTypeList.flatMap(dataType2mispType).distinct,
+          "output" → Json.arr()),
+        "meta" → Json.obj(
+          "module-type" → Json.arr("expansion"),
+          "description" → analyzer.description,
+          "author" → analyzer.author,
+          "version" → analyzer.version,
+          "config" → Json.arr()))
+    })
+  }
+
+  def query(module: String, mispType: String, data: String)(implicit ec: ExecutionContext): Future[JsObject] = {
+    analyzerSrv.get(module).map { analyzer ⇒
+      val artifact = mispType2dataType(mispType) match {
+        case "file" if mispType == "malware-sample" ⇒ ???
+        case "file" ⇒ FileArtifact(Base64.decodeBase64(data), Json.obj(
+          "tlp" → 1,
+          "dataType" → "file"))
+        case dataType ⇒ DataArtifact(data, Json.obj(
+          "tlp" → 1,
+          "dataType" → dataType))
+      }
+
+      analyzer
+        .analyze(artifact)
+        .map { output ⇒
+          logger.info(s"analyzer output:\n$output")
+          val success = (output \ "success")
+            .asOpt[Boolean]
+            .getOrElse(false)
+          if (success) {
+            Json.obj(
+              "results" → (output \ "artifacts")
+                .asOpt[Seq[JsObject]]
+                .getOrElse(Nil)
+                .map { artifact ⇒
+                  Json.obj(
+                    "types" → dataType2mispType((artifact \ "type").as[String]),
+                    "values" → Json.arr((artifact \ "value").as[String]))
+                })
+          }
+          else {
+            val message = (output \ "error").asOpt[String].getOrElse(output.toString)
+            Json.obj(
+              "error" → message)
+          }
+        }
+    }
+      .getOrElse(Future.failed(new Exception(s"Module $module not found")))
+  }
+
+  def mispType2dataType(mispType: String): String = typeLookup.getOrElse(mispType, {
+    logger.warn(s"Misp type $mispType not recognized")
+    "other"
+  })
+
+  def dataType2mispType(dataType: String): Seq[String] = {
+    val mispTypes = typeLookup.filter(_._2 == dataType)
+      .keys
+      .toSeq
+      .distinct
+
+    if (mispTypes.isEmpty) {
+      logger.warn(s"Data type $dataType not recognized")
+      Seq("other")
+    }
+    else mispTypes
+  }
+
+  private val typeLookup = Map(
+    "md5" → "hash",
+    "sha1" → "hash",
+    "sha256" → "hash",
+    "filename" → "filename",
+    "pdb" → "other",
+    "filename|md5" → "other",
+    "filename|sha1" → "other",
+    "filename|sha256" → "other",
+    "ip-src" → "ip",
+    "ip-dst" → "ip",
+    "hostname" → "fqdn",
+    "domain" → "domain",
+    "domain|ip" → "other",
+    "email-src" → "mail",
+    "email-dst" → "mail",
+    "email-subject" → "mail_subject",
+    "email-attachment" → "other",
+    "float" → "other",
+    "url" → "url",
+    "http-method" → "other",
+    "user-agent" → "user-agent",
+    "regkey" → "registry",
+    "regkey|value" → "registry",
+    "AS" → "other",
+    "snort" → "other",
+    "pattern-in-file" → "other",
+    "pattern-in-traffic" → "other",
+    "pattern-in-memory" → "other",
+    "yara" → "other",
+    "sigma" → "other",
+    "vulnerability" → "other",
+    "attachment" → "file",
+    "malware-sample" → "file",
+    "link" → "other",
+    "comment" → "other",
+    "text" → "other",
+    "hex" → "other",
+    "other" → "other",
+    "named" → "other",
+    "mutex" → "other",
+    "target-user" → "other",
+    "target-email" → "mail",
+    "target-machine" → "hostname",
+    "target-org" → "other",
+    "target-location" → "other",
+    "target-external" → "other",
+    "btc" → "other",
+    "iban" → "other",
+    "bic" → "other",
+    "bank-account-nr" → "other",
+    "aba-rtn" → "other",
+    "bin" → "other",
+    "cc-number" → "other",
+    "prtn" → "other",
+    "threat-actor" → "other",
+    "campaign-name" → "other",
+    "campaign-id" → "other",
+    "malware-type" → "other",
+    "uri" → "uri_path",
+    "authentihash" → "other",
+    "ssdeep" → "hash",
+    "imphash" → "hash",
+    "pehash" → "hash",
+    "impfuzzy" → "hash",
+    "sha224" → "hash",
+    "sha384" → "hash",
+    "sha512" → "hash",
+    "sha512/224" → "hash",
+    "sha512/256" → "hash",
+    "tlsh" → "other",
+    "filename|authentihash" → "other",
+    "filename|ssdeep" → "other",
+    "filename|imphash" → "other",
+    "filename|impfuzzy" → "other",
+    "filename|pehash" → "other",
+    "filename|sha224" → "other",
+    "filename|sha384" → "other",
+    "filename|sha512" → "other",
+    "filename|sha512/224" → "other",
+    "filename|sha512/256" → "other",
+    "filename|tlsh" → "other",
+    "windows-scheduled-task" → "other",
+    "windows-service-name" → "other",
+    "windows-service-displayname" → "other",
+    "whois-registrant-email" → "mail",
+    "whois-registrant-phone" → "other",
+    "whois-registrant-name" → "other",
+    "whois-registrar" → "other",
+    "whois-creation-date" → "other",
+    "x509-fingerprint-sha1" → "other",
+    "dns-soa-email" → "other",
+    "size-in-bytes" → "other",
+    "counter" → "other",
+    "datetime" → "other",
+    "cpe" → "other",
+    "port" → "other",
+    "ip-dst|port" → "other",
+    "ip-src|port" → "other",
+    "hostname|port" → "other",
+    "email-dst-display-name" → "other",
+    "email-src-display-name" → "other",
+    "email-header" → "other",
+    "email-reply-to" → "other",
+    "email-x-mailer" → "other",
+    "email-mime-boundary" → "other",
+    "email-thread-index" → "other",
+    "email-message-id" → "other",
+    "github-username" → "other",
+    "github-repository" → "other",
+    "github-organisation" → "other",
+    "jabber-id" → "other",
+    "twitter-id" → "other",
+    "first-name" → "other",
+    "middle-name" → "other",
+    "last-name" → "other",
+    "date-of-birth" → "other",
+    "place-of-birth" → "other",
+    "gender" → "other",
+    "passport-number" → "other",
+    "passport-country" → "other",
+    "passport-expiration" → "other",
+    "redress-number" → "other",
+    "nationality" → "other",
+    "visa-number" → "other",
+    "issue-date-of-the-visa" → "other",
+    "primary-residence" → "other",
+    "country-of-residence" → "other",
+    "special-service-request" → "other",
+    "frequent-flyer-number" → "other",
+    "travel-details" → "other",
+    "payment-details" → "other",
+    "place-port-of-original-embarkation" → "other",
+    "place-port-of-clearance" → "other",
+    "place-port-of-onward-foreign-destination" → "other",
+    "passenger-name-record-locator-number" → "other",
+    "mobile-application-id" → "other")
+}
\ No newline at end of file
diff --git a/conf/routes b/conf/routes
index 00bf1381f..0b44c2cc4 100644
--- a/conf/routes
+++ b/conf/routes
@@ -2,6 +2,7 @@
 # This file defines all application routes (Higher priority routes first)
 # ~~~~
 
+
 GET      /                              controllers.Default.redirect(to = "/index.html")
 GET      /api/analyzer                  controllers.AnalyzerCtrl.list
 GET      /api/analyzer/:id              controllers.AnalyzerCtrl.get(id)
@@ -12,4 +13,7 @@ GET      /api/job/:id                   controllers.JobCtrl.get(id)
 DELETE   /api/job/:id                   controllers.JobCtrl.remove(id)
 GET      /api/job/:id/report            controllers.JobCtrl.report(id)
 GET      /api/job/:id/waitreport        controllers.JobCtrl.waitReport(id, atMost ?= "Inf")
+GET	 /modules			controllers.MispCtrl.modules
+POST	 /query                         controllers.MispCtrl.query
 GET      /*file                         controllers.AssetCtrl.get(file)
+

From f68b41a80bffc3eda736fb4f7c9698f371b18eee Mon Sep 17 00:00:00 2001
From: To-om <toom@thehive-project.org>
Date: Wed, 3 May 2017 12:28:56 +0200
Subject: [PATCH 13/32] #21 Fix cyclic dependency, rename logger, make
 misp-modules-loader executable

---
 app/services/Analyzer.scala    | 36 ++++++++++++++++++----------------
 contrib/misp-modules-loader.py |  0
 2 files changed, 19 insertions(+), 17 deletions(-)
 mode change 100644 => 100755 contrib/misp-modules-loader.py

diff --git a/app/services/Analyzer.scala b/app/services/Analyzer.scala
index d063747d9..6e9bb5518 100644
--- a/app/services/Analyzer.scala
+++ b/app/services/Analyzer.scala
@@ -2,7 +2,7 @@ package services
 
 import java.io.File
 import java.nio.file.{ Files, Path, Paths }
-import javax.inject.Inject
+import javax.inject.{ Inject, Provider }
 
 import akka.actor.ActorSystem
 import models.{ Analyzer, ExternalAnalyzer, MispModule }
@@ -15,29 +15,31 @@ import scala.concurrent.ExecutionContext
 import scala.util.Try
 
 class AnalyzerSrv(
-    mispSrv: MispSrv,
+    mispSrvProvider: Provider[MispSrv],
     analyzerPath: Path,
     analyzerConfig: JsObject,
     mispModulesPath: Path,
     mispModuleLoaderCommand: Option[String],
     akkaSystem: ActorSystem) {
   @Inject def this(
-    mispSrv: MispSrv,
+    mispSrvProvider: Provider[MispSrv],
     configuration: Configuration,
     akkaSystem: ActorSystem) =
     this(
-      mispSrv,
+      mispSrvProvider,
       Paths.get(configuration.getString("analyzer.path").getOrElse(".")),
       configWrites.writes(configuration.getConfig("analyzer.config").getOrElse(Configuration.empty)),
       Paths.get(configuration.getString("misp.modules.path").getOrElse(".")),
       configuration.getString("misp.modules.loader"),
       akkaSystem)
 
-  lazy val log = Logger(getClass)
+  private[AnalyzerSrv] lazy val logger = Logger(getClass)
   lazy val analyzeExecutionContext: ExecutionContext = akkaSystem.dispatchers.lookup("analyzer")
+  lazy val mispSrv = mispSrvProvider.get
 
   private lazy val externalAnalyzers: Seq[Analyzer] = getExternalAnalyzers
-  def list: Seq[Analyzer] = externalAnalyzers // ::: javaAnalyzers
+  private lazy val mispModules: Seq[Analyzer] = getMispModules
+  def list: Seq[Analyzer] = externalAnalyzers ++ mispModules // ::: javaAnalyzers
   def get(analyzerId: String): Option[Analyzer] = list.find(_.id == analyzerId)
   def listForType(dataType: String): Seq[Analyzer] = list.filter(_.dataTypeList.contains(dataType))
 
@@ -45,7 +47,7 @@ class AnalyzerSrv(
     val globalConfig = (analyzerConfig \ "global").asOpt[JsObject].getOrElse(JsObject(Nil))
     for {
       analyzerDir ← Try(Files.newDirectoryStream(analyzerPath).toSeq).getOrElse {
-        log.warn(s"Analyzer directory ($analyzerPath) is not found")
+        logger.warn(s"Analyzer directory ($analyzerPath) is not found")
         Nil
       }
       if Files.isDirectory(analyzerDir)
@@ -53,40 +55,40 @@ class AnalyzerSrv(
       if Files.isReadable(infoFile)
       info = readInfo(infoFile)
       name ← (info \ "name").asOpt[String] orElse {
-        log.warn(s"name is missing in $infoFile"); None
+        logger.warn(s"name is missing in $infoFile"); None
       }
       version ← (info \ "version").asOpt[String] orElse {
-        log.warn(s"version is missing in $infoFile"); None
+        logger.warn(s"version is missing in $infoFile"); None
       }
       description ← (info \ "description").asOpt[String] orElse {
-        log.warn(s"description is missing in $infoFile"); None
+        logger.warn(s"description is missing in $infoFile"); None
       }
       dataTypeList ← (info \ "dataTypeList").asOpt[Seq[String]] orElse {
-        log.warn(s"dataTypeList is missing in $infoFile"); None
+        logger.warn(s"dataTypeList is missing in $infoFile"); None
       }
       command ← (info \ "command").asOpt[String] orElse {
-        log.warn(s"command is missing in $infoFile"); None
+        logger.warn(s"command is missing in $infoFile"); None
       }
       author ← (info \ "author").asOpt[String] orElse {
-        log.warn(s"author is missing in $infoFile"); None
+        logger.warn(s"author is missing in $infoFile"); None
       }
       url ← (info \ "url").asOpt[String] orElse {
-        log.warn(s"url is missing in $infoFile"); None
+        logger.warn(s"url is missing in $infoFile"); None
       }
       license ← (info \ "license").asOpt[String] orElse {
-        log.warn(s"license is missing in $infoFile"); None
+        logger.warn(s"license is missing in $infoFile"); None
       }
       config = (info \ "config").asOpt[JsObject].getOrElse(JsObject(Nil))
       baseConfig = (info \ "baseConfig").asOpt[String].flatMap(c ⇒ (analyzerConfig \ c).asOpt[JsObject]).getOrElse(JsObject(Nil))
       absoluteCommand = analyzerPath.resolve(Paths.get(command.replaceAll("[\\/]", File.separator)))
-      _ = log.info(s"Register analyzer $name $version (${(name + "_" + version).replaceAll("\\.", "_")})")
+      _ = logger.info(s"Register analyzer $name $version (${(name + "_" + version).replaceAll("\\.", "_")})")
     } yield ExternalAnalyzer(name, version, description, dataTypeList, author, url, license, absoluteCommand, globalConfig deepMerge baseConfig deepMerge config)(analyzeExecutionContext)
   }
 
   private[services] def getMispModules: Seq[Analyzer] = {
     for {
       moduleFile ← Try(Files.newDirectoryStream(mispModulesPath).toSeq).getOrElse {
-        log.warn(s"MISP modules directory ($mispModulesPath) is not found")
+        logger.warn(s"MISP modules directory ($mispModulesPath) is not found")
         Nil
       }
       loaderCommand ← mispModuleLoaderCommand
diff --git a/contrib/misp-modules-loader.py b/contrib/misp-modules-loader.py
old mode 100644
new mode 100755

From a742623457678134ba658be86b185789f7adb1a1 Mon Sep 17 00:00:00 2001
From: To-om <toom@thehive-project.org>
Date: Wed, 3 May 2017 15:27:28 +0200
Subject: [PATCH 14/32] #Fix Json format for MISP modules

---
 app/controllers/StatusCtrl.scala | 25 ++++++++++
 app/models/MispModule.scala      | 80 +++++++++++++++++++++-----------
 app/services/Analyzer.scala      | 16 +++----
 app/services/MispSrv.scala       | 11 +++--
 conf/routes                      |  1 +
 5 files changed, 93 insertions(+), 40 deletions(-)
 create mode 100644 app/controllers/StatusCtrl.scala

diff --git a/app/controllers/StatusCtrl.scala b/app/controllers/StatusCtrl.scala
new file mode 100644
index 000000000..7f0308283
--- /dev/null
+++ b/app/controllers/StatusCtrl.scala
@@ -0,0 +1,25 @@
+package controllers
+
+import javax.inject.{ Inject, Singleton }
+
+import play.api.Configuration
+import play.api.libs.json.Json
+import play.api.libs.json.Json.toJsFieldJsValueWrapper
+import play.api.mvc.{ Action, Controller }
+
+@Singleton
+class StatusCtrl @Inject() (
+    configuration: Configuration) extends Controller {
+
+  private[controllers] def getVersion(c: Class[_]) = Option(c.getPackage.getImplementationVersion).getOrElse("SNAPSHOT")
+
+  def get = Action { _ ⇒
+    Ok(Json.obj(
+      "versions" → Json.obj(
+        "Cortex" → getVersion(classOf[models.Artifact]),
+        "Play" → getVersion(classOf[Controller])),
+      "config" → Json.obj(
+        "authType" → "none",
+        "capabilities" → Json.arr())))
+  }
+}
diff --git a/app/models/MispModule.scala b/app/models/MispModule.scala
index 4e01ec929..a715abdfd 100644
--- a/app/models/MispModule.scala
+++ b/app/models/MispModule.scala
@@ -1,25 +1,25 @@
 package models
 
 import java.io._
-import java.nio.file.Path
-import java.nio.file.Files
 
-import org.apache.commons.codec.binary.{ Base64, Base64InputStream }
-import play.api.libs.json.{ JsObject, JsValue, Json }
+import org.apache.commons.codec.binary.Base64InputStream
+import play.api.Logger
+import play.api.libs.json.{ JsObject, Json }
 import services.MispSrv
 
 import scala.collection.JavaConverters._
 import scala.concurrent.{ ExecutionContext, Future }
-import scala.sys.process.{ BasicIO, Process, ProcessIO }
 import scala.sys.process._
+import scala.util.{ Failure, Success, Try }
 
 case class MispModule(
-  name: String,
+    mispSrv: MispSrv,
+    name: String,
     version: String,
     description: String,
     dataTypeList: Seq[String],
     author: String,
-    modulePath: Path,
+    moduleName: String,
     loaderCommand: String)(implicit val ec: ExecutionContext) extends Analyzer {
 
   val license = "AGPL-3.0"
@@ -31,14 +31,14 @@ case class MispModule(
   def analyze(artifact: Artifact): Future[JsObject] = {
     val input = artifact match {
       case DataArtifact(data, _) ⇒
-        stringStream(Json.obj(artifact.dataType → data).toString)
+        stringStream(Json.obj(mispSrv.dataType2mispType(artifact.dataType).head → data).toString)
       case FileArtifact(data, _) ⇒
         new SequenceInputStream(Iterator(
-          stringStream("""{"file":""""),
+          stringStream("""{"attachment":""""),
           new Base64InputStream(new FileInputStream(data), true),
           stringStream("\"}")).asJavaEnumeration)
     }
-    val output = (s"$loaderCommand --run $modulePath" #< input).!!
+    val output = (s"$loaderCommand --run $moduleName" #< input).!!
     Future {
       Json.parse(output).as[JsObject]
     }
@@ -46,28 +46,52 @@ case class MispModule(
 }
 
 object MispModule {
+  private[MispModule] lazy val logger = Logger(getClass)
+  def list(loaderCommand: String): Seq[String] =
+    Json.parse(s"$loaderCommand --list".!!).as[Seq[String]]
+
   def apply(
     loaderCommand: String,
-    modulePath: Path,
+    moduleName: String,
     mispSrv: MispSrv)(implicit ec: ExecutionContext): Option[MispModule] = {
-    val moduleInfo = Json.parse(s"$loaderCommand --info $modulePath".!!)
+    println(s"Loading MISP module $moduleName")
     for {
-      name ← (moduleInfo \ "name").asOpt[String]
-      version ← (moduleInfo \ "moduleinfo" \ "version").asOpt[String]
-      description ← (moduleInfo \ "moduleinfo" \ "description").asOpt[String]
+      moduleInfo ← Try(Json.parse(s"$loaderCommand --info $moduleName".!!)) match {
+        case Success(s) ⇒ Some(s)
+        case Failure(f) ⇒
+          f.printStackTrace()
+          None
+      }
+      name ← (moduleInfo \ "name").asOpt[String].orElse {
+        println("name not defined")
+        None
+      }
+      version ← (moduleInfo \ "moduleinfo" \ "version").asOpt[String].orElse {
+        println("version not defined")
+        None
+      }
+      description ← (moduleInfo \ "moduleinfo" \ "description").asOpt[String].orElse {
+        println("description not defined")
+        None
+      }
       dataTypeList ← (moduleInfo \ "mispattributes" \ "input")
         .asOpt[Seq[String]]
-        .map(_.map(mispSrv.mispType2dataType(_)))
-      author ← (moduleInfo \ "moduleinfo" \ "author").asOpt[String]
-    } yield MispModule(name, version, description, dataTypeList, author, modulePath, loaderCommand)
+        .map(_.map(mispSrv.mispType2dataType(_)).distinct)
+        .orElse {
+          println("input attributes not defined")
+          None
+        }
+      author ← (moduleInfo \ "moduleinfo" \ "author").asOpt[String].orElse {
+        println("author not defined")
+        None
+      }
+      mispModule ← Try(MispModule(mispSrv, name, version, description, dataTypeList, author, moduleName, loaderCommand)) match {
+        case Success(s) ⇒ Some(s)
+        case Failure(f) ⇒
+          f.printStackTrace()
+          sys.error("Load module fails")
+      }
+      _ = println("Module load succeed")
+    } yield mispModule
   }
-}
-
-//{'mispattributes': {
-//   'input': ['ip-src', 'ip-dst', 'domain|ip'],
-//   'output': ['hostname']
-// },
-// 'moduleinfo': {
-//  'version': '0.1',
-// 'author': 'Andreas Muehlemann',
-// 'description': 'Simple Reverse DNS expansion service to resolve reverse DNS from MISP attributes', 'module-type': ['expansion', 'hover']}}
\ No newline at end of file
+}
\ No newline at end of file
diff --git a/app/services/Analyzer.scala b/app/services/Analyzer.scala
index 6e9bb5518..b69c56cd6 100644
--- a/app/services/Analyzer.scala
+++ b/app/services/Analyzer.scala
@@ -2,7 +2,7 @@ package services
 
 import java.io.File
 import java.nio.file.{ Files, Path, Paths }
-import javax.inject.{ Inject, Provider }
+import javax.inject.{ Inject, Provider, Singleton }
 
 import akka.actor.ActorSystem
 import models.{ Analyzer, ExternalAnalyzer, MispModule }
@@ -14,6 +14,7 @@ import scala.collection.JavaConversions.iterableAsScalaIterable
 import scala.concurrent.ExecutionContext
 import scala.util.Try
 
+@Singleton
 class AnalyzerSrv(
     mispSrvProvider: Provider[MispSrv],
     analyzerPath: Path,
@@ -87,13 +88,12 @@ class AnalyzerSrv(
 
   private[services] def getMispModules: Seq[Analyzer] = {
     for {
-      moduleFile ← Try(Files.newDirectoryStream(mispModulesPath).toSeq).getOrElse {
-        logger.warn(s"MISP modules directory ($mispModulesPath) is not found")
-        Nil
-      }
-      loaderCommand ← mispModuleLoaderCommand
-      if Files.isRegularFile(moduleFile) && moduleFile.toString.endsWith(".py")
-      mispModule ← MispModule(loaderCommand, moduleFile, mispSrv)(analyzeExecutionContext)
+      loaderCommand ← mispModuleLoaderCommand.toSeq
+      moduleName ← MispModule.list(loaderCommand)
+
+      _ = println("MISP module loading ...")
+      mispModule ← MispModule(loaderCommand, moduleName, mispSrv)(analyzeExecutionContext)
+      _ = println("MISP module load success")
     } yield mispModule
   }
 
diff --git a/app/services/MispSrv.scala b/app/services/MispSrv.scala
index 869c8c13a..e11253e35 100644
--- a/app/services/MispSrv.scala
+++ b/app/services/MispSrv.scala
@@ -17,12 +17,12 @@ class MispSrv @Inject() (analyzerSrv: AnalyzerSrv) {
     JsArray(analyzerSrv.list.map { analyzer ⇒
       Json.obj(
         "name" → analyzer.id,
-        "type" → "expansion",
+        "type" → "cortex",
         "mispattributes" → Json.obj(
           "input" → analyzer.dataTypeList.flatMap(dataType2mispType).distinct,
           "output" → Json.arr()),
         "meta" → Json.obj(
-          "module-type" → Json.arr("expansion"),
+          "module-type" → Json.arr("cortex"),
           "description" → analyzer.description,
           "author" → analyzer.author,
           "version" → analyzer.version,
@@ -51,14 +51,17 @@ class MispSrv @Inject() (analyzerSrv: AnalyzerSrv) {
             .getOrElse(false)
           if (success) {
             Json.obj(
-              "results" → (output \ "artifacts")
+              "results" → ((output \ "artifacts")
                 .asOpt[Seq[JsObject]]
                 .getOrElse(Nil)
                 .map { artifact ⇒
                   Json.obj(
                     "types" → dataType2mispType((artifact \ "type").as[String]),
                     "values" → Json.arr((artifact \ "value").as[String]))
-                })
+                }
+                :+ Json.obj(
+                  "types" → Json.arr("cortex"),
+                  "values" → Json.arr(output.toString))))
           }
           else {
             val message = (output \ "error").asOpt[String].getOrElse(output.toString)
diff --git a/conf/routes b/conf/routes
index 0b44c2cc4..5685860b8 100644
--- a/conf/routes
+++ b/conf/routes
@@ -4,6 +4,7 @@
 
 
 GET      /                              controllers.Default.redirect(to = "/index.html")
+GET      /api/status                    controllers.StatusCtrl.get
 GET      /api/analyzer                  controllers.AnalyzerCtrl.list
 GET      /api/analyzer/:id              controllers.AnalyzerCtrl.get(id)
 POST     /api/analyzer/:id/run          controllers.AnalyzerCtrl.analyze(id)

From f84342fdd7cc65b101b11f9403bd1573223122ac Mon Sep 17 00:00:00 2001
From: To-om <toom@thehive-project.org>
Date: Fri, 5 May 2017 13:29:48 +0200
Subject: [PATCH 15/32] #21 Restructure classes

---
 app/Module.scala                              |  11 +-
 .../{Analyzer.scala => AnalyzerCtrl.scala}    |  17 +-
 app/controllers/Asset.scala                   |   6 +-
 app/controllers/{Job.scala => JobCtrl.scala}  |  30 +--
 app/controllers/MispCtrl.scala                |   2 +
 app/models/Analyzer.scala                     |   6 +-
 app/models/ExternalAnalyzer.scala             |  84 +------
 app/models/Job.scala                          |  20 +-
 app/models/JsonFormat.scala                   |  79 +++++--
 app/models/MispModule.scala                   |  93 +-------
 app/models/Report.scala                       |   9 +
 app/services/Analyzer.scala                   | 107 ---------
 app/services/AnalyzerSrv.scala                |  37 +++
 app/services/ExternalAnalyzerSrv.scala        | 142 ++++++++++++
 app/services/{Job.scala => JobSrv.scala}      |  70 +++---
 app/services/MispSrv.scala                    | 219 ++++++++++++++----
 app/util/JsonConfig.scala                     |  14 +-
 build.sbt                                     |  11 +-
 contrib/misp-modules-loader.py                |   2 +-
 project/Bintray.scala                         |  20 +-
 project/FrontEnd.scala                        |   2 +-
 project/Release.scala                         |   7 +-
 22 files changed, 537 insertions(+), 451 deletions(-)
 rename app/controllers/{Analyzer.scala => AnalyzerCtrl.scala} (89%)
 rename app/controllers/{Job.scala => JobCtrl.scala} (54%)
 create mode 100644 app/models/Report.scala
 delete mode 100644 app/services/Analyzer.scala
 create mode 100644 app/services/AnalyzerSrv.scala
 create mode 100644 app/services/ExternalAnalyzerSrv.scala
 rename app/services/{Job.scala => JobSrv.scala} (73%)

diff --git a/app/Module.scala b/app/Module.scala
index 5a042f5ef..3dacb8fda 100644
--- a/app/Module.scala
+++ b/app/Module.scala
@@ -1,16 +1,13 @@
-import play.api.{ Configuration, Environment, Mode }
-import play.api.libs.concurrent.AkkaGuiceSupport
-
 import com.google.inject.AbstractModule
-
-import net.codingwell.scalaguice.ScalaModule
-
 import controllers.{ AssetCtrl, AssetCtrlDev, AssetCtrlProd }
+import net.codingwell.scalaguice.ScalaModule
+import play.api.libs.concurrent.AkkaGuiceSupport
+import play.api.{ Configuration, Environment, Mode }
 import services.JobActor
 
 class Module(environment: Environment, configuration: Configuration) extends AbstractModule with ScalaModule with AkkaGuiceSupport {
 
-  override def configure() = {
+  override def configure(): Unit = {
     bindActor[JobActor]("JobActor")
 
     if (environment.mode == Mode.Prod)
diff --git a/app/controllers/Analyzer.scala b/app/controllers/AnalyzerCtrl.scala
similarity index 89%
rename from app/controllers/Analyzer.scala
rename to app/controllers/AnalyzerCtrl.scala
index 644571788..8464291bf 100644
--- a/app/controllers/Analyzer.scala
+++ b/app/controllers/AnalyzerCtrl.scala
@@ -2,16 +2,14 @@ package controllers
 
 import javax.inject.Inject
 
-import scala.annotation.implicitNotFound
-import scala.concurrent.{ ExecutionContext, Future }
-
+import models.JsonFormat.{ analyzerWrites, dataActifactReads, jobWrites }
+import models.{ DataArtifact, FileArtifact }
 import play.api.libs.json.{ JsObject, JsString, Json }
 import play.api.mvc.{ Action, AnyContent, Controller, Request }
-
-import models.{ DataArtifact, FileArtifact }
-import models.JsonFormat.{ analyzerWrites, dataActifactReads, jobWrites }
 import services.{ AnalyzerSrv, JobSrv }
 
+import scala.concurrent.{ ExecutionContext, Future }
+
 class AnalyzerCtrl @Inject() (
     analyzerSrv: AnalyzerSrv,
     jobSrv: JobSrv,
@@ -38,7 +36,7 @@ class AnalyzerCtrl @Inject() (
   private[controllers] def readFileArtifact(request: Request[AnyContent]) = {
     for {
       parts ← request.body.asMultipartFormData
-      filePart ← parts.file("data").headOption
+      filePart ← parts.file("data")
       attrList ← parts.dataParts.get("_json")
       attrStr ← attrList.headOption
       attr ← Json.parse(attrStr).asOpt[JsObject]
@@ -47,11 +45,12 @@ class AnalyzerCtrl @Inject() (
       ("filename" → JsString(filePart.filename)))
   }
 
-  def analyze(analyzerId: String) = Action.async { request ⇒
+  def analyze(analyzerId: String): Action[AnyContent] = Action.async { request ⇒
     readDataArtifact(request)
       .orElse(readFileArtifact(request))
       .map { artifact ⇒
-        jobSrv.create(artifact, analyzerId)
+        analyzerSrv.analyze(analyzerId, artifact)
+          //jobSrv.create(artifact, analyzerId)
           .map(j ⇒ Ok(Json.toJson(j)))
       }
       .getOrElse(Future.successful(BadRequest("???")))
diff --git a/app/controllers/Asset.scala b/app/controllers/Asset.scala
index 102cd11ab..6a37553ec 100644
--- a/app/controllers/Asset.scala
+++ b/app/controllers/Asset.scala
@@ -4,7 +4,7 @@ import javax.inject.{ Inject, Singleton }
 
 import play.api.Environment
 import play.api.http.HttpErrorHandler
-import play.api.mvc.{ Action, AnyContent, Controller }
+import play.api.mvc.{ Action, AnyContent }
 
 trait AssetCtrl {
   def get(file: String): Action[AnyContent]
@@ -12,12 +12,12 @@ trait AssetCtrl {
 
 @Singleton
 class AssetCtrlProd @Inject() (errorHandler: HttpErrorHandler) extends Assets(errorHandler) with AssetCtrl {
-  def get(file: String) = at("/ui", file)
+  def get(file: String): Action[AnyContent] = at("/ui", file)
 }
 
 @Singleton
 class AssetCtrlDev @Inject() (environment: Environment) extends ExternalAssets(environment) with AssetCtrl {
-  def get(file: String) = {
+  def get(file: String): Action[AnyContent] = {
     if (file.startsWith("bower_components/")) {
       at("ui", file)
     }
diff --git a/app/controllers/Job.scala b/app/controllers/JobCtrl.scala
similarity index 54%
rename from app/controllers/Job.scala
rename to app/controllers/JobCtrl.scala
index 2a96ca0a1..af20f5395 100644
--- a/app/controllers/Job.scala
+++ b/app/controllers/JobCtrl.scala
@@ -6,40 +6,38 @@ import scala.annotation.implicitNotFound
 import scala.concurrent.ExecutionContext
 import scala.concurrent.duration.Duration
 import scala.util.{ Failure, Success }
-
 import play.api.libs.json.{ JsString, Json }
-import play.api.mvc.{ Action, Controller }
-
-import models.JsonFormat.{ jobStatusWrites, jobWrites }
+import play.api.mvc.{ Action, AnyContent, Controller }
+import models.JsonFormat._
 import services.JobSrv
 
 class JobCtrl @Inject() (
     jobSrv: JobSrv,
     implicit val ec: ExecutionContext) extends Controller {
-  def list(dataTypeFilter: Option[String], dataFilter: Option[String], analyzerFilter: Option[String], start: Int, limit: Int) = Action.async { request ⇒
+  def list(dataTypeFilter: Option[String], dataFilter: Option[String], analyzerFilter: Option[String], start: Int, limit: Int): Action[AnyContent] = Action.async { request ⇒
     jobSrv.list(dataTypeFilter, dataFilter, analyzerFilter, start, limit).map {
       case (total, jobs) ⇒ Ok(Json.toJson(jobs)).withHeaders("X-Total" → total.toString)
     }
   }
 
-  def get(jobId: String) = Action.async { request ⇒
+  def get(jobId: String): Action[AnyContent] = Action.async { request ⇒
     jobSrv.get(jobId).map { job ⇒
       Ok(Json.toJson(job))
     }
   }
 
-  def remove(jobId: String) = Action.async { request ⇒
+  def remove(jobId: String): Action[AnyContent] = Action.async { request ⇒
     jobSrv.remove(jobId).map(_ ⇒ Ok(""))
   }
 
-  def report(jobId: String) = Action.async { request ⇒
+  def report(jobId: String): Action[AnyContent] = Action.async { request ⇒
     jobSrv
       .get(jobId)
       .map { job ⇒
         val report = job.report.value match {
-          case Some(Success(report)) ⇒ report
-          case Some(Failure(error))  ⇒ JsString(error.getMessage)
-          case None                  ⇒ JsString("Running")
+          case Some(Success(r))     ⇒ Json.toJson(r)
+          case Some(Failure(error)) ⇒ JsString(error.getMessage)
+          case None                 ⇒ JsString("Running")
         }
         Ok(jobWrites.writes(job) +
           ("status" → jobStatusWrites.writes(job.status)) +
@@ -47,12 +45,8 @@ class JobCtrl @Inject() (
       }
   }
 
-  def waitReport(jobId: String, atMost: String) = Action.async { request ⇒
-    for {
-      job ← jobSrv.get(jobId)
-      (status, report) ← jobSrv.waitReport(jobId, Duration(atMost))
-    } yield Ok(jobWrites.writes(job) +
-      ("status" → jobStatusWrites.writes(job.status)) +
-      ("report" → report))
+  def waitReport(jobId: String, atMost: String): Action[AnyContent] = Action.async { request ⇒
+    jobSrv.waitReport(jobId, Duration(atMost))
+      .map { job ⇒ Ok(Json.toJson(job)) }
   }
 }
\ No newline at end of file
diff --git a/app/controllers/MispCtrl.scala b/app/controllers/MispCtrl.scala
index 312708b65..8792921e5 100644
--- a/app/controllers/MispCtrl.scala
+++ b/app/controllers/MispCtrl.scala
@@ -2,6 +2,7 @@ package controllers
 
 import javax.inject.Inject
 
+import play.api.Logger
 import play.api.libs.json.{ JsObject, JsValue }
 import play.api.mvc.{ Action, AnyContent, Controller }
 import services.MispSrv
@@ -10,6 +11,7 @@ import scala.concurrent.ExecutionContext
 
 class MispCtrl @Inject() (mispSrv: MispSrv, implicit val ec: ExecutionContext) extends Controller {
 
+  private[MispCtrl] lazy val logger = Logger(getClass)
   def modules: Action[AnyContent] = Action { _ ⇒
     Ok(mispSrv.moduleList)
   }
diff --git a/app/models/Analyzer.scala b/app/models/Analyzer.scala
index ce853ac97..d13381f3b 100644
--- a/app/models/Analyzer.scala
+++ b/app/models/Analyzer.scala
@@ -1,10 +1,6 @@
 package models
 
-import scala.concurrent.Future
-import play.api.libs.json.JsObject
-
 abstract class Analyzer {
-  def analyze(artifact: Artifact): Future[JsObject]
   val name: String
   val version: String
   val description: String
@@ -12,5 +8,5 @@ abstract class Analyzer {
   val author: String
   val url: String
   val license: String
-  val id = (name + "_" + version).replaceAll("\\.", "_")
+  val id: String = (name + "_" + version).replaceAll("\\.", "_")
 }
diff --git a/app/models/ExternalAnalyzer.scala b/app/models/ExternalAnalyzer.scala
index 2ce882b5a..97e2556d5 100644
--- a/app/models/ExternalAnalyzer.scala
+++ b/app/models/ExternalAnalyzer.scala
@@ -1,80 +1,16 @@
 package models
 
-import java.io.{ BufferedReader, InputStreamReader }
 import java.nio.file.Path
 
-import scala.concurrent.{ ExecutionContext, Future, blocking }
-import scala.sys.process.{ BasicIO, Process, ProcessIO }
-
-import akka.stream.Materializer
-
-import play.api.Logger
-import play.api.libs.json.{ JsObject, JsString, Json }
-
-import com.fasterxml.jackson.core.JsonParseException
-import com.fasterxml.jackson.databind.JsonMappingException
+import play.api.libs.json.JsObject
 
 case class ExternalAnalyzer(
-    name: String,
-    version: String,
-    description: String,
-    dataTypeList: Seq[String],
-    author: String,
-    url: String,
-    license: String,
-    command: Path,
-    config: JsObject)(implicit val ec: ExecutionContext) extends Analyzer {
-
-  val log = Logger(getClass)
-  private val osexec = if (System.getProperty("os.name").toLowerCase.contains("win"))
-    (c: String) ⇒ s"""cmd /c $c"""
-  else
-    (c: String) ⇒ s"""sh -c "./$c" """
-
-  override def analyze(artifact: Artifact): Future[JsObject] = {
-    Future {
-      val input = artifact match {
-        case FileArtifact(file, attributes) ⇒ attributes + ("file" → JsString(file.getAbsoluteFile.toString)) + ("config" → config)
-        case DataArtifact(data, attributes) ⇒ attributes + ("data" → JsString(data)) + ("config" → config)
-      }
-      val output = new StringBuffer
-      val error = new StringBuffer
-      try {
-        log.info(s"Execute ${osexec(command.getFileName.toString)} in ${command.getParent.toFile.getAbsoluteFile.getName}")
-        val exitValue = Process(osexec(command.getFileName.toString), command.getParent.toFile).run(
-          new ProcessIO(
-            { stdin ⇒
-              try stdin.write(input.toString.getBytes("UTF-8"))
-              finally stdin.close()
-            },
-            { stdout ⇒
-              val reader = new BufferedReader(new InputStreamReader(stdout, "UTF-8"))
-              try BasicIO.processLinesFully { line ⇒
-                output.append(line).append(System.lineSeparator())
-                ()
-              }(reader.readLine)
-              finally reader.close()
-            },
-            { stderr ⇒
-              val reader = new BufferedReader(new InputStreamReader(stderr, "UTF-8"))
-              try BasicIO.processLinesFully { line ⇒
-                error.append(line).append(System.lineSeparator())
-                ()
-              }(reader.readLine)
-              finally reader.close()
-            })).exitValue
-        Json.parse(output.toString).as[JsObject]
-      }
-      catch {
-        case _: JsonMappingException ⇒
-          error.append(output)
-          JsObject(Seq("errorMessage" → JsString(s"Error: Invalid output\n$error")))
-        case _: JsonParseException ⇒
-          error.append(output)
-          JsObject(Seq("errorMessage" → JsString(s"Error: Invalid output\n$error")))
-        case t: Throwable ⇒
-          JsObject(Seq("errorMessage" → JsString(t.getMessage + ":" + t.getStackTrace().mkString("", "\n\t", "\n"))))
-      }
-    }
-  }
-}
+  name: String,
+  version: String,
+  description: String,
+  dataTypeList: Seq[String],
+  author: String,
+  url: String,
+  license: String,
+  command: Path,
+  config: JsObject) extends Analyzer
\ No newline at end of file
diff --git a/app/models/Job.scala b/app/models/Job.scala
index 8d4460f64..bdc90644d 100644
--- a/app/models/Job.scala
+++ b/app/models/Job.scala
@@ -1,24 +1,22 @@
 package models
 
-import play.api.libs.json.JsObject
-import scala.concurrent.Future
 import java.util.Date
-import scala.util.Success
-import scala.util.Failure
+
+import scala.concurrent.Future
+import scala.util.{ Failure, Success }
 
 object JobStatus extends Enumeration {
   type Type = Value
   val InProgress, Success, Failure = Value
 }
-case class Job(id: String, analyzerId: String, artifact: Artifact, report: Future[JsObject]) {
+
+case class Job(id: String, analyzer: Analyzer, artifact: Artifact, report: Future[Report]) {
   val date: Date = new Date()
 
   def status: JobStatus.Type = report.value match {
-    case Some(Success(x)) ⇒ (x \ "success").asOpt[Boolean] match {
-      case Some(true) ⇒ JobStatus.Success
-      case _          ⇒ JobStatus.Failure
-    }
-    case Some(Failure(_)) ⇒ JobStatus.Failure
-    case None             ⇒ JobStatus.InProgress
+    case Some(Success(SuccessReport(_, _, _))) ⇒ JobStatus.Success
+    case Some(Success(FailureReport(_)))       ⇒ JobStatus.Failure
+    case Some(Failure(_))                      ⇒ JobStatus.Failure
+    case None                                  ⇒ JobStatus.InProgress
   }
 }
diff --git a/app/models/JsonFormat.scala b/app/models/JsonFormat.scala
index b2536890c..9a81cd685 100644
--- a/app/models/JsonFormat.scala
+++ b/app/models/JsonFormat.scala
@@ -1,19 +1,11 @@
 package models
 
-import scala.annotation.implicitNotFound
-
-import play.api.libs.json.Json
+import models.JobStatus.Type
 import play.api.libs.json.Json.toJsFieldJsValueWrapper
-import play.api.libs.json.Writes
-import scala.concurrent.Future
-import play.api.libs.json.JsObject
-import scala.util.Success
-import scala.util.Failure
-import play.api.libs.json.JsString
-import play.api.libs.json.OWrites
+import play.api.libs.json.{ JsString, Json, OWrites, Writes, _ }
 
 object JsonFormat {
-  implicit val analyzerWrites = Writes[Analyzer](analyzer ⇒ Json.obj(
+  implicit val analyzerWrites: Writes[Analyzer] = Writes[Analyzer](analyzer ⇒ Json.obj(
     "name" → analyzer.name,
     "version" → analyzer.version,
     "description" → analyzer.description,
@@ -23,24 +15,65 @@ object JsonFormat {
     "license" → analyzer.license,
     "id" → analyzer.id))
 
-  implicit val fileArtifactWrites = OWrites[FileArtifact](fileArtifact ⇒ Json.obj(
+  implicit val fileArtifactWrites: OWrites[FileArtifact] = OWrites[FileArtifact](fileArtifact ⇒ Json.obj(
     "attributes" → fileArtifact.attributes))
 
-  implicit val dataArtifactWrites = Json.writes[DataArtifact]
-  implicit val dataActifactReads = Json.reads[DataArtifact]
+  implicit val dataArtifactWrites: OWrites[DataArtifact] = Json.writes[DataArtifact]
+  implicit val dataActifactReads: Reads[DataArtifact] = Json.reads[DataArtifact]
 
-  implicit val artifactWrites = OWrites[Artifact](artifact ⇒ artifact match {
+  val artifactWrites: OWrites[Artifact] = OWrites[Artifact] {
     case dataArtifact: DataArtifact ⇒ dataArtifactWrites.writes(dataArtifact)
     case fileArtifact: FileArtifact ⇒ fileArtifactWrites.writes(fileArtifact)
-  })
+  }
+
+  val artifactReads: Reads[Artifact] = Reads[Artifact] { json ⇒
+    (json \ "data").asOpt[String]
+      .map { data ⇒ JsSuccess(DataArtifact(data, json.as[JsObject])) }
+      .getOrElse(JsError(__ \ "data", "data is missing"))
+  }
+  implicit val artifactFormat = Format(artifactReads, artifactWrites)
+
+  implicit val jobStatusWrites: Writes[Type] = Writes[JobStatus.Type](jobStatus ⇒ JsString(jobStatus.toString))
+
+  val reportArtifactReads: Reads[Artifact] =
+    for {
+      tpe ← (__ \ "type").read[String]
+      value ← (__ \ "value").read[String]
+    } yield DataArtifact(value, Json.obj("dataType" → tpe))
+
+  val reportReads: Reads[Report] = Reads[Report] { json ⇒
+    val success = (json \ "success").asOpt[Boolean].getOrElse(false)
+    JsSuccess {
+      if (success)
+        (for {
+          artifacts ← (json \ "artifacts").asOpt[Seq[Artifact]](Reads.seq(reportArtifactReads))
+          full ← (json \ "full").asOpt[JsObject]
+          summary ← (json \ "summary").asOpt[JsObject]
+        } yield SuccessReport(artifacts, full, summary))
+          .getOrElse(FailureReport(s"Invalid analyzer output format : $json"))
+      else
+        FailureReport((json \ "error").asOpt[String].getOrElse(json.toString))
+    }
+  }
 
-  implicit val jobStatusWrites = Writes[JobStatus.Type](jobStatus ⇒ JsString(jobStatus.toString))
+  val reportWrites: Writes[Report] = Writes[Report] {
+    case SuccessReport(artifacts, full, summary) ⇒ Json.obj(
+      "artifacts" → artifacts,
+      "full" → full,
+      "summary" → summary)
+    case FailureReport(message) ⇒ Json.obj("errorMessage" → message)
+  }
 
-  implicit val jobWrites = OWrites[Job](job ⇒ Json.obj(
-    "id" → job.id,
-    "analyzerId" → job.analyzerId,
-    "status" → job.status,
-    "date" → job.date,
-    "artifact" → job.artifact))
+  implicit val reportFormat: Format[Report] = Format[Report](reportReads, reportWrites)
 
+  implicit val jobWrites: OWrites[Job] = OWrites[Job] { job ⇒
+    val report = job.report.value.flatMap(_.toOption).map(Json.toJson(_)).getOrElse(JsNull)
+    Json.obj(
+      "id" → job.id,
+      "analyzerId" → job.analyzer.id,
+      "status" → job.status,
+      "date" → job.date,
+      "artifact" → job.artifact,
+      "report" → report)
+  }
 }
diff --git a/app/models/MispModule.scala b/app/models/MispModule.scala
index a715abdfd..14ef92350 100644
--- a/app/models/MispModule.scala
+++ b/app/models/MispModule.scala
@@ -1,97 +1,14 @@
 package models
 
-import java.io._
-
-import org.apache.commons.codec.binary.Base64InputStream
-import play.api.Logger
-import play.api.libs.json.{ JsObject, Json }
-import services.MispSrv
-
-import scala.collection.JavaConverters._
-import scala.concurrent.{ ExecutionContext, Future }
-import scala.sys.process._
-import scala.util.{ Failure, Success, Try }
-
 case class MispModule(
-    mispSrv: MispSrv,
-    name: String,
+  name: String,
     version: String,
     description: String,
-    dataTypeList: Seq[String],
     author: String,
-    moduleName: String,
-    loaderCommand: String)(implicit val ec: ExecutionContext) extends Analyzer {
-
+    dataTypeList: Seq[String],
+    inputAttributes: Seq[String],
+    config: Seq[String],
+    loaderCommand: String) extends Analyzer {
   val license = "AGPL-3.0"
   val url = "https://github.com/MISP/misp-modules"
-
-  private def stringStream(string: String): InputStream = {
-    new ByteArrayInputStream(string.getBytes)
-  }
-  def analyze(artifact: Artifact): Future[JsObject] = {
-    val input = artifact match {
-      case DataArtifact(data, _) ⇒
-        stringStream(Json.obj(mispSrv.dataType2mispType(artifact.dataType).head → data).toString)
-      case FileArtifact(data, _) ⇒
-        new SequenceInputStream(Iterator(
-          stringStream("""{"attachment":""""),
-          new Base64InputStream(new FileInputStream(data), true),
-          stringStream("\"}")).asJavaEnumeration)
-    }
-    val output = (s"$loaderCommand --run $moduleName" #< input).!!
-    Future {
-      Json.parse(output).as[JsObject]
-    }
-  }
-}
-
-object MispModule {
-  private[MispModule] lazy val logger = Logger(getClass)
-  def list(loaderCommand: String): Seq[String] =
-    Json.parse(s"$loaderCommand --list".!!).as[Seq[String]]
-
-  def apply(
-    loaderCommand: String,
-    moduleName: String,
-    mispSrv: MispSrv)(implicit ec: ExecutionContext): Option[MispModule] = {
-    println(s"Loading MISP module $moduleName")
-    for {
-      moduleInfo ← Try(Json.parse(s"$loaderCommand --info $moduleName".!!)) match {
-        case Success(s) ⇒ Some(s)
-        case Failure(f) ⇒
-          f.printStackTrace()
-          None
-      }
-      name ← (moduleInfo \ "name").asOpt[String].orElse {
-        println("name not defined")
-        None
-      }
-      version ← (moduleInfo \ "moduleinfo" \ "version").asOpt[String].orElse {
-        println("version not defined")
-        None
-      }
-      description ← (moduleInfo \ "moduleinfo" \ "description").asOpt[String].orElse {
-        println("description not defined")
-        None
-      }
-      dataTypeList ← (moduleInfo \ "mispattributes" \ "input")
-        .asOpt[Seq[String]]
-        .map(_.map(mispSrv.mispType2dataType(_)).distinct)
-        .orElse {
-          println("input attributes not defined")
-          None
-        }
-      author ← (moduleInfo \ "moduleinfo" \ "author").asOpt[String].orElse {
-        println("author not defined")
-        None
-      }
-      mispModule ← Try(MispModule(mispSrv, name, version, description, dataTypeList, author, moduleName, loaderCommand)) match {
-        case Success(s) ⇒ Some(s)
-        case Failure(f) ⇒
-          f.printStackTrace()
-          sys.error("Load module fails")
-      }
-      _ = println("Module load succeed")
-    } yield mispModule
-  }
 }
\ No newline at end of file
diff --git a/app/models/Report.scala b/app/models/Report.scala
new file mode 100644
index 000000000..296466413
--- /dev/null
+++ b/app/models/Report.scala
@@ -0,0 +1,9 @@
+package models
+
+import play.api.libs.json.JsObject
+
+sealed abstract class Report(success: Boolean)
+
+case class SuccessReport(artifacts: Seq[Artifact], full: JsObject, summary: JsObject) extends Report(true)
+
+case class FailureReport(message: String) extends Report(false)
\ No newline at end of file
diff --git a/app/services/Analyzer.scala b/app/services/Analyzer.scala
deleted file mode 100644
index b69c56cd6..000000000
--- a/app/services/Analyzer.scala
+++ /dev/null
@@ -1,107 +0,0 @@
-package services
-
-import java.io.File
-import java.nio.file.{ Files, Path, Paths }
-import javax.inject.{ Inject, Provider, Singleton }
-
-import akka.actor.ActorSystem
-import models.{ Analyzer, ExternalAnalyzer, MispModule }
-import play.api.libs.json.{ JsObject, JsValue, Json }
-import play.api.{ Configuration, Logger }
-import util.JsonConfig.configWrites
-
-import scala.collection.JavaConversions.iterableAsScalaIterable
-import scala.concurrent.ExecutionContext
-import scala.util.Try
-
-@Singleton
-class AnalyzerSrv(
-    mispSrvProvider: Provider[MispSrv],
-    analyzerPath: Path,
-    analyzerConfig: JsObject,
-    mispModulesPath: Path,
-    mispModuleLoaderCommand: Option[String],
-    akkaSystem: ActorSystem) {
-  @Inject def this(
-    mispSrvProvider: Provider[MispSrv],
-    configuration: Configuration,
-    akkaSystem: ActorSystem) =
-    this(
-      mispSrvProvider,
-      Paths.get(configuration.getString("analyzer.path").getOrElse(".")),
-      configWrites.writes(configuration.getConfig("analyzer.config").getOrElse(Configuration.empty)),
-      Paths.get(configuration.getString("misp.modules.path").getOrElse(".")),
-      configuration.getString("misp.modules.loader"),
-      akkaSystem)
-
-  private[AnalyzerSrv] lazy val logger = Logger(getClass)
-  lazy val analyzeExecutionContext: ExecutionContext = akkaSystem.dispatchers.lookup("analyzer")
-  lazy val mispSrv = mispSrvProvider.get
-
-  private lazy val externalAnalyzers: Seq[Analyzer] = getExternalAnalyzers
-  private lazy val mispModules: Seq[Analyzer] = getMispModules
-  def list: Seq[Analyzer] = externalAnalyzers ++ mispModules // ::: javaAnalyzers
-  def get(analyzerId: String): Option[Analyzer] = list.find(_.id == analyzerId)
-  def listForType(dataType: String): Seq[Analyzer] = list.filter(_.dataTypeList.contains(dataType))
-
-  private[services] def getExternalAnalyzers: Seq[Analyzer] = {
-    val globalConfig = (analyzerConfig \ "global").asOpt[JsObject].getOrElse(JsObject(Nil))
-    for {
-      analyzerDir ← Try(Files.newDirectoryStream(analyzerPath).toSeq).getOrElse {
-        logger.warn(s"Analyzer directory ($analyzerPath) is not found")
-        Nil
-      }
-      if Files.isDirectory(analyzerDir)
-      infoFile ← Files.newDirectoryStream(analyzerDir, "*.json").toSeq
-      if Files.isReadable(infoFile)
-      info = readInfo(infoFile)
-      name ← (info \ "name").asOpt[String] orElse {
-        logger.warn(s"name is missing in $infoFile"); None
-      }
-      version ← (info \ "version").asOpt[String] orElse {
-        logger.warn(s"version is missing in $infoFile"); None
-      }
-      description ← (info \ "description").asOpt[String] orElse {
-        logger.warn(s"description is missing in $infoFile"); None
-      }
-      dataTypeList ← (info \ "dataTypeList").asOpt[Seq[String]] orElse {
-        logger.warn(s"dataTypeList is missing in $infoFile"); None
-      }
-      command ← (info \ "command").asOpt[String] orElse {
-        logger.warn(s"command is missing in $infoFile"); None
-      }
-      author ← (info \ "author").asOpt[String] orElse {
-        logger.warn(s"author is missing in $infoFile"); None
-      }
-      url ← (info \ "url").asOpt[String] orElse {
-        logger.warn(s"url is missing in $infoFile"); None
-      }
-      license ← (info \ "license").asOpt[String] orElse {
-        logger.warn(s"license is missing in $infoFile"); None
-      }
-      config = (info \ "config").asOpt[JsObject].getOrElse(JsObject(Nil))
-      baseConfig = (info \ "baseConfig").asOpt[String].flatMap(c ⇒ (analyzerConfig \ c).asOpt[JsObject]).getOrElse(JsObject(Nil))
-      absoluteCommand = analyzerPath.resolve(Paths.get(command.replaceAll("[\\/]", File.separator)))
-      _ = logger.info(s"Register analyzer $name $version (${(name + "_" + version).replaceAll("\\.", "_")})")
-    } yield ExternalAnalyzer(name, version, description, dataTypeList, author, url, license, absoluteCommand, globalConfig deepMerge baseConfig deepMerge config)(analyzeExecutionContext)
-  }
-
-  private[services] def getMispModules: Seq[Analyzer] = {
-    for {
-      loaderCommand ← mispModuleLoaderCommand.toSeq
-      moduleName ← MispModule.list(loaderCommand)
-
-      _ = println("MISP module loading ...")
-      mispModule ← MispModule(loaderCommand, moduleName, mispSrv)(analyzeExecutionContext)
-      _ = println("MISP module load success")
-    } yield mispModule
-  }
-
-  private[services] def readInfo(file: Path): JsValue = {
-    val source = scala.io.Source.fromFile(file.toFile)
-    try {
-      Json.parse(source.mkString)
-    }
-    finally { source.close() }
-  }
-}
diff --git a/app/services/AnalyzerSrv.scala b/app/services/AnalyzerSrv.scala
new file mode 100644
index 000000000..4637cf98b
--- /dev/null
+++ b/app/services/AnalyzerSrv.scala
@@ -0,0 +1,37 @@
+package services
+
+import javax.inject.{ Inject, Singleton }
+
+import models._
+import play.api.Logger
+
+import scala.concurrent.Future
+
+@Singleton
+class AnalyzerSrv @Inject() (
+    jobSrv: JobSrv,
+    mispSrv: MispSrv,
+    externalAnalyzerSrv: ExternalAnalyzerSrv) {
+
+  private[AnalyzerSrv] lazy val logger = Logger(getClass)
+
+  def list: Seq[Analyzer] = externalAnalyzerSrv.list ++ mispSrv.list
+
+  def get(analyzerId: String): Option[Analyzer] = list.find(_.id == analyzerId)
+
+  def listForType(dataType: String): Seq[Analyzer] = list.filter(_.dataTypeList.contains(dataType))
+
+  def analyze(analyzerId: String, artifact: Artifact): Future[Job] = {
+    get(analyzerId)
+      .map { analyzer ⇒ analyze(analyzer, artifact) }
+      .getOrElse(sys.error("analyzer not found"))
+  }
+
+  def analyze(analyzer: Analyzer, artifact: Artifact): Future[Job] = {
+    val report = analyzer match {
+      case ea: ExternalAnalyzer ⇒ externalAnalyzerSrv.analyze(ea, artifact)
+      case mm: MispModule       ⇒ mispSrv.analyze(mm, artifact)
+    }
+    jobSrv.create(analyzer, artifact, report)
+  }
+}
diff --git a/app/services/ExternalAnalyzerSrv.scala b/app/services/ExternalAnalyzerSrv.scala
new file mode 100644
index 000000000..ae1927e69
--- /dev/null
+++ b/app/services/ExternalAnalyzerSrv.scala
@@ -0,0 +1,142 @@
+package services
+
+import java.io.{ BufferedReader, File, InputStreamReader }
+import java.nio.file.{ Files, Path, Paths }
+import javax.inject.{ Inject, Singleton }
+
+import akka.actor.ActorSystem
+import com.fasterxml.jackson.core.JsonParseException
+import com.fasterxml.jackson.databind.JsonMappingException
+import models.JsonFormat._
+import models._
+import util.JsonConfig
+import play.api.libs.json._
+import play.api.{ Configuration, Logger }
+
+import scala.collection.JavaConversions.iterableAsScalaIterable
+import scala.concurrent.{ ExecutionContext, Future }
+import scala.sys.process.{ BasicIO, Process, ProcessIO }
+import scala.util.{ Failure, Try }
+
+@Singleton
+class ExternalAnalyzerSrv(
+    analyzerPath: Path,
+    analyzerConfig: JsObject,
+    akkaSystem: ActorSystem) {
+
+  @Inject() def this(configuration: Configuration, akkaSystem: ActorSystem) =
+    this(
+      Paths.get(configuration.getString("analyzer.path").getOrElse(".")),
+      JsonConfig.configWrites.writes(configuration.getConfig("analyzer.config").getOrElse(Configuration.empty)),
+      akkaSystem)
+
+  private[ExternalAnalyzerSrv] lazy val analyzeExecutionContext: ExecutionContext =
+    akkaSystem.dispatchers.lookup("analyzer")
+  private[ExternalAnalyzerSrv] lazy val globalConfig: JsObject =
+    (analyzerConfig \ "global").asOpt[JsObject].getOrElse(JsObject(Nil))
+  private[ExternalAnalyzerSrv] lazy val logger =
+    Logger(getClass)
+
+  lazy val list: Seq[ExternalAnalyzer] = {
+    for {
+      analyzerDir ← Try(Files.newDirectoryStream(analyzerPath).toSeq).getOrElse {
+        logger.warn(s"Analyzer directory ($analyzerPath) is not found")
+        Nil
+      }
+      if Files.isDirectory(analyzerDir)
+      infoFile ← Files.newDirectoryStream(analyzerDir, "*.json").toSeq
+      if Files.isReadable(infoFile)
+      analyzer ← Try(readInfo(infoFile).as[ExternalAnalyzer](reads))
+        .recoverWith {
+          case error ⇒
+            logger.warn(s"Load of analyzer $infoFile fails", error)
+            Failure(error)
+        }
+        .toOption
+      _ = logger.info(s"Register analyzer ${analyzer.name} ${analyzer.version} (${analyzer.id})")
+    } yield analyzer
+  }
+
+  def get(analyzerId: String): Option[ExternalAnalyzer] = list.find(_.id == analyzerId)
+
+  private val osexec =
+    if (System.getProperty("os.name").toLowerCase.contains("win"))
+      (c: String) ⇒ s"""cmd /c $c"""
+    else
+      (c: String) ⇒ s"""sh -c "./$c" """
+
+  def analyze(analyzer: ExternalAnalyzer, artifact: Artifact): Future[Report] = {
+    Future {
+      val input = artifact match {
+        case FileArtifact(file, attributes) ⇒ attributes + ("file" → JsString(file.getAbsoluteFile.toString)) + ("config" → analyzer.config)
+        case DataArtifact(data, attributes) ⇒ attributes + ("data" → JsString(data)) + ("config" → analyzer.config)
+      }
+      val output = new StringBuffer
+      val error = new StringBuffer
+      try {
+        logger.info(s"Execute ${osexec(analyzer.command.getFileName.toString)} in ${analyzer.command.getParent.toFile.getAbsoluteFile.getName}")
+        Process(osexec(analyzer.command.getFileName.toString), analyzer.command.getParent.toFile).run(
+          new ProcessIO(
+            { stdin ⇒
+              try stdin.write(input.toString.getBytes("UTF-8"))
+              finally stdin.close()
+            }, { stdout ⇒
+              val reader = new BufferedReader(new InputStreamReader(stdout, "UTF-8"))
+              try BasicIO.processLinesFully { line ⇒
+                output.append(line).append(System.lineSeparator())
+                ()
+              }(reader.readLine)
+              finally reader.close()
+            }, { stderr ⇒
+              val reader = new BufferedReader(new InputStreamReader(stderr, "UTF-8"))
+              try BasicIO.processLinesFully { line ⇒
+                error.append(line).append(System.lineSeparator())
+                ()
+              }(reader.readLine)
+              finally reader.close()
+            })).exitValue
+        Json.parse(output.toString).as[Report]
+      }
+      catch {
+        case _: JsonMappingException ⇒
+          error.append(output)
+          FailureReport(s"Error: Invalid output\n$error")
+        case _: JsonParseException ⇒
+          error.append(output)
+          FailureReport(s"Error: Invalid output\n$error")
+        case t: Throwable ⇒
+          FailureReport(t.getMessage + ":" + t.getStackTrace.mkString("", "\n\t", "\n"))
+      }
+    }(analyzeExecutionContext)
+  }
+
+  private[ExternalAnalyzerSrv] def readInfo(file: Path): JsValue = {
+    val source = scala.io.Source.fromFile(file.toFile)
+    try Json.parse(source.mkString)
+    finally source.close()
+  }
+
+  private[ExternalAnalyzerSrv] val reads: Reads[ExternalAnalyzer] =
+    for {
+      name ← (__ \ "name").read[String]
+      version ← (__ \ "version").read[String]
+      description ← (__ \ "description").read[String]
+      dataTypeList ← (__ \ "dataTypeList").read[Seq[String]]
+      author ← (__ \ "author").read[String]
+      url ← (__ \ "url").read[String]
+      license ← (__ \ "license").read[String]
+      command ← (__ \ "command").read[String]
+      absoluteCommand = analyzerPath.resolve(Paths.get(command.replaceAll("[\\/]", File.separator)))
+      config ← (__ \ "config").read[JsObject]
+      baseConfigKey ← (__ \ "baseConfig").read[String]
+      baseConfig = (analyzerConfig \ baseConfigKey).asOpt[JsObject].getOrElse(JsObject(Nil))
+    } yield ExternalAnalyzer(
+      name,
+      version,
+      description,
+      dataTypeList,
+      author,
+      url,
+      license,
+      absoluteCommand, globalConfig deepMerge baseConfig deepMerge config)
+}
\ No newline at end of file
diff --git a/app/services/Job.scala b/app/services/JobSrv.scala
similarity index 73%
rename from app/services/Job.scala
rename to app/services/JobSrv.scala
index c66a7b455..787ca7d6f 100644
--- a/app/services/Job.scala
+++ b/app/services/JobSrv.scala
@@ -6,8 +6,7 @@ import javax.inject.{ Inject, Named }
 import akka.actor.{ Actor, ActorRef, ActorSystem, actorRef2Scala }
 import akka.pattern.ask
 import akka.util.Timeout
-import models.{ Analyzer, Artifact, Job, JobStatus }
-import play.api.libs.json.{ JsString, JsValue }
+import models._
 import play.api.{ Configuration, Logger }
 
 import scala.concurrent.duration.Duration.Infinite
@@ -16,11 +15,13 @@ import scala.concurrent.{ ExecutionContext, Future, Promise }
 import scala.util.Random
 
 class JobSrv @Inject() (
-    analyzerSrv: AnalyzerSrv,
+    //analyzerSrv: AnalyzerSrv,
     @Named("JobActor") jobActor: ActorRef,
     implicit val ec: ExecutionContext,
     implicit val system: ActorSystem) {
+
   import services.JobActor._
+
   implicit val timeout = Timeout(5.seconds)
 
   def list(dataTypeFilter: Option[String], dataFilter: Option[String], analyzerFilter: Option[String], start: Int, limit: Int): Future[(Int, Seq[Job])] = {
@@ -36,17 +37,26 @@ class JobSrv @Inject() (
     case _           ⇒ sys.error("TODO")
   }
 
-  def create(artifact: Artifact, analyzerId: String): Future[Job] = {
-    analyzerSrv.get(analyzerId)
-      .map { analyzer ⇒ create(artifact, analyzer) }
-      .getOrElse(Future.failed(new Exception("analyzer not found")))
+  def create(analyzer: Analyzer, artifact: Artifact, report: Future[Report]): Future[Job] = {
+    (jobActor ? CreateJob(artifact, analyzer, report)) map {
+      case job: Job ⇒ job
+      case _        ⇒ sys.error("TODO")
+    }
   }
 
-  def create(artifact: Artifact, analyzer: Analyzer): Future[Job] =
-    (jobActor ? CreateJob(artifact, analyzer)) map {
-      case j: Job ⇒ j
-      case _      ⇒ sys.error("TODO")
-    }
+  //  @deprecated
+  //  def create(artifact: Artifact, analyzerId: String): Future[Job] = {
+  //    analyzerSrv.get(analyzerId)
+  //      .map { analyzer ⇒ create(artifact, analyzer) }
+  //      .getOrElse(Future.failed(new Exception("analyzer not found")))
+  //  }
+  //
+  //  @deprecated
+  //  def create(artifact: Artifact, analyzer: Analyzer): Future[Job] =
+  //    (jobActor ? CreateJob(artifact, analyzer)) map {
+  //      case j: Job ⇒ j
+  //      case _      ⇒ sys.error("TODO")
+  //    }
 
   def remove(jobId: String): Future[Unit] = {
     (jobActor ? RemoveJob(jobId)).map {
@@ -56,19 +66,20 @@ class JobSrv @Inject() (
     }
   }
 
-  def waitReport(jobId: String, atMost: Duration): Future[(JobStatus.Type, JsValue)] = {
-    val statusResult = get(jobId)
-      .flatMap(_.report)
-      .map((JobStatus.Success, _))
-      .recover { case error ⇒ (JobStatus.Failure, JsString(error.getMessage)) }
-
-    atMost match {
-      case _: Infinite ⇒ statusResult
-      case duration: FiniteDuration ⇒
-        val prom = Promise[(JobStatus.Type, JsValue)]()
-        val timeout = system.scheduler.scheduleOnce(duration) { prom.success((JobStatus.InProgress, JsString("Timeout"))); () }
-        statusResult.onComplete(_ ⇒ timeout.cancel())
-        Future.firstCompletedOf(List(statusResult, prom.future))
+  def waitReport(jobId: String, atMost: Duration): Future[Job] = {
+    get(jobId).flatMap { job ⇒
+      val finishedJob = job.report.map(_ ⇒ job)
+      atMost match {
+        case _: Infinite ⇒ finishedJob
+        case duration: FiniteDuration ⇒
+          val prom = Promise[Job]()
+          val timeout = system.scheduler.scheduleOnce(duration) {
+            prom.success(job)
+            ()
+          }
+          finishedJob.onComplete(_ ⇒ timeout.cancel())
+          Future.firstCompletedOf(List(finishedJob, prom.future))
+      }
     }
   }
 }
@@ -78,7 +89,7 @@ object JobActor {
   case class JobList(total: Int, jobs: Seq[Job])
   case class GetJob(jobId: String)
   case object JobNotFound
-  case class CreateJob(artifact: Artifact, analyzer: Analyzer)
+  case class CreateJob(artifact: Artifact, analyzer: Analyzer, report: Future[Report])
   case class RemoveJob(jobId: String)
   case object JobRemoved
   case object JobCleanup
@@ -91,6 +102,7 @@ class JobActor(
     implicit val ec: ExecutionContext) extends Actor {
 
   import services.JobActor._
+
   @Inject def this(
     configuration: Configuration,
     analyzerSrv: AnalyzerSrv,
@@ -122,7 +134,7 @@ class JobActor(
       val filteredJobs = jobs.filter(j ⇒
         dataTypeFilter.fold(true)(j.artifact.dataTypeFilter) &&
           dataFilter.fold(true)(j.artifact.dataFilter) &&
-          analyzerFilter.fold(true)(j.analyzerId.contains))
+          analyzerFilter.fold(true)(j.analyzer.id.contains))
       sender ! JobList(filteredJobs.size, filteredJobs.slice(start, start + limit))
     case GetJob(jobId) ⇒ sender ! jobs.find(_.id == jobId).getOrElse(JobNotFound)
     case RemoveJob(jobId) ⇒
@@ -132,9 +144,9 @@ class JobActor(
           context.become(jobState(j))
         case None ⇒ sender ! JobNotFound
       }
-    case CreateJob(artifact, analyzer) ⇒
+    case CreateJob(artifact, analyzer, report) ⇒
       val jobId = Random.alphanumeric.take(16).mkString
-      val job = Job(jobId, analyzer.id, artifact, analyzer.analyze(artifact))
+      val job = Job(jobId, analyzer, artifact, report)
       sender ! job
       context.become(jobState(job :: jobs))
     case JobCleanup if jobLifeTime.isInstanceOf[FiniteDuration] ⇒
diff --git a/app/services/MispSrv.scala b/app/services/MispSrv.scala
index e11253e35..139eb749c 100644
--- a/app/services/MispSrv.scala
+++ b/app/services/MispSrv.scala
@@ -1,20 +1,77 @@
 package services
 
+import java.io.{ ByteArrayInputStream, FileInputStream, InputStream, SequenceInputStream }
 import javax.inject.Inject
 
-import models.JsonFormat.dataActifactReads
-import models.{ DataArtifact, FileArtifact }
-import org.apache.commons.codec.binary.Base64
-import play.api.Logger
-import play.api.libs.json.{ JsArray, JsObject, JsValue, Json }
+import akka.actor.ActorSystem
+import models.JsonFormat._
+import models._
+import org.apache.commons.codec.binary.{ Base64, Base64InputStream }
+import play.api.libs.json.{ Json, _ }
+import play.api.{ Configuration, Logger }
 
+import scala.collection.JavaConverters._
 import scala.concurrent.{ ExecutionContext, Future }
+import scala.sys.process._
+import scala.util.{ Failure, Success, Try }
+
+class MispSrv(
+    loaderCommandOption: Option[String],
+    externalAnalyzerSrv: ExternalAnalyzerSrv,
+    jobSrv: JobSrv,
+    akkaSystem: ActorSystem) {
+
+  @Inject() def this(
+    configuration: Configuration,
+    externalAnalyzerSrv: ExternalAnalyzerSrv,
+    jobSrv: JobSrv,
+    akkaSystem: ActorSystem) = this(
+    configuration.getString("misp.modules.loader"),
+    externalAnalyzerSrv,
+    jobSrv,
+    akkaSystem)
 
-class MispSrv @Inject() (analyzerSrv: AnalyzerSrv) {
   private[MispSrv] lazy val logger = Logger(getClass)
+  private[MispSrv] lazy val analyzeExecutionContext: ExecutionContext = akkaSystem.dispatchers.lookup("analyzer")
+
+  lazy val list: Seq[MispModule] =
+    loaderCommandOption.fold(Seq.empty[MispModule]) { loaderCommand ⇒
+      Json.parse(s"$loaderCommand --list".!!)
+        .as[Seq[String]]
+        .map { moduleName ⇒
+          moduleName → (for {
+            moduleInfo ← Try(Json.parse(s"$loaderCommand --info $moduleName".!!))
+            module ← Try(moduleInfo.as[MispModule](reads(loaderCommand)))
+          } yield module)
+        }
+        .flatMap {
+          case (moduleName, Failure(error)) ⇒
+            logger.warn(s"Load MISP module $moduleName fails", error)
+            Nil
+          case (_, Success(module)) ⇒
+            logger.info(s"Register MISP module ${module.name} ${module.version}")
+            Seq(module)
+        }
+    }
+
+  def get(moduleName: String): Option[MispModule] = list.find(_.name == moduleName)
 
-  def moduleList: JsValue = {
-    JsArray(analyzerSrv.list.map { analyzer ⇒
+  def moduleList: JsArray = {
+    val mispModules = list.map { module ⇒
+      Json.obj(
+        "name" → module.name,
+        "type" → "cortex",
+        "mispattributes" → Json.obj(
+          "input" → module.inputAttributes,
+          "output" → Json.arr()),
+        "meta" → Json.obj(
+          "module-type" → Json.arr("cortex"),
+          "description" → module.description,
+          "author" → module.author,
+          "version" → module.version,
+          "config" → module.config))
+    }
+    val externalAnalyzers = externalAnalyzerSrv.list.map { analyzer ⇒
       Json.obj(
         "name" → analyzer.id,
         "type" → "cortex",
@@ -27,58 +84,117 @@ class MispSrv @Inject() (analyzerSrv: AnalyzerSrv) {
           "author" → analyzer.author,
           "version" → analyzer.version,
           "config" → Json.arr()))
-    })
+    }
+    JsArray(mispModules ++ externalAnalyzers)
   }
 
   def query(module: String, mispType: String, data: String)(implicit ec: ExecutionContext): Future[JsObject] = {
-    analyzerSrv.get(module).map { analyzer ⇒
-      val artifact = mispType2dataType(mispType) match {
-        case "file" if mispType == "malware-sample" ⇒ ???
-        case "file" ⇒ FileArtifact(Base64.decodeBase64(data), Json.obj(
-          "tlp" → 1,
-          "dataType" → "file"))
-        case dataType ⇒ DataArtifact(data, Json.obj(
-          "tlp" → 1,
-          "dataType" → dataType))
-      }
+    loaderCommandOption
+      .flatMap { loaderCommand ⇒
+        val artifact = toArtifact(mispType, data)
+        get(module)
+          .map { mispModule ⇒
+            val mispReport = Future {
+              val input = Json.obj(mispType → data)
+              val output = (s"$loaderCommand --run $module" #< input.toString).!!
+              Json.parse(output).as[JsObject]
+            }
+            jobSrv.create(mispModule, artifact, mispReport.map(toReport))
+            mispReport
 
-      analyzer
-        .analyze(artifact)
-        .map { output ⇒
-          logger.info(s"analyzer output:\n$output")
-          val success = (output \ "success")
-            .asOpt[Boolean]
-            .getOrElse(false)
-          if (success) {
-            Json.obj(
-              "results" → ((output \ "artifacts")
-                .asOpt[Seq[JsObject]]
-                .getOrElse(Nil)
-                .map { artifact ⇒
-                  Json.obj(
-                    "types" → dataType2mispType((artifact \ "type").as[String]),
-                    "values" → Json.arr((artifact \ "value").as[String]))
-                }
-                :+ Json.obj(
-                  "types" → Json.arr("cortex"),
-                  "values" → Json.arr(output.toString))))
           }
-          else {
-            val message = (output \ "error").asOpt[String].getOrElse(output.toString)
-            Json.obj(
-              "error" → message)
+          .orElse {
+            externalAnalyzerSrv
+              .get(module)
+              .map { analyzer ⇒
+                externalAnalyzerSrv.analyze(analyzer, artifact)
+                  .map { report ⇒ toMispOutput(report) }
+              }
           }
+      }
+      .getOrElse(Future.failed(new Exception(s"Module $module not found")))
+  }
+
+  def analyze(module: MispModule, artifact: Artifact): Future[Report] = {
+    def stringStream(string: String): InputStream =
+      new ByteArrayInputStream(string.getBytes)
+
+    val input = artifact match {
+      case DataArtifact(data, _) ⇒
+        stringStream(Json.obj(dataType2mispType(artifact.dataType).head → data).toString)
+      case FileArtifact(data, _) ⇒
+        new SequenceInputStream(Iterator(
+          stringStream("""{"attachment":""""),
+          new Base64InputStream(new FileInputStream(data), true),
+          stringStream("\"}")).asJavaEnumeration)
+    }
+
+    Future {
+      val output = (s"${module.loaderCommand} --run ${module.name}" #< input).!!
+      toReport(Json.parse(output).as[JsObject])
+    }(analyzeExecutionContext)
+  }
+
+  private def toArtifact(mispType: String, data: String): Artifact = {
+    mispType2dataType(mispType) match {
+      case "file" if mispType == "malware-sample" ⇒ ???
+      case "file" ⇒ FileArtifact(Base64.decodeBase64(data), Json.obj(
+        "tlp" → 1,
+        "dataType" → "file"))
+      case dataType ⇒ DataArtifact(data, Json.obj(
+        "tlp" → 1,
+        "dataType" → dataType))
+    }
+  }
+
+  private def toReport(mispOutput: JsObject): Report = {
+    (mispOutput \ "results").asOpt[Seq[JsObject]]
+      .map { attributes ⇒
+        val artifacts: Seq[Artifact] = for {
+          attribute ← attributes
+          tpe ← (attribute \ "types").asOpt[Seq[String]]
+            .orElse((attribute \ "types").asOpt[String].map(Seq(_)))
+            .getOrElse(Nil)
+          dataType = mispType2dataType(tpe) // TODO handle FileArtifact
+          value ← (attribute \ "values").asOpt[Seq[String]]
+            .orElse((attribute \ "values").asOpt[String].map(Seq(_)))
+            .getOrElse(Nil)
+        } yield DataArtifact(value, Json.obj("dataType" → dataType))
+        SuccessReport(artifacts, Json.obj("artifacts" → Json.toJson(artifacts)), JsObject(Nil))
+      }
+      .getOrElse {
+        val message = (mispOutput \ "error").asOpt[String].getOrElse(mispOutput.toString)
+        FailureReport(message)
+      }
+  }
+
+  private def toMispOutput(report: Report): JsObject = {
+    report match {
+      case SuccessReport(artifacts, _, _) ⇒
+        val attributes = artifacts.map {
+          case artifact: DataArtifact ⇒
+            Json.obj(
+              "types" → dataType2mispType(artifact.dataType),
+              "values" → Json.arr(artifact.data))
+          case artifact: FileArtifact ⇒
+            ??? // TODO
         }
+        val cortexAttribute = Json.obj(
+          "types" → Seq("cortex"),
+          "values" → Json.arr(Json.toJson(report).toString))
+
+        Json.obj("results" → (attributes :+ cortexAttribute))
+      case FailureReport(message) ⇒
+        Json.obj("error" → message)
     }
-      .getOrElse(Future.failed(new Exception(s"Module $module not found")))
   }
 
-  def mispType2dataType(mispType: String): String = typeLookup.getOrElse(mispType, {
+  private def mispType2dataType(mispType: String): String = typeLookup.getOrElse(mispType, {
     logger.warn(s"Misp type $mispType not recognized")
     "other"
   })
 
-  def dataType2mispType(dataType: String): Seq[String] = {
+  private def dataType2mispType(dataType: String): Seq[String] = {
     val mispTypes = typeLookup.filter(_._2 == dataType)
       .keys
       .toSeq
@@ -91,6 +207,17 @@ class MispSrv @Inject() (analyzerSrv: AnalyzerSrv) {
     else mispTypes
   }
 
+  private def reads(loaderCommand: String): Reads[MispModule] =
+    for {
+      name ← (__ \ "name").read[String]
+      version ← (__ \ "meta" \ "version").read[String]
+      description ← (__ \ "meta" \ "description").read[String]
+      author ← (__ \ "meta" \ "author").read[String]
+      config ← (__ \ "meta" \ "config").read[Seq[String]]
+      input ← (__ \ "mispattributes" \ "input").read[Seq[String]]
+      dataTypes = input.map(mispType2dataType)
+    } yield MispModule(name, version, description, author, dataTypes, input, config, loaderCommand)
+
   private val typeLookup = Map(
     "md5" → "hash",
     "sha1" → "hash",
diff --git a/app/util/JsonConfig.scala b/app/util/JsonConfig.scala
index 0c91d548a..79e075e02 100644
--- a/app/util/JsonConfig.scala
+++ b/app/util/JsonConfig.scala
@@ -1,17 +1,15 @@
 package util
 
-import scala.BigDecimal
-import scala.collection.JavaConversions.asScalaBuffer
-
+import com.typesafe.config.ConfigValueType.{ BOOLEAN, NULL, NUMBER, STRING }
+import com.typesafe.config.{ ConfigList, ConfigObject, ConfigValue }
 import play.api.Configuration
-import play.api.libs.json.{ JsArray, JsBoolean, JsNull, JsNumber, JsObject, JsString, OWrites, Writes }
+import play.api.libs.json._
 
-import com.typesafe.config.{ ConfigList, ConfigObject, ConfigValue }
-import com.typesafe.config.ConfigValueType.{ BOOLEAN, NULL, NUMBER, STRING }
+import scala.collection.JavaConversions.asScalaBuffer
 
 object JsonConfig {
   implicit val configValueWrites: Writes[ConfigValue] = Writes((value: ConfigValue) ⇒ value match {
-    case v: ConfigObject             ⇒ configWrites.writes(Configuration(v.toConfig()))
+    case v: ConfigObject             ⇒ configWrites.writes(Configuration(v.toConfig))
     case v: ConfigList               ⇒ JsArray(v.toSeq.map(x ⇒ configValueWrites.writes(x)))
     case v if v.valueType == NUMBER  ⇒ JsNumber(BigDecimal(v.unwrapped.asInstanceOf[java.lang.Number].toString))
     case v if v.valueType == BOOLEAN ⇒ JsBoolean(v.unwrapped.asInstanceOf[Boolean])
@@ -19,7 +17,7 @@ object JsonConfig {
     case v if v.valueType == STRING  ⇒ JsString(v.unwrapped.asInstanceOf[String])
   })
 
-  implicit val configWrites = OWrites { (cfg: Configuration) ⇒
+  implicit def configWrites = OWrites { (cfg: Configuration) ⇒
     JsObject(cfg.subKeys.map(key ⇒ key → configValueWrites.writes(cfg.underlying.getValue(key))).toSeq)
   }
 }
\ No newline at end of file
diff --git a/build.sbt b/build.sbt
index b149c99fc..1668fa704 100644
--- a/build.sbt
+++ b/build.sbt
@@ -41,9 +41,8 @@ mappings in Universal ++= {
 }
 
 // Release //
-import ReleaseTransformations._
-
 import Release._
+import sbtrelease.ReleasePlugin.autoImport.ReleaseTransformations._
 
 bintrayOrganization := Some("cert-bdf")
 
@@ -88,9 +87,9 @@ dockerUpdateLatest := true
 mappings in Universal += file("docker/entrypoint") -> "bin/entrypoint"
 
 mappings in Universal ~= { _.filterNot {
-  case (_, name) => name.startsWith("conf/") && name != "conf/keepme"
+  case (_, fileName) => fileName.startsWith("conf/") && name != "conf/keepme"
 }}
-import com.typesafe.sbt.packager.docker.{ ExecCmd, Cmd }
+import com.typesafe.sbt.packager.docker.{Cmd, ExecCmd}
 
 dockerCommands := dockerCommands.value.map {
   case ExecCmd("ENTRYPOINT", _*) => ExecCmd("ENTRYPOINT", "bin/entrypoint")
@@ -109,10 +108,10 @@ dockerCommands := dockerCommands.value.head +:
   dockerCommands.value.tail
 
 // Scalariform //
-import scalariform.formatter.preferences._
-import com.typesafe.sbt.SbtScalariform
 import com.typesafe.sbt.SbtScalariform.ScalariformKeys
 
+import scalariform.formatter.preferences._
+
 ScalariformKeys.preferences in ThisBuild := ScalariformKeys.preferences.value
   .setPreference(AlignParameters, false)
 //  .setPreference(FirstParameterOnNewline, Force)
diff --git a/contrib/misp-modules-loader.py b/contrib/misp-modules-loader.py
index fb0ed9e83..c265aaaf8 100755
--- a/contrib/misp-modules-loader.py
+++ b/contrib/misp-modules-loader.py
@@ -1,4 +1,4 @@
-#!/usr/bin/env python
+#!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 
 
diff --git a/project/Bintray.scala b/project/Bintray.scala
index 7c3ad44e2..61fed98bf 100644
--- a/project/Bintray.scala
+++ b/project/Bintray.scala
@@ -1,18 +1,16 @@
 import java.io.File
 
-import scala.concurrent.duration.Duration
-import scala.concurrent.Await
-import scala.concurrent.ExecutionContext.Implicits.global
-
-import sbt._
-import sbt.Keys._
-
-import dispatch.{ Http, FunctionHandler }
-
-import bintry.Client
 import bintray.BintrayCredentials
-import bintray.BintrayKeys.{ bintrayEnsureCredentials, bintrayOrganization, bintrayRepository, bintrayPackage }
+import bintray.BintrayKeys.{bintrayEnsureCredentials, bintrayOrganization, bintrayPackage, bintrayRepository}
+import bintry.Client
 import com.typesafe.sbt.packager.universal.UniversalPlugin.autoImport.Universal
+import dispatch.{FunctionHandler, Http}
+import sbt.Keys._
+import sbt._
+
+import scala.concurrent.Await
+import scala.concurrent.ExecutionContext.Implicits.global
+import scala.concurrent.duration.Duration
 
 object PublishToBinTray extends Plugin {
   val publishRelease = taskKey[Unit]("Publish binary in bintray")
diff --git a/project/FrontEnd.scala b/project/FrontEnd.scala
index f0bf55342..ac8b44d0c 100644
--- a/project/FrontEnd.scala
+++ b/project/FrontEnd.scala
@@ -1,5 +1,5 @@
-import sbt._
 import sbt.Keys._
+import sbt._
 
 object FrontEnd extends AutoPlugin {
 
diff --git a/project/Release.scala b/project/Release.scala
index 3dbeb2ee3..7a0184f08 100644
--- a/project/Release.scala
+++ b/project/Release.scala
@@ -1,10 +1,9 @@
-import sbt._
+import play.api.libs.json._
 import sbt.Keys.baseDirectory
-import sbt.{ Project, Extracted, State, IO, File, StateOps }
+import sbt.{File, IO, Project, State, _}
 import sbtrelease.ReleasePlugin.autoImport._
 import sbtrelease.ReleaseStateTransformations.readVersion
-import sbtrelease.{ Vcs, Versions }
-import play.api.libs.json._
+import sbtrelease.{Vcs, Versions}
 
 object Release {
   val releaseVersionUIFile = settingKey[File]("The json package file to write the version to")

From d5fd06a298debaed148c7cd4a053d3254164666e Mon Sep 17 00:00:00 2001
From: To-om <toom@thehive-project.org>
Date: Sat, 6 May 2017 11:53:17 +0200
Subject: [PATCH 16/32] #21 ReAdd deleted file

---
 app/services/AnalyzerSrv.scala | 37 ++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 app/services/AnalyzerSrv.scala

diff --git a/app/services/AnalyzerSrv.scala b/app/services/AnalyzerSrv.scala
new file mode 100644
index 000000000..de43e6013
--- /dev/null
+++ b/app/services/AnalyzerSrv.scala
@@ -0,0 +1,37 @@
+package services
+
+import javax.inject.{ Inject, Singleton }
+
+import models._
+import play.api.Logger
+
+import scala.concurrent.Future
+
+@Singleton
+class AnalyzerSrv @Inject() (
+    jobSrv: JobSrv,
+    mispSrv: MispSrv,
+    externalAnalyzerSrv: ExternalAnalyzerSrv) {
+
+  private[AnalyzerSrv] lazy val logger = Logger(getClass)
+
+  def list: Seq[Analyzer] = externalAnalyzerSrv.list ++ mispSrv.list
+
+  def get(analyzerId: String): Option[Analyzer] = list.find(_.id == analyzerId)
+
+  def listForType(dataType: String): Seq[Analyzer] = list.filter(_.dataTypeList.contains(dataType))
+
+  def analyze(analyzerId: String, artifact: Artifact): Future[Job] = {
+    get(analyzerId)
+      .map { analyzer ⇒ analyze(analyzer, artifact) }
+      .getOrElse(sys.error("analyzer not found"))
+  }
+
+  def analyze(analyzer: Analyzer, artifact: Artifact): Future[Job] = {
+    val report = analyzer match {
+      case ea: ExternalAnalyzer ⇒ externalAnalyzerSrv.analyze(ea, artifact)
+      case mm: MispModule       ⇒ mispSrv.analyze(mm, artifact)
+    }
+    jobSrv.create(analyzer, artifact, report)
+  }
+}
\ No newline at end of file

From 5653c19898d37766b0057805592e27022150e4c8 Mon Sep 17 00:00:00 2001
From: To-om <toom@thehive-project.org>
Date: Sun, 7 May 2017 13:52:56 +0200
Subject: [PATCH 17/32] #21 Make baseConfig optional

---
 app/services/ExternalAnalyzerSrv.scala | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/app/services/ExternalAnalyzerSrv.scala b/app/services/ExternalAnalyzerSrv.scala
index ae1927e69..7bdf23063 100644
--- a/app/services/ExternalAnalyzerSrv.scala
+++ b/app/services/ExternalAnalyzerSrv.scala
@@ -128,8 +128,10 @@ class ExternalAnalyzerSrv(
       command ← (__ \ "command").read[String]
       absoluteCommand = analyzerPath.resolve(Paths.get(command.replaceAll("[\\/]", File.separator)))
       config ← (__ \ "config").read[JsObject]
-      baseConfigKey ← (__ \ "baseConfig").read[String]
-      baseConfig = (analyzerConfig \ baseConfigKey).asOpt[JsObject].getOrElse(JsObject(Nil))
+      baseConfigKey ← (__ \ "baseConfig").readNullable[String]
+      baseConfig = baseConfigKey
+        .flatMap(bc ⇒ (analyzerConfig \ bc).asOpt[JsObject])
+        .getOrElse(Json.obj())
     } yield ExternalAnalyzer(
       name,
       version,

From 2ba3ff88c7634b52524334f22d01eeaebf09589b Mon Sep 17 00:00:00 2001
From: To-om <toom@thehive-project.org>
Date: Sun, 7 May 2017 14:07:14 +0200
Subject: [PATCH 18/32] #21 Add success field in report

---
 app/models/JsonFormat.scala | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/app/models/JsonFormat.scala b/app/models/JsonFormat.scala
index 9a81cd685..e411bb82c 100644
--- a/app/models/JsonFormat.scala
+++ b/app/models/JsonFormat.scala
@@ -59,9 +59,11 @@ object JsonFormat {
   val reportWrites: Writes[Report] = Writes[Report] {
     case SuccessReport(artifacts, full, summary) ⇒ Json.obj(
       "artifacts" → artifacts,
-      "full" → full,
-      "summary" → summary)
-    case FailureReport(message) ⇒ Json.obj("errorMessage" → message)
+      "full" → (full + ("success" → JsBoolean(true))),
+      "summary" → (summary + ("success" → JsBoolean(true))))
+    case FailureReport(message) ⇒ Json.obj(
+      "errorMessage" → message,
+      "success" → false)
   }
 
   implicit val reportFormat: Format[Report] = Format[Report](reportReads, reportWrites)

From cf7d733228e4f654c21ac104d6438344d69bbeeb Mon Sep 17 00:00:00 2001
From: To-om <toom@thehive-project.org>
Date: Sun, 7 May 2017 14:17:21 +0200
Subject: [PATCH 19/32] #21 Put success in right place

---
 app/models/JsonFormat.scala | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/app/models/JsonFormat.scala b/app/models/JsonFormat.scala
index e411bb82c..561544d3b 100644
--- a/app/models/JsonFormat.scala
+++ b/app/models/JsonFormat.scala
@@ -59,8 +59,9 @@ object JsonFormat {
   val reportWrites: Writes[Report] = Writes[Report] {
     case SuccessReport(artifacts, full, summary) ⇒ Json.obj(
       "artifacts" → artifacts,
-      "full" → (full + ("success" → JsBoolean(true))),
-      "summary" → (summary + ("success" → JsBoolean(true))))
+      "full" → full,
+      "summary" → summary,
+      "success" → true)
     case FailureReport(message) ⇒ Json.obj(
       "errorMessage" → message,
       "success" → false)

From 0b85658f2ee8d3c78b03511a96cdf64132221670 Mon Sep 17 00:00:00 2001
From: To-om <toom@thehive-project.org>
Date: Mon, 8 May 2017 21:33:38 +0200
Subject: [PATCH 20/32] Add error handler to return appropriate response status
 code

---
 app/controllers/MispCtrl.scala   |  7 +++--
 app/models/Analyzer.scala.orig   | 16 ----------
 app/models/Analyzer.scala.rej    |  9 ------
 app/models/Errors.scala          |  8 +++++
 app/models/JsonFormat.scala.orig | 46 ----------------------------
 app/models/JsonFormat.scala.rej  | 51 --------------------------------
 app/services/AnalyzerSrv.scala   |  2 +-
 app/services/ErrorHandler.scala  | 27 +++++++++++++++++
 app/services/JobSrv.scala        | 13 ++++----
 conf/reference.conf              |  3 ++
 10 files changed, 49 insertions(+), 133 deletions(-)
 delete mode 100644 app/models/Analyzer.scala.orig
 delete mode 100644 app/models/Analyzer.scala.rej
 create mode 100644 app/models/Errors.scala
 delete mode 100644 app/models/JsonFormat.scala.orig
 delete mode 100644 app/models/JsonFormat.scala.rej
 create mode 100644 app/services/ErrorHandler.scala

diff --git a/app/controllers/MispCtrl.scala b/app/controllers/MispCtrl.scala
index 8792921e5..9af50f568 100644
--- a/app/controllers/MispCtrl.scala
+++ b/app/controllers/MispCtrl.scala
@@ -2,6 +2,7 @@ package controllers
 
 import javax.inject.Inject
 
+import models.InvalidRequestError
 import play.api.Logger
 import play.api.libs.json.{ JsObject, JsValue }
 import play.api.mvc.{ Action, AnyContent, Controller }
@@ -17,13 +18,13 @@ class MispCtrl @Inject() (mispSrv: MispSrv, implicit val ec: ExecutionContext) e
   }
 
   def query: Action[JsValue] = Action.async(parse.json) { request ⇒
-    val module = (request.body \ "module").asOpt[String].getOrElse(sys.error("module not present in request"))
+    val module = (request.body \ "module").asOpt[String].getOrElse(throw InvalidRequestError("Module parameter is not present in request"))
     val (mispType, dataJson) = request.body.as[JsObject].fields
       .collectFirst {
         case kv @ (k, _) if k != "module" ⇒ kv
       }
-      .getOrElse(sys.error("invalid request"))
-    val data = dataJson.asOpt[String].getOrElse(sys.error("data has invalid type (expected string)"))
+      .getOrElse(throw InvalidRequestError("Request doesn't contain data to analyze"))
+    val data = dataJson.asOpt[String].getOrElse(throw InvalidRequestError("Data has invalid type (expected string)"))
     mispSrv.query(module, mispType, data)
       .map(Ok(_))
   }
diff --git a/app/models/Analyzer.scala.orig b/app/models/Analyzer.scala.orig
deleted file mode 100644
index ce853ac97..000000000
--- a/app/models/Analyzer.scala.orig
+++ /dev/null
@@ -1,16 +0,0 @@
-package models
-
-import scala.concurrent.Future
-import play.api.libs.json.JsObject
-
-abstract class Analyzer {
-  def analyze(artifact: Artifact): Future[JsObject]
-  val name: String
-  val version: String
-  val description: String
-  val dataTypeList: Seq[String]
-  val author: String
-  val url: String
-  val license: String
-  val id = (name + "_" + version).replaceAll("\\.", "_")
-}
diff --git a/app/models/Analyzer.scala.rej b/app/models/Analyzer.scala.rej
deleted file mode 100644
index 1520d1f06..000000000
--- a/app/models/Analyzer.scala.rej
+++ /dev/null
@@ -1,9 +0,0 @@
---- app/models/Analyzer.scala
-+++ app/models/Analyzer.scala
-@@ -9,5 +9,5 @@ abstract class Analyzer {
-   val version: String
-   val description: String
-   val dataTypeList: Seq[String]
--  val id = (name + "_" + version).replaceAll("\\.", "_")
-+  val id: String = (name + "_" + version).replaceAll("\\.", "_")
- }
diff --git a/app/models/Errors.scala b/app/models/Errors.scala
new file mode 100644
index 000000000..bc49e6161
--- /dev/null
+++ b/app/models/Errors.scala
@@ -0,0 +1,8 @@
+package models
+
+abstract class CortexError(message: String) extends Exception(message)
+
+case class JobNotFoundError(jobId: String) extends CortexError(s"Job $jobId not found")
+case class UnexpectedError(message: String) extends CortexError(message)
+case class AnalyzerNotFoundError(analyzerId: String) extends CortexError(s"Analyzer $analyzerId not found")
+case class InvalidRequestError(message: String) extends CortexError(message)
\ No newline at end of file
diff --git a/app/models/JsonFormat.scala.orig b/app/models/JsonFormat.scala.orig
deleted file mode 100644
index b2536890c..000000000
--- a/app/models/JsonFormat.scala.orig
+++ /dev/null
@@ -1,46 +0,0 @@
-package models
-
-import scala.annotation.implicitNotFound
-
-import play.api.libs.json.Json
-import play.api.libs.json.Json.toJsFieldJsValueWrapper
-import play.api.libs.json.Writes
-import scala.concurrent.Future
-import play.api.libs.json.JsObject
-import scala.util.Success
-import scala.util.Failure
-import play.api.libs.json.JsString
-import play.api.libs.json.OWrites
-
-object JsonFormat {
-  implicit val analyzerWrites = Writes[Analyzer](analyzer ⇒ Json.obj(
-    "name" → analyzer.name,
-    "version" → analyzer.version,
-    "description" → analyzer.description,
-    "dataTypeList" → analyzer.dataTypeList,
-    "author" → analyzer.author,
-    "url" → analyzer.url,
-    "license" → analyzer.license,
-    "id" → analyzer.id))
-
-  implicit val fileArtifactWrites = OWrites[FileArtifact](fileArtifact ⇒ Json.obj(
-    "attributes" → fileArtifact.attributes))
-
-  implicit val dataArtifactWrites = Json.writes[DataArtifact]
-  implicit val dataActifactReads = Json.reads[DataArtifact]
-
-  implicit val artifactWrites = OWrites[Artifact](artifact ⇒ artifact match {
-    case dataArtifact: DataArtifact ⇒ dataArtifactWrites.writes(dataArtifact)
-    case fileArtifact: FileArtifact ⇒ fileArtifactWrites.writes(fileArtifact)
-  })
-
-  implicit val jobStatusWrites = Writes[JobStatus.Type](jobStatus ⇒ JsString(jobStatus.toString))
-
-  implicit val jobWrites = OWrites[Job](job ⇒ Json.obj(
-    "id" → job.id,
-    "analyzerId" → job.analyzerId,
-    "status" → job.status,
-    "date" → job.date,
-    "artifact" → job.artifact))
-
-}
diff --git a/app/models/JsonFormat.scala.rej b/app/models/JsonFormat.scala.rej
deleted file mode 100644
index e6924f842..000000000
--- a/app/models/JsonFormat.scala.rej
+++ /dev/null
@@ -1,51 +0,0 @@
---- app/models/JsonFormat.scala
-+++ app/models/JsonFormat.scala
-@@ -1,39 +1,30 @@
- package models
- 
--import scala.annotation.implicitNotFound
--
--import play.api.libs.json.Json
- import play.api.libs.json.Json.toJsFieldJsValueWrapper
--import play.api.libs.json.Writes
--import scala.concurrent.Future
--import play.api.libs.json.JsObject
--import scala.util.Success
--import scala.util.Failure
--import play.api.libs.json.JsString
--import play.api.libs.json.OWrites
-+import play.api.libs.json._
- 
- object JsonFormat {
--  implicit val analyzerWrites = Writes[Analyzer](analyzer ⇒ Json.obj(
-+  implicit val analyzerWrites: Writes[Analyzer] = Writes[Analyzer](analyzer ⇒ Json.obj(
-     "name" → analyzer.name,
-     "version" → analyzer.version,
-     "description" → analyzer.description,
-     "dataTypeList" → analyzer.dataTypeList,
-     "id" → analyzer.id))
- 
--  implicit val fileArtifactWrites = OWrites[FileArtifact](fileArtifact ⇒ Json.obj(
-+  implicit val fileArtifactWrites: OWrites[FileArtifact] = OWrites[FileArtifact](fileArtifact ⇒ Json.obj(
-     "attributes" → fileArtifact.attributes))
- 
--  implicit val dataArtifactWrites = Json.writes[DataArtifact]
--  implicit val dataActifactReads = Json.reads[DataArtifact]
-+  implicit val dataArtifactWrites: OWrites[DataArtifact] = Json.writes[DataArtifact]
-+  implicit val dataActifactReads: Reads[DataArtifact] = Json.reads[DataArtifact]
- 
--  implicit val artifactWrites = OWrites[Artifact](artifact ⇒ artifact match {
-+  implicit val artifactWrites: OWrites[Artifact] = OWrites[Artifact] {
-     case dataArtifact: DataArtifact ⇒ dataArtifactWrites.writes(dataArtifact)
-     case fileArtifact: FileArtifact ⇒ fileArtifactWrites.writes(fileArtifact)
--  })
-+  }
- 
--  implicit val jobStatusWrites = Writes[JobStatus.Type](jobStatus ⇒ JsString(jobStatus.toString))
-+  implicit val jobStatusWrites: Writes[JobStatus.Type] = Writes[JobStatus.Type](jobStatus ⇒ JsString(jobStatus.toString))
- 
--  implicit val jobWrites = OWrites[Job](job ⇒ Json.obj(
-+  implicit val jobWrites: OWrites[Job] = OWrites[Job](job ⇒ Json.obj(
-     "id" → job.id,
-     "analyzerId" → job.analyzerId,
-     "status" → job.status,
diff --git a/app/services/AnalyzerSrv.scala b/app/services/AnalyzerSrv.scala
index de43e6013..9e2f75fe6 100644
--- a/app/services/AnalyzerSrv.scala
+++ b/app/services/AnalyzerSrv.scala
@@ -24,7 +24,7 @@ class AnalyzerSrv @Inject() (
   def analyze(analyzerId: String, artifact: Artifact): Future[Job] = {
     get(analyzerId)
       .map { analyzer ⇒ analyze(analyzer, artifact) }
-      .getOrElse(sys.error("analyzer not found"))
+      .getOrElse(throw AnalyzerNotFoundError(analyzerId))
   }
 
   def analyze(analyzer: Analyzer, artifact: Artifact): Future[Job] = {
diff --git a/app/services/ErrorHandler.scala b/app/services/ErrorHandler.scala
new file mode 100644
index 000000000..9d6c446c7
--- /dev/null
+++ b/app/services/ErrorHandler.scala
@@ -0,0 +1,27 @@
+package services
+
+import models.{ AnalyzerNotFoundError, InvalidRequestError, JobNotFoundError, UnexpectedError }
+import play.api.Logger
+import play.api.http.HttpErrorHandler
+import play.api.mvc.{ RequestHeader, Result, Results }
+
+import scala.concurrent.Future
+
+class ErrorHandler extends HttpErrorHandler {
+  private[ErrorHandler] lazy val logger = Logger(getClass)
+  def onClientError(request: RequestHeader, statusCode: Int, message: String): Future[Result] = Future.successful {
+    Results.Status(statusCode)(s"A client error occurred on ${request.method} ${request.uri} : $message")
+  }
+
+  def onServerError(request: RequestHeader, exception: Throwable): Future[Result] = {
+    val result = exception match {
+      case JobNotFoundError(jobId)           ⇒ Results.NotFound(s"Job $jobId not found")
+      case UnexpectedError(message)          ⇒ Results.InternalServerError(message)
+      case AnalyzerNotFoundError(analyzerId) ⇒ Results.NotFound(s"analyzer $analyzerId not found")
+      case InvalidRequestError(message)      ⇒ Results.BadRequest(message)
+      case error                             ⇒ Results.InternalServerError(s"Unexpected error: $error")
+    }
+    Logger.info(s"${request.method} ${request.uri} returned ${result.header.status}", exception)
+    Future.successful(result)
+  }
+}
diff --git a/app/services/JobSrv.scala b/app/services/JobSrv.scala
index 787ca7d6f..4d6390f2a 100644
--- a/app/services/JobSrv.scala
+++ b/app/services/JobSrv.scala
@@ -15,7 +15,6 @@ import scala.concurrent.{ ExecutionContext, Future, Promise }
 import scala.util.Random
 
 class JobSrv @Inject() (
-    //analyzerSrv: AnalyzerSrv,
     @Named("JobActor") jobActor: ActorRef,
     implicit val ec: ExecutionContext,
     implicit val system: ActorSystem) {
@@ -27,20 +26,20 @@ class JobSrv @Inject() (
   def list(dataTypeFilter: Option[String], dataFilter: Option[String], analyzerFilter: Option[String], start: Int, limit: Int): Future[(Int, Seq[Job])] = {
     (jobActor ? ListJobs(dataTypeFilter, dataFilter, analyzerFilter, start, limit)).map {
       case JobList(total, jobs) ⇒ total → jobs
-      case _                    ⇒ sys.error("TODO")
+      case m                    ⇒ throw UnexpectedError(s"JobActor.list replies with unexpected message: $m (${m.getClass})")
     }
   }
 
   def get(jobId: String): Future[Job] = (jobActor ? GetJob(jobId)).map {
     case j: Job      ⇒ j
-    case JobNotFound ⇒ sys.error("job not found")
-    case _           ⇒ sys.error("TODO")
+    case JobNotFound ⇒ throw JobNotFoundError(jobId)
+    case m           ⇒ throw UnexpectedError(s"JobActor.GetJob replies with unexpected message: $m (${m.getClass})")
   }
 
   def create(analyzer: Analyzer, artifact: Artifact, report: Future[Report]): Future[Job] = {
     (jobActor ? CreateJob(artifact, analyzer, report)) map {
       case job: Job ⇒ job
-      case _        ⇒ sys.error("TODO")
+      case m        ⇒ throw UnexpectedError(s"JobActor.CreateJob replies with unexpected message: $m (${m.getClass})")
     }
   }
 
@@ -61,8 +60,8 @@ class JobSrv @Inject() (
   def remove(jobId: String): Future[Unit] = {
     (jobActor ? RemoveJob(jobId)).map {
       case JobRemoved  ⇒ ()
-      case JobNotFound ⇒ sys.error("job not found")
-      case _           ⇒ sys.error("TODO")
+      case JobNotFound ⇒ throw JobNotFoundError(jobId)
+      case m           ⇒ throw UnexpectedError(s"JobActor.RemoveJob replies with unexpected message: $m (${m.getClass})")
     }
   }
 
diff --git a/conf/reference.conf b/conf/reference.conf
index bd943c020..8484a2429 100644
--- a/conf/reference.conf
+++ b/conf/reference.conf
@@ -1,3 +1,6 @@
+# handler for errors (transform exception to related http status code
+play.http.errorHandler = services.ErrorHandler
+
 analyzer {
   # Directory that holds analyzers
   path = analyzers

From 27af4fe735a840033810670f9a245ba938caeee0 Mon Sep 17 00:00:00 2001
From: To-om <toom@thehive-project.org>
Date: Mon, 8 May 2017 21:47:49 +0200
Subject: [PATCH 21/32] #20 Fix log file location in development mode

rename install folder in package
---
 build.sbt                              | 26 ++++++++---------
 conf/logback.xml                       |  2 +-
 {install => package}/cortex            |  0
 {install => package}/cortex.conf       |  0
 {install => package}/cortex.service    |  0
 {install => package}/docker/entrypoint |  0
 {install => package}/empty             |  0
 package/logback.xml                    | 39 ++++++++++++++++++++++++++
 8 files changed, 53 insertions(+), 14 deletions(-)
 rename {install => package}/cortex (100%)
 rename {install => package}/cortex.conf (100%)
 rename {install => package}/cortex.service (100%)
 rename {install => package}/docker/entrypoint (100%)
 rename {install => package}/empty (100%)
 create mode 100644 package/logback.xml

diff --git a/build.sbt b/build.sbt
index 706bb08db..6184628d5 100644
--- a/build.sbt
+++ b/build.sbt
@@ -39,9 +39,9 @@ mappings in Universal ~= {
     case (file, "conf/apllication.sample") => Seq(file -> "conf/application.conf")
     case other => Seq(other)
   } ++ Seq(
-    file("install/cortex.service") -> "install/cortex.service",
-    file("install/cortex.conf") -> "install/cortex.conf",
-    file("install/cortex") -> "install/cortex"
+    file("package/cortex.service") -> "package/cortex.service",
+    file("package/cortex.conf") -> "package/cortex.conf",
+    file("package/cortex") -> "package/cortex"
   )
 }
 
@@ -52,13 +52,13 @@ packageDescription := """--""".stripMargin
 defaultLinuxInstallLocation := "/opt"
 linuxPackageMappings ~= { _.map { pm =>
   val mappings = pm.mappings.filterNot {
-    case (file, path) => path.startsWith("/opt/cortex/install") || path.startsWith("/opt/cortex/conf")
+    case (file, path) => path.startsWith("/opt/cortex/package") || path.startsWith("/opt/cortex/conf")
   }
   com.typesafe.sbt.packager.linux.LinuxPackageMapping(mappings, pm.fileData).withConfig()
 } :+ packageMapping(
-  file("install/cortex.service") -> "/etc/systemd/system/cortex.service",
-  file("install/cortex.conf") -> "/etc/init/cortex.conf",
-  file("install/cortex") -> "/etc/init.d/cortex",
+  file("package/cortex.service") -> "/etc/systemd/system/cortex.service",
+  file("package/cortex.conf") -> "/etc/init/cortex.conf",
+  file("package/cortex") -> "/etc/init.d/cortex",
   file("conf/application.sample") -> "/etc/cortex/application.conf",
   file("conf/logback.xml") -> "/etc/cortex/logback.xml"
 ).withConfig()
@@ -73,10 +73,10 @@ packageBin := {
 //debianPackageRecommends := Seq("elasticsearch")
 debianPackageDependencies += "java8-runtime-headless | java8-runtime"
 maintainerScripts in Debian := maintainerScriptsFromDirectory(
-  baseDirectory.value / "install" / "debian",
+  baseDirectory.value / "package" / "debian",
   Seq(DebianConstants.Postinst, DebianConstants.Prerm, DebianConstants.Postrm)
 )
-linuxEtcDefaultTemplate in Debian := (baseDirectory.value / "install" / "etc_default_cortex").asURL
+linuxEtcDefaultTemplate in Debian := (baseDirectory.value / "package" / "etc_default_cortex").asURL
 linuxMakeStartScript in Debian := None
 
 // RPM //
@@ -86,12 +86,12 @@ rpmUrl := Some("http://thehive-project.org/")
 rpmLicense := Some("AGPL")
 rpmRequirements += "java-1.8.0-openjdk-headless"
 maintainerScripts in Rpm := maintainerScriptsFromDirectory(
-  baseDirectory.value / "install" / "rpm",
+  baseDirectory.value / "package" / "rpm",
   Seq(RpmConstants.Pre, RpmConstants.Preun, RpmConstants.Postun)
 )
 linuxPackageSymlinks in Rpm := Nil
 rpmPrefix := Some(defaultLinuxInstallLocation.value)
-linuxEtcDefaultTemplate in Rpm := (baseDirectory.value / "install" / "etc_default_cortex").asURL
+linuxEtcDefaultTemplate in Rpm := (baseDirectory.value / "package" / "etc_default_cortex").asURL
 
 // DOCKER //
 import com.typesafe.sbt.packager.docker.{ Cmd, ExecCmd }
@@ -102,9 +102,9 @@ dockerUpdateLatest := true
 dockerEntrypoint := Seq("/opt/cortex/entrypoint")
 dockerExposedPorts := Seq(9000)
 mappings in Docker ++= Seq(
-  file("install/docker/entrypoint") -> "/opt/cortex/entrypoint",
+  file("package/docker/entrypoint") -> "/opt/cortex/entrypoint",
   file("conf/logback.xml") -> "/etc/cortex/logback.xml",
-  file("install/empty") -> "/var/log/cortex/application.log")
+  file("package/empty") -> "/var/log/cortex/application.log")
 mappings in Docker ~= (_.filterNot {
   case (_, filepath) => filepath == "/opt/cortex/conf/application.conf"
 })
diff --git a/conf/logback.xml b/conf/logback.xml
index 2f1ff1748..864f2b5f2 100644
--- a/conf/logback.xml
+++ b/conf/logback.xml
@@ -5,7 +5,7 @@
 		converterClass="play.api.libs.logback.ColoredLevel" />
 
 	<appender name="FILE" class="ch.qos.logback.core.FileAppender">
-		<file>/var/log/cortex/application.log</file>
+		<file>${application.home:-.}/logs/application.log</file>
 		<encoder>
 			<pattern>%date [%level] from %logger in %thread - %message%n%xException</pattern>
 		</encoder>
diff --git a/install/cortex b/package/cortex
similarity index 100%
rename from install/cortex
rename to package/cortex
diff --git a/install/cortex.conf b/package/cortex.conf
similarity index 100%
rename from install/cortex.conf
rename to package/cortex.conf
diff --git a/install/cortex.service b/package/cortex.service
similarity index 100%
rename from install/cortex.service
rename to package/cortex.service
diff --git a/install/docker/entrypoint b/package/docker/entrypoint
similarity index 100%
rename from install/docker/entrypoint
rename to package/docker/entrypoint
diff --git a/install/empty b/package/empty
similarity index 100%
rename from install/empty
rename to package/empty
diff --git a/package/logback.xml b/package/logback.xml
new file mode 100644
index 000000000..2f1ff1748
--- /dev/null
+++ b/package/logback.xml
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<configuration debug="false">
+
+	<conversionRule conversionWord="coloredLevel"
+		converterClass="play.api.libs.logback.ColoredLevel" />
+
+	<appender name="FILE" class="ch.qos.logback.core.FileAppender">
+		<file>/var/log/cortex/application.log</file>
+		<encoder>
+			<pattern>%date [%level] from %logger in %thread - %message%n%xException</pattern>
+		</encoder>
+	</appender>
+
+	<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
+		<encoder>
+			<pattern>%coloredLevel %logger{15} - %message%n%xException{10}
+			</pattern>
+		</encoder>
+	</appender>
+
+	<appender name="ASYNCFILE" class="ch.qos.logback.classic.AsyncAppender">
+		<appender-ref ref="FILE" />
+	</appender>
+
+	<appender name="ASYNCSTDOUT" class="ch.qos.logback.classic.AsyncAppender">
+		<appender-ref ref="STDOUT" />
+	</appender>
+
+	<logger name="play" level="INFO" />
+	<logger name="application" level="INFO" />
+
+	<logger name="com.gargoylesoftware.htmlunit.javascript" level="OFF" />
+
+	<root level="INFO">
+		<appender-ref ref="ASYNCFILE" />
+		<appender-ref ref="ASYNCSTDOUT" />
+	</root>
+
+</configuration>
\ No newline at end of file

From f080f6607b6a077eb2f90ec8f4df3c7f4bb933e1 Mon Sep 17 00:00:00 2001
From: To-om <toom@thehive-project.org>
Date: Mon, 8 May 2017 22:09:43 +0200
Subject: [PATCH 22/32] #20 Add log configuration in package

---
 build.sbt | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/build.sbt b/build.sbt
index 6184628d5..21c447657 100644
--- a/build.sbt
+++ b/build.sbt
@@ -36,12 +36,14 @@ mappings in packageBin in Assets ++= frontendFiles.value
 mappings in Universal ~= {
   _.flatMap {
     case (file, "conf/application.conf") => Nil
-    case (file, "conf/apllication.sample") => Seq(file -> "conf/application.conf")
+    case (file, "conf/apllication.sample") => Seq(file -> "conf/application.conf"
+    case (file, "conf/logback.xml") => Nil
     case other => Seq(other)
   } ++ Seq(
     file("package/cortex.service") -> "package/cortex.service",
     file("package/cortex.conf") -> "package/cortex.conf",
-    file("package/cortex") -> "package/cortex"
+    file("package/cortex") -> "package/cortex",
+    file("package/logback.xml") -> "conf/logback.xml"
   )
 }
 

From 2862a9e86d7a0ba5ce88819e55f3c0473bb3974c Mon Sep 17 00:00:00 2001
From: Nabil Adouani <nabil.adouani@gmail.com>
Date: Tue, 9 May 2017 10:02:37 +0200
Subject: [PATCH 23/32] #22 Use the new cortex logo

---
 ui/app/images/favicons/favicon-128.png        | Bin 0 -> 8821 bytes
 ui/app/images/favicons/favicon-16x16.png      | Bin 0 -> 735 bytes
 ui/app/images/favicons/favicon-196x196.png    | Bin 0 -> 37805 bytes
 ui/app/images/favicons/favicon-32x32.png      | Bin 0 -> 1728 bytes
 ui/app/images/favicons/favicon-96x96.png      | Bin 0 -> 10749 bytes
 ui/app/images/logo-small.svg                  |  59 ++++++++++++++++++
 ui/app/index.html                             |   6 +-
 ui/app/styles/main.css                        |  16 +++--
 ui/app/views/components/header.component.html |   5 +-
 9 files changed, 75 insertions(+), 11 deletions(-)
 create mode 100755 ui/app/images/favicons/favicon-128.png
 create mode 100755 ui/app/images/favicons/favicon-16x16.png
 create mode 100755 ui/app/images/favicons/favicon-196x196.png
 create mode 100755 ui/app/images/favicons/favicon-32x32.png
 create mode 100755 ui/app/images/favicons/favicon-96x96.png
 create mode 100644 ui/app/images/logo-small.svg

diff --git a/ui/app/images/favicons/favicon-128.png b/ui/app/images/favicons/favicon-128.png
new file mode 100755
index 0000000000000000000000000000000000000000..1b0e300a091ee94eaae525a81bc4e57f04dfa2c6
GIT binary patch
literal 8821
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

literal 0
HcmV?d00001

diff --git a/ui/app/images/favicons/favicon-16x16.png b/ui/app/images/favicons/favicon-16x16.png
new file mode 100755
index 0000000000000000000000000000000000000000..1ae20828d11718ed5901644d8f68ac8fc57db1cb
GIT binary patch
literal 735
zcmV<50wDc~P)<h;3K|Lk000e1NJLTq000mG000mO1^@s6AM^iV0007}Nkl<ZIE{@{
zJxo(!6g}U2uh`d8YFl`f0&S&IlL98Zf<c1eFT{k%&&Z&Q3}_5anrL8fa$q1N5+h+_
zFft*dLkk!Y1D0Y?(3%iMz|tRTY5Q8*2hXWcurZ$L%l+;-x%cEAf>Y2{R8*ICcJ>zV
zRn08NnE@c~_iy-@+|Ko>snOud%0gy8Nk15tRqzk)KP_o(y+sH?Hb|0$P3QEuYjE(c
z7>h-Z1Q?c8Tpb#Et*fl4&&oW7kjJwy+jp-;jK!if0N5Wrd{$Uj*Y!VS0AO{xB4v@m
zxHUa9NwhW_-!%H%l^$D?Bm`Zb5&HNQgr<=UN5HUh=o@RGDlG=ZFh_l}eSKGGTTjnp
z%|)v{tsZo(V&%ygh>StdwF*&)BNY*_yR-)XyJhGbszC?=Ap{h|FcfF!8`ESlp1_xp
z7s#`kAZ&VZMw15|N=Swy5QR8|EgyE>Ye%aT@O(3+(Cf|Vg757T<eU}&L5^C5{ZJTk
zP78*WgQ98VX!4NSiyeEBpKqix&7ov6M1O1}8QKE?$W%&1zi&f2lpqQTfT9rh22L1C
zo7>uM=BQLU08p9?IM+}EnMwig%p#P=LL|cxXe!Gf9UQ>a)dIt{dZZ1H`~4fV+F~i!
zSgq9nKnQ_M$wFx|K&H-xj<-P)53uv*14`PPP}ow7%p?0XH#bQqg2Aox?bmN-eozbz
zwbcw|u^#!gm#`oB4a<%86QfI#gyrGkJ9Hut@a7r}#b?Vd@Y#-r5Q6;6m4DSYozC%Z
zFDFK50N7bvbZ}LCgF??4vx%HW$m4lG-#^fOm`WvS0FXp6_0!>)P;h#^+G64V877Bw
ze7=96TNH%jFl9npUe1?xbo3V3`DO*jnL!BRKHrAl?RKueni>m!`g9`Be*jhz@`zBu
Rqpbh{002ovPDHLkV1gw9OdS9K

literal 0
HcmV?d00001

diff --git a/ui/app/images/favicons/favicon-196x196.png b/ui/app/images/favicons/favicon-196x196.png
new file mode 100755
index 0000000000000000000000000000000000000000..fb3cc19876b53a0941950890a3ed6f06cbb75723
GIT binary patch
literal 37805
zcmXt9Q*<NT7Eax%ZQI7w#?)@7wr$(CZQGpMn%ZuswsrGA+=nD<<sn(wIp6-U_lZ!D
zlYoc8fdK#j@V_KQm4L59|2?1~fzN+RW32!HBET<EAr<%R<{po99SIl4w<^|0F230<
z%U@eH1?*Z)P~(j;Hfzv`ShzP3wxA$RcDuUSX?rYO3$nrlhm$A4@o`yP{Xc#L06;*A
zTTO7~Sz1jdla7B|J{GIRm6fqBy&I`7X;wY)Z`s&xe=TyqU+4^KRxQ8Pv{YJN7a{o!
zO__~nr*)s}uej$VKIf#xRGzOy6b>?WDd2Crb==*z^q(`Fm7ktTu~qA>z~v(gLivxR
z(rc}&Z~8nt*0{7ORbmKI`b(Mjz)1}Q1g+o!3Q`@d&CB~d{s#A)hWw0xe}1pe-#bp4
zX(LlD1@lFtkQB3dc{<=7u;T}p(c|BFquy*{r-z0fnd)&Wq7Z%k>27>d9Ytt!b?UX%
zevFax-&sO85I0S}B&zCZ;p9mcfYU3UD|5TGUK><@{FEA-tg19dD>a1{f7?YVRoWV5
z1sH#EB2$}hA!>9gegG8&)}TK#xD{HVjQwEBid0JS@^3*|^M4H&!`ls~1^sP+Y;gPC
zRnj=^^zPLx`lI`%j@#SKSt``N55Ey+y*z)s@7Iy9OI<xQKAQbdJ*;rGLn;UcGeKXk
zk8NR}WYTTBjT3_gf|6`AT99y67w4hWEk`FP|4Z8I4l}2vL~<U0wYdKabJ>mB?@2u3
zL&TJ}P*fdVtIG?i=>^0prqY7#bb^0=k5kWme$aoadgS?CEGz5mn01E;qL`z<t>c&p
zR~bYXgtvW!ilP!PX7?*6uqDxy6-8e!lh318q6(?c-h@LLV$Vz_QO3{CmM2<UXJWoD
z54=z^rgBnhYG?~o_}DB9iuXbNLqq>gXq!I2QY+tlS2=BW-DCNmZ!@CeH37s+p`gNG
zSXl)!2yi_2Z}h&F8oW6+(k?G^V&e}s_)bO*Yy0r=wPehDHMX?k`2~zK8Lv)a?!?{K
zUg?^$DKi+m-)4D_#Tt*io=Y=1Y`jMk`MkDOm$rLxHSGeGQhFUN%&9cQT99R^uG&I+
zCNkF|twO|PkcpF^yEKY$c1N&vmWv?PL#@dHC#8^(x#xaY9c6XhE-zk~&)0-e@v|GZ
zwNa`U!)N1$7B92h*+O*7^fPXBsr^*Oy3zg^jv-Msq;Hnn-5ox|TW)q|?FO@aw~>)u
zhU218`ATw^*q~u9ba?ye{&_0uR;cI|3c+ZnW}r6kBt?$mkQT|l0>0+~KZsNaMvBa1
z0vXUoBAuLOANk%l`?NjZPV-`OxR-eNn08O_6-Nz)lZR>Ug*(JLe2>BIU!56IK01Ux
z=ooAYjF^d2<&8VsZ_I=;<~(?F<Z67cy|i$b>%J8xTWj3Z7ME;7#d~6Ab2=RkpW#JV
zT`<x*P`cpOy-S8Na3wnC#xP(|tS}I<A)fg}(jjd!p>b8Yj21L8(d>;M4#!VC^W5+1
z<a|zeMx7htX^&v-DC0Dye26rEUp@}|uNyipy~5EoP7hNoeKjbYd@<)S|LIbXMHXGm
zsblmNXuVk0s#0cW_u}w7^ZW89(Q$xcvuxQnhzeB745*50MK*}yYVjo0W(VOb&y2YS
z)2Fbq4>g!HH;VnLPRwUs>|s@qYh`P`5lyM56}bG-dy;?qcdkI4kn8@Fkazig2(<_K
zE|)QPlw@Mot$S<ElGy|U{Fw?-kpY_?^PW*Hp=g4^*^Zdvm``3sZN##ZJFD&Mj&Vn~
z&2mWs_4L8D#>FRjfGfv7N&E;!Te8Gi3NB&{`A5qRg`jf1zV5j0$!A1;_(IL^9U(DS
ztz*h{cR`qgW;edZ%e8@v&5GNFGQXSkw7w6wq!UJMDjE5c`g(*LhiLE$mJ^Mk&tY*`
z*p$2#B6kz%7hz)gj`Jgw6GxW-^H9t|_u~50ZD%8&m0lmhv-Z8vZ<v2uB!-wxEZb=C
z&@Lw0GglJR^>2G<cC+&CKJrK|!Eg(c+`O<1Nm3G=eDc05h|~c4g6lQ2K2G1`sh#Zi
z`M6k_$45+zwV~NWtiGCC-z=N7%UPUYzGGOEV`+N~DQ{tXiR^b1jD^&n`{?KmBk;KE
zZ6AMwt}Ap~FZxBfn^0h=y#%tOXS$q`q`;0BxC0uIKRu}1CB{F(tizTTZMVzmViG0@
z`B?E@;Rz6-rQoJxW54R3E6RG`j@7?safdrPLg0)V4nABH{Ca)Al!YmX)~Q}@o80|h
zQT`1dq8y!dywh*AQL1gZ?R-kxb>1dPRagPYj&sQN!<I*Wi4r*+qH9g7w^E_SmE*fg
zrAE)mpmkGh$5Q5h^;@R=mbj%%Ye{UbKg`iw!1VOHo7&0yx^nxzxT~srq8FSNE@;qm
z<-cai`x0wuFh98C1E+NC6?G>D{doKE>fpz)9IaCa^_P*BeyrX39^k=Qu6eg9S#<4^
z4=1!Og}f2DsrOA@`pM`O3Q2ynE7WZsZr7&)U1PFCT+V2>WwJq~d}Z@H<x;oH>1e({
zx}<mBXq15eHpcHu?OIv>ab{s^L+tZ4@o6|%8MX!9-IFg*NYtfKVgE8M!qSO(+pNG!
za%p*_^Sax~<iw`!)6++OR!5;T!31KD9h^0{IiGGXy;Q@-gFg9ZGxW)p*=c}?bD5|V
z1gm7N9Y&-Wb<?=W$FN<3{j4(MVf=?|aNt<Ecc^?!hIHWaZf}*DX^GVEzO)DwqVMgE
z-uE<Xkwlzn53yGlu?&};e%$L-Pmai9n^L;`{0Wc5P|vGyy<=!&JaR-YE~mBm<|mZi
zn`mdjo)F*?fQ2Hx?7aBfTn|}TYAD63fUJ3wF40fc6(gA3pJVH#Ib?4$lp|SOs|)To
zVA6*qdS!-R?1|?aITn<jeHr$A^WxvCK;BE4-A8}Mwa>MNfvG9~kZ%{)p*Oc$?Uc7o
z*u)UF`qKhqu^_3@<ZFy&UG3-MeRdKe!jAIxCziibWoxVBi3s9W{nd%zRn_UpNFJ1P
z4nB6trk{O5q>y9DKh1dmI}q>=U;dB^Xp4@(J8UYg8JfiO6qdc@sw!+B9HDj-v_#T2
zEn}yv0JO}}*V0ExyMh!J-SKAPLx3REBU(9wo&p+n$Vw|}Lsu={R;dhc!npR5>-3V_
zlCuj&BPL^RCO&pX6qYg(?}#>{&1?Ef(Wgqh=h1oX-Bo~29H<Zc+`y*cJ%}jV@d~wB
zKor;WM$={f{nN(ZocE_s-;E`8KP)NswBg2ZQI2k>MVh)Ov2JmV)qbZSh4c`8=C}g7
zKPe)pzYq$7T1m>3sTo+=>_tc*!4jjN15J^0&G2g7#w+s!q>>8~#)BtChWtSOfQy&^
z7NCLJZAkNde&+YuYZ#5ycQ8ouqkH-?G^03K;?t{}=*S8g$flz3cy-*tl!`WF*U4#!
z<>TCJ-wS~9<;j(~3J|8dD8+OTttkhoFRw#tL9xDSuk^(g)By9C!ynMXcp9r%%op$A
zs6bl^d1rVJDc6z{Uw5y$VOSqKG!C#bPB-XfkL(cMnYuY*<o`aE|NcCDh5bzjSNYYj
zdg$38sO9>^f^eGnQ6J{_Onz;p4%f>u=MmvE((UyjAFQM*ooej*-B0LUe81d-IEr#R
z&4xObvKUI`Sg9bsErbuj$|@R9Wn^&_SV(li^zS0k;+U(s)gW=F0Mu+pUA&6S_oYaf
z<UTqf#bFP{eMdXm*Uwp@yC8Ul?A`3B<xyCBsfIIHJ@3sm)T&#bj-c+>(&FadPA4-h
z6Rq=t$-3UmkY&Y*v#vA8l}FGO%mp<pY!Lh~Ht?$ER)512ay71F9f=`6cbAX(eQ}a#
z`cxSpOgo*1V`u%Y;;d5Xy`W)SgusS^reVW{lWY^m|3sH6TTb>GYIC(H`Tun_%5!9H
z%c<Gtg3#ahL-;|A^rWB*I5+Ih91W{7gi~uezVMlC`sEHIj9bVx02{#%ZSL&^QOpef
zpwM0}Y{HhWN}{UQS9DrgWm|W8);;(Aac|~a!M4LK+VK&ncOZzPTDHkI<1j|_B724H
zZE_S7v~|z36mPk&Wjt;b_FS}o>g+ffgm|_2atqa)T3Ndd%WR1e&<$cJE@V`*$sQ2I
zk#Pt)95X=`2TNWp;gCy=A{v4KLw01gTz*j<XDmn1N?O%l+uiS0B4cR#8oWUS?HYsI
zpaGY?LPdXVfJiDCY%O2=cQC1oSfXONGlllK^z5vZawdl-an=+TnwDingh(@^qgE_s
z?``T@LQJ$4-xkStP%ZnbI^OT<z?duT5Ovz*IC}pqjNt7hlIQwGnX09A^GS|lWD#kD
zh;no;lmJ8Nx5m*Qb*~ueek670glJNksC^95Ze*RNNPJNflRF~xvt;XWpMc#oJcZ^8
z>i%TLLVJ9xv9HRO_G=!d>s+;j4^{SRtv0tupJxU_9)~;1wJ1y{=ySb}c&PXhr7Q2=
zxpM1V11D$#mRI!G&vJPN!ySk_SDzqc<@(9z?RC%3wBCo;V|p!LEowF{>h}UjyC2@1
zl*-D?o<b%(V1w7nXvNxEPrY`^EEQ^Z6oOI*MPx+_p*jp7D6F!A<^o}?+O2?*PKA$N
zTE;SmU#!?`)r9=Y7%p<@#)H3R?S~>scdPO?TPD{-W2@Y~?-RGW>T-dK+iHJm%~zDL
z*Vi$m6a+f&oy#V<;8h$ms!7hB_{#Lc?aJ5t>9g~QS7;F~#d4>o>gvA|I(Al^_EDGo
z<<}ex`FUqQo~vZv;Ac#gkJO_{I~o4=<s-j#1V4+!W%(urQ!2=t;ebBCKiG2FAYopd
zoqaI`LJ4)zdo2ep=-*ldt*-!rL}e(cgk&((O-oq5*|AKMD^+9N^>$WO#m%kTb9bBt
zHr&Bg)vb80#ml`HhWIxdRJTl<!QeWjTIi)okX%&jueXU0Z<u->>shqb+B9cf#}#bf
zbBt)^J^~e)s2h#&i!}t-9Q6T+^?gCurw!E+y`h6Xq=aP^weDIy1Xt&a4ALqTque<{
zqz6K<BZ`Kcur9T>#%*tl2_;kHzp!ZDPH(EiT*VtC5b@;$kH&Bs+Ds%Z%fP5xW6NKI
zoh{c^eOH}HL5#ibG<nk)#4h3IDk^su@)xW3RD5)4`Dy+{#`^^QZW66bZOv4m?Gh0z
z(7Ma;gMYJZH#-kl^IoM$k~-!C4PRdMeZeKo4wO&?$g_(#wfnJ=rMiZcad(RY$R!sd
zk8tWOEoV*zB$70==7O6kBmp&o(hw0dHfy1RrNtcM@ayxbFT0t0BGl>BM$@Jvg=m_v
zVEF-2`^4Qbe2u?tPZ?yAlAvOt{P6r`IvZ|7m+?0w7_WA|#i`ToDcuW&bIXH0i0yW9
z)8;&~L;%4binUM|o+?GHzEiYSt9dsp(yrIrt?$x$A9B@&hO|(^j^C}==;EYbIUxDU
zR;-$~AnOQp8w1s7Lsdqbq{RsRF`%MXVl2-cN)1lTJcH&gQe<#3IaX?ED-MH|WOb2?
zi&@gJR~DpD5WQ*g%S%%tj`C&Dj>0zg1<v3&ne04fYNX2W8>aUCHLxJ;r=cS}>$N?{
z`@2z$_|s-h9-_0{!`g%13dL8c_cZ*Popbomr8=)-`$TwM0VzlL4kC9Tqlk5A0J^Tn
z<#RXRFDE|&Y1L|{_Os+*yT~Zl>Eh^*T#f<;3%pC##^))0Djc}1ct=KL4vxXxRGW2>
zHps(rHd4Z7T>O^!{ETmh^6|H3=SHS6dosu1v9N?{5GGPGhEuZcAI#m<iq@y~KD3!V
zPCgsHbous`KNb9MjsLL{@T6K;b{3dyv_|%x<a$*wu^JJoKcZT^kD?P^WaEa_)%CVH
zT)zBj>ANDT4s#he{};|t2u%y3@L!$1r|mwENyjTEWDS>xUC&Sk^2f{Z(_QOdEX&1~
z$~o1;U7)VxBYqNA@A?s(X$-qHaSMTglG)Jq5>st=n??@4A41x&|Ca7(w<YgD8GfzI
zQQfwGpfWk+Ei}x{EG7nk0oY&{1P!vaLDG83o84e_1)7OjlWZ+Jdp$OmwZHG75Lk*7
zF5=Ep_&zd}1dQ+c!g#~jp#^DJ+IWYrUVpK5vt(<?5dr?0v~7ESviCh^#gY9zb+L^^
z^~YlF?U#j)?<6C>^ByFsG2BX%ertY0`)dZpkli@5b&M<5|M8OTW?~Tpqp*{@<lo9b
zWaz6))pLim`1iO~S+t(=O<jB*dm~T=V;w+dmzMX7G#n>PkbiUVw;lF8F+2yUGIE~l
z1vIqb>2WFUhU?WL7-R2?GAh5rtbWGL3W0YC)IjJ!$e$mmO)}jq5<a$YH?>w{Kwgo*
z(rEO0Zq3R2-pr${s^s88bGsQYJ{F<%QwZs=akn3B?l*HRb|7Aa9G;pG6_Iki^dQ3K
z7izVT)21ReH?gU=L5g)nRD-7KhKhU140)8Q<;BL<e>NLOca^RJCthGr3Sw7+;*OQK
zO^?iE^0}Q3JUr#Kcd`jFlH8-t{-;8>wd$;T-&zCKBhUL<nr1F>1oLz=`4Xz+S{fN9
zv+43ucnJ9?EZz&w4`et*59mr9?yneqZo7a6-et}@bd03NwN3*KOkeLB1tN^3*|DJo
zy;2oPUBh<92^t0&h6`+u%5);~oYz|^8ZirOH8Qg0vV1>s7-KQrr2S<x(E>eY#f?;4
zcStHV8xsWjefJ^&)9JYyjvk-Gk7<gVTwzF=3GVBsf`(Yi>T10JI=i^gyi94u=?r<7
z>my?C%f12Q{4v^lC*^WyH_H)5{P1yayyR3rdM+*ZGf6kR98&6*_x%}u-s_b5e#K%d
z6ODpAgCZo}e(>CgaABE>;ZTQgCbE;%sdk6rwmunF_!{bRHLG~<`V>Y*dKgk<-9I0R
zp*->&_Y`X=wj>s(#S-Fu54bH-oaR=KB%}(o7|0j!P;`BJc`x32j-NHw4M{D4HuUV6
zQDI&Mo?bi<Ktp8cNR^hGwZPi@VbW-nlanH`x5@xsOa5p-?hS8DpUdF(?)D!}qyidf
zyX$%r=l3femldDA=P&+*@lBF}qPag>DhhI-EFH&Ec2Jp!y(ftoiF4IR%AQfW7k<O1
zq^ptb7;HoH@pFo(cD3BYBMh%?#4)s0l0w#ETHE)*U&SKfkkex+BuB9c@wlR}qqIC6
z6D_l+{u$z`wb9fN=AbyVgL9%0#3W1r@*7z|7~AGqWN7GyQcKJ1lfd@}c|A>h=L9;w
zNv*_XIv_m^@UF7W{#CZhMbg{F0u%?DevcxEp9UnV4vc8Y-`mQxaHD;SY%65_t-Be^
zMHl*>5$veFjY&Jl+{AINU^W|Qa!{JJQ0*C5=^^ZzcyJJB-bn>VQB2BIv>JX-4RUQK
zVUN;QY}*Ch@^X=%m0XN!QhStmFM)WgtM)&et=MOp0zo2+B9M!c$z+v({;O>mhqxTc
zy5=aoRh2TSOr!5|_00b+iC{HjWRCUu1n<H?2N6511HDJeek=#)scdkp3Wo9T{gT#u
zJ91WDV6^%NF45`lP*pDzs!f{{7*w;!5@I-@>^)R%hUC({GVG5XXp%`<PTL<n8Yagd
zev_omL2E+Fw#WQ$*8oz&S@~D(Pp`)p;SSVJ8}TM5v2OdTA-uF>81p1w3mvpxg|Jv(
zjE&XaEiCipz?*oL**haX9l=&?p=t0kcEfRFs}1&*>g=CR$D=?!Rz_Te>s8x*u4wo?
zn<Hco8{uiaXy-3q652XHvT*vcgvj@>2b5sF<;fH6?eWt}s{w&!lAv4K;d{N%waH?9
z*9y6JgWp%bh|aW;4Au|XR@+Rdyk=u~na8X<WxnSTx7$<cI9}9-fNm`9H*=izN_Mzu
z#|c6Q{?oLRY5<>SYAw<9G*%53ru<Dnbu*MN9Q4msst^sDrJjr9tTcJu_M5|@HK!)%
z^K!z+8&b>Rjim@rf<P_YHnuCF_C;-@24j}iqkbs2>h}AY?;<o!?RL;}h;Gf}LYHB0
zRn6OPXm4ojOK)CW?G8jJ+jG#z(cg()aoXYg7R+m)OUlbJxNjFemf~_5cOo-_p;$;;
z61DbTQm1{KG}^=iNZ>a&IUtV1Ja-C_3FA;IXfTfi<I?7vySx=lq4u0K7*RFT&8-M}
z?ho@p_q-mM;{hv%hxbU4pJJEnCnA$Q5j901LqN~c<a7W=_%2P=GEQ9xh9tJBDdy7P
zbE8AVJc&Q11-@cYyM6d$ceNCti;)Q#NX`E8tu3U@Y->+Y%uITdFxBbXsxJC;8tJI=
z7(Z9rEAc6ebkhG<khYuH*S#rQtqtpVBm%`;9_LP*?fSR+P{D7XGN@|4hKz;Q%ag=f
zTqsfiQk}KU*6$wgwcB2^TrT3$`oa}#x_YNiHC?Wo5H118gOJZt`g%_o|60vPvZjOk
zymzI>&Nl?AAvBU)q527YZMKQg&?rX!02_K`wY?yK>QtB3U<1|Vgt<fB8;f!<2}fJJ
z4T{z(uYYukLTU}4U`Gu?u>bPoeN^x8t&^CNE4O|@QuC|_9`dz0u|#frQuYz5o%Z$&
zmUmn!G7fH{fkG|@G2it>9SB7NN9hP(1_U~6@<34ft!lpykIyA;6C};KTJ0vbe2FiU
z^UZF0#YLUKP5qy<I>M?|Qj8W!MMJ+Y<ok(^w=DkGi1*6%4T0)psZ|EyaUx|?=9~Px
z%=uIJ98{IL^t;Ev2^zJqg+gRzziUoG+>47<luvtIqTrW_7GnZ42+9fMLI}lHJ0!gU
z*Kq!4=<4tldiZEpf<jHMbYE|y-MaN;SOkL8MjkLcf;hV9s8Yr4!m<x6J8?V&@M;38
z@gmCJCF!S&*U!w_8Bb**DZ3&9?3l$*tZsUY>iW75MTsAR){mdpI|~k<k9}a^h%cf)
zSOxv4ojIY`aTs%8p`cxNe4jU1R`^iK0<=s_gBbb1&j+pI;?lZj#|>>X$xvmG45hY7
zf=#a5UB?WKvyhMY;%G%L(#is<b}WYq=w<E7VqKfx&xIn#qoR~09#B(5#BJ19d{(~q
z2z~L2o7C2d{%rec2dp4V5#IBkbY0<`cYn4ns^+~M){QDxq@*G%F@?hIu2^`gScMCz
zT=*HTV+w0<70#l6a{2E)_Di-Bhryv*TjQhs$iOvHjS#|A&X^fn!$24J$9ODv@!|t-
zuO`?FKitV%$AGq;tQXh8n%D?nRGtJYqK<@OAoa=#iOq&u4$fbB>d#5z%=<$EQ_MO|
zpLf;$`7{m9*h=plE?K5MHUxX;IIvZ0X@&Y<b`$4L(~<VdC0(Px{G8G3X>oP#_*~-9
zjyD*phnFGdZVVau+@HjTNuHptSa3@=OOipHX1CEMek9B+ACa@?M5-7`%|MT|Uc31g
zQ?i7UYdBtR7=HeCuvZK(Y~f8uuWhQ-n`*OG3hyzP1Q!j3@psktNF!|UR|$z=Ku9w$
z92~CBoE&e8b<c5|?|t04muKd5jH9?BjS~S_U>e*DqT;IV1$&77W(kNsFd?(i@*K<+
z0Cfg~PxLm9M@sG4RIm!3Q{%;;(e#(42yqZRMpAehXDYf8haJ3s;cd8ob5LL1Xv(;A
z*f?GoL_@5)=@1;D`kKsXiXYcrf&8t*Q!9JrarnUgoTAUhL-b=FhK1t=5$4rotSWv*
zq&@oQiOpZuJzLq(Jxc}ASj3eoqR+p@HGdj`T$&Josq0>#LS^4`B(XS<v*5JTvzlJ1
zy}u`10!)}KwOVaH@c}u$DD(qfmk(Stc4U9_`<0M*JSG2tBiO>xfffHo6}HC4(;7Zx
zVG4n-)FLH%De3(I0rHfWA6M$N2e;WkBg_>%Qxva0H+?unsJz4*3-G{wzDY)eS<cTG
z-A{ruG_BQ+H3AGzqlqc#ToIA(`CwBS=BilLpGYKc@Sra)1)7oG4*_l8TT05c$E=!Y
zzQ8*{3qS|PN9c8pTv2WKpkZdi?p+Y*&hX)E`F=K@1gBpV@+`PQhHz2G{sG_54G11o
zUGBqZyhGK)^aKE&sj8vB$!TJ%>S6w@{+KPDx0RRcWc38yyyIokL_g^#rYh=JmV$xm
zfb+3u(jPViV{m${r4*0d9rmO_#3FgQ8)Ti=8`^`Dr43Twt}bH7x|x##5q!@?^ts^#
zj%?~e7O!6^LN^r|5{^TBiiBoApE>J%ci#Eo^Z$0r?1Ac|;geiY^fO}$LyO=4o2g($
zv)?l*&bsxApAgctXo;|5wd;<?J!oRLRblU%Zjs`s3pu&v%~MxP{KrP9)_R1Zd*`0$
z`q$3Ro2_UPm$Q&|y=v|#Ux4FOB%;%~dih8qI%5%RyDlZoeswvE=j$c8+O<)Nldaq9
zV3e>O;$FUg-HCbOkoH~p7c>h!{prkx?K`jkQYalVr4|P@Mf4pU-rYY|HU`~&bk$HV
zj0trh>-$)K6EN-%7Qp*<qZ<gBHAA5(cO84JRV+06|8hBv+|l!BhMylr?}d|EK(oNs
zBpvuUe8|{M1M5<_p3gt{IT*QdN97+NEaGLm9^G=a`MNP_+v`z6t$}d!YODxH5w<%j
z>?Leyv!dP9Q(Jc86KfxZ)+sZD<}%~blHF}{e$`v3v9m<0oH2T48kY=rY|<_i5gX_Q
zw}3L0(Rg`-C2sXaES`dgDB+6D58c>}>M(n4mfJhHQ1bW3+e3eu@;gCgbYtXof1aHH
zw-iA(>vG#5&US-2?HR#Nl$eQO!)hrz;m4manS%1{{yu`vj&h@SGyYE=|Eqd5nu6ci
zcjdzb7%U!5L?%+1@yYQxhWQgjq!OYVDPG$eO`SwyCk81|>Rcoaqz&k3UN&S!^W<ey
zfNuR6#H;3I+YlZyE)K1OC)<Wi*;*X0ZP;S#T4+pE*wMq}hG5R&+IcwS?-}DuskbK6
zRxt>HDYZg4J+Fk5ud)&`E`sbU^8W@M&XZ4<%hIbx+hWJ=8Cm{qLNvOH$Qut4dYdcW
zOR9OQQo|xnGKo*u|KA1J*^Lrx9vy8MD7_23)@P>Pp*x|8M_Ik&D0hC$@J<#GgMQV?
z3iHfPWw|0T<;zYK^azp?uaL$GxnMJW3uE?upbORWg*}j%)j#tljCAS{48Q%U!YfyR
zk+tMdoOS&`Cv0EGmL_803Hds1aY)fPCTpCKmo4nzi80)PC-o{UXvB-m>?HERnBE=9
z5|DN%NC`?j3Z`YyYJzr|icXw_MW?(CM$alebR$0BPTO0g(dC7(yV~B~BM%~vF70|5
ziHPrgRIx^@ei1h*!AELPmxiK<N!mM#1Dtng-v=P_mM2R=fd9PW1<4W})luB{bJKG$
zrE6ynF_?xmYEoBu5X2(U#x|$--DNV*?r?C;aTX53_;T-a*3F(Y+NESP`uB%e29GC7
zsTc4qxvW}bpp2MVw-sG_i5p)ogBoS}K%Upn%<2w7T1PlI)X<cUjWu$S!hA?ss=y+S
zF{?uKTRB9<2c8D!T(P4WU3Ck;T(1wNB9xmFtk+jCl!Pz*TK`8r7M2F~I%p=xb4U9Y
z2wYl2@HY`Rd7a>(jYLK`iM8s?z4>)+k38-DMdvBMs=AxrvyL18-8x~;PjlPpwqgLf
z1L@uByPKbvA8^z}3izAK_w^>>bz|2bB&1KwBLY(OM|*X5FVK)>2|+ASSa-Du`^@|c
z5>XZmy#VfEGcdNB5rN`1Lixnu30Gj`pB81o{l_!^N64^$syj`{L`jXtYeAPnp9T9q
zI(2+vrYCvKX|K=&pDQ2@u{(5A6r)oC?h(Jz%ssp$QBuW3VXFtt#;di+RTlH_<#hP)
zfi9oe2~mbPW1(1d`So~6_(zC>e6Gpi#WOsV5{oq~q-KI#@YStp#pl}myr1V8rr&Lm
zvd?D+bmMR*t{;5N=faIHZ~a3lt}^Xa=efM$_@QMUvsJ&^N$?}i;cgrj4F!O|O=b@{
zYwt;y>H@rcjM^y<xx6s!BJ%BcMsKLC07Q+h`foII$i*u^-uoFRlkXv$bHk8!-$Sq*
zsHRYw)L4w1;Y-TkSe%(+p98vKM6l4R{}U|~;=z!fH>|p@FYIszSH1>Gr)WFK3S|yh
zr-rbBDFQ248uQ1U7M925PsgHza?R~nQ40KrgY`zQwD#=edm5ID!+cD9-`4_c@^%($
ziUVcc6>#eS{&{z9eFK6G4;X?k7!OIDgVU+IfvE?1hQ7Bmv0%M4QQ1HO;uKGr5a+^1
zme$*VxGlXl$0bVkcomucpD?t3bM8)uS|DOmfAie~ogm2)sN-ezsRkUl`_ucI;wHI-
zHn`ca0^Up0AnX_6laQc!1agPx1zsg&ayxfBA4BXm=Bvpubq`_Fd0jw^!sH7)hgpix
z&hhkn?>YnqHgBk4=Z}=F=aTi9(vb#Q4GNY8iFrb9jm+lTz99}r%M?1AAtEZJ_HsO6
z#IA=;c-!SM3g6^u?yz<c+OY5AFPV1Hd^DJ85K=dFQ$A1lGvNDYQ0}rv%+qUfY_}W5
z^t?ZADIHN!mrJz9Lv&rObwV$7yWOiBdunVq>b}mdE%kkh%Zw-f?HkUNgw+@1+3s%-
zuoQ=9<U=0;`gf@#w)Ji9=U|efZ=DjtE%K8Y^O^X9Dx!kMaxaJf;ZnxqX8A{sBFz>T
z7&24AM|b<;Vfx)9AMkJoz=s*iWx&ZhrAZ|4x&3Id>Wr_h3RQwxYf5ACv6w?>NP>;X
zaBmei<g3r-jo%AnKx1~e<E4<x77<g%XR(nDrKqaM>C_OtkxV1`5Y}K$!MEdh$fod<
z5zd03|8gME=G$kb@iwXf=M~}cL3+)_Mzy+$UY`-|+z<Pl6%Y`dIPr9~Kko|__t-Jg
zd4JN`@V#v5D?mfxHq4h~sdf{S&xx=n2UW~z17QXKvh>U%;t2;du|}A)Ws?15(3g%A
zTUROwpXZD{_~_$}T=>2Ld-&RrXL^|u()M_ShRpMU2%04b4it8AgEAZ^GldFce%T~G
zx%??mNQiL;E=C;;O$IWhi#_-<&kAfjG?Kk_XZ_AQNTrPMp{9qMED^B3o1sNeRk4fD
ztQ4|y(Q`xEnB7e91{wQ8j9thpJGr%O6ZjUQV0X6SGWre5HRzb;(sOF&XJBt`q7gev
zqJ-z5NkblIrs^-#0}rT`9Vu6!b3l&L7>ZGuyOyw>YSGY~O)3=TPJCYm{WxPp`Q>oT
zIBQDUNmcdoHs7QXeTlbL+u5<w%eRUEoMKe~vY(+WhOPsJ!9{CWV0b|v5`y}KKj01V
z%dlDzEoRYRe$RJNt1B1A=Ztjty&`6RjuIN)EkdA~nT9Z`DNr5VVF~ymjGxgg)|`qr
zmck^JG3vYCL?#uqK7_*M)+Q8c#393J`|?Izbnq|M=ma=Bky@&|8D8929F9^3wF(so
z-kc0e01VN8S%0L&<==1j{CBu6juiKVno}^*oD0H%U`VjA6IVS!p(<gzS(I+S*&1bj
z8~Fv-_W(J9m=`KV7GGH<R84Yfu08<DmV}BGm(3e`16iId(WQ!YCu2-^sMyg<E&25$
z+SptC#5fqHVtqaIqNKNsVkQ?qu<ZQFE88#Nnb!rlCZeUb>2hKQviN4ZMiQ{nSCkZ=
zSdb$^kCMJWw!h9|(vvr;^x-RdCNfZVcZiQR{HFv(?rW>B@Ou74F>{(#1j!yN8zU;6
zcOmL2tM0#I%;AvM;lmEVJ%!%H6A71(FegO&*&5?5e5TEJn&Bq0tBy5u9!$_mC`=sT
zYdS7GonRiE!Z>fWVWwP8`zvAbzo_NcsfYl?sr3Y(gavTgs>Lc>aUv?=-k!hFfbekO
z2+R1I#QHkL9n0+s)}V=~Ji0{YJ{^8hJcqjxCSgF~_rBoQTS|@K6U61P>D}LVnji#c
zQr^M9+8-CSsjPk4AO3vTn=46_hLz#G+N%Ai*A*UJI30@7`#R8zB}aJ=7nBY*G$K84
zWezG%4)K@|P%%UAJjT$Yiz8v&B|Q)iUvCNrrWWJ{-1$~O#?Jm6i37QRLU}#NOV!0W
zRALA-RwX}Mt`RJ)!A{e2hX-nrkycYUhX<!2>GzfuS<a@QL8|E^#XbXc8XiqR36tv~
zo5G!TUkc{EZ;3ZZiu8uU#zKe&No>MOTmci8&6`2w#Geu-E_fZ90*7-=Abgly8VHp!
z-+#?$8ky>2sUr}GKW&m1Yh}e()-mU%KD28?PxG;k2QCMJI(R$=QyyMo3mSQfzEqH{
zuG#+%9<4?|s?uyUKK&!jD8Rz{Q$uhF*Yv|@zxkXoLx%G2=`&MNh$`=7e$mD+s937I
z`f3oHQBh^-C!9kxI-Mk3Y&<?q5}3Yzie__5b*O9033=oB=YRKt6=d-eQK34ExF56@
z|24(eaq6Ke7W4H6kmY*|R7lA3Uw88X?NjXVU1d_Zp)Hq#+0U1LAf#cjAW{b7H7f<a
z2bPwjp#cxv{BEjN`iD!TbDE?J%fV+?C39+!6wZy_ma?Yo51Uo#xCCIy!jmpqNOk4*
zV|J5hCwJ}MyX<(M6D!OQAH>Np5c@N*Kh1Fk!sWfT9Q6BRjlcpTp4Qol#ySh1a^SS<
z4JTjMMK3dF;rX6-{NN{e6){_=Fv0xs^FA+h{B<w+_EDU1HTCy`0}B%2;iDy2d6Kgw
zUxJ{bEpV`5da%p~kC0m}FeOl69Fzi);DBua<A8Fe!HXcXA#af64Q(VYPYn2PPyy(>
zT8VWtm~HCk;OyTM%C))x7Ur(uCTG}#G;*{1hdVx)tYCwZ%PK~XVb?;1orw_qL$I$S
z`L<8mgrzgjLgc9Co1HVn?Xa!du_6UB#5_R(Wr)JmA#X8NiXFvkAlR1|@MF1W_<!c>
zyz$MxP9>;h<bGh!dnVp4*1{)N(L+6*&gphrhK<A!PT-^;XT4Nc{H|f%9Tu94jZzi5
z|Gm_3n3QsPnNkgVf>r3+m72+EC)Z}Z@upjg?b;e93=?oVgMUBB-<6-Uzorm87eor+
zV=w6!Pr*SZNVNzntRfS8SM9uS7%ZDUYt++K=9>?{WqSn;Md*eElwX(&ZE^RSO^sBo
z=T}2OLt;rq2$3+*72r4x8nwR!l>vdTu+#!Bz2m{RQNVb9*Lt7yTPC*$9ALh>c<|3P
z_b(0^W)i6Q4sXE6A)3-7d%0F$WD(R7`$TP&nD*PVnf(Xj7eq(~Hug0u*Z8U9l-F3<
zcDtMcnA&ZP!TpmDa0kuW2`cxQ2JBc0<dKhW<6ON?HzxeVhlCJGYH7K)s=TU;f+*Yz
z^rtAKw<_s*8`dxVnX|xQ7ny(Eq0)^Vf*D}*)wMs_VC(Tn#;#E*X99$IuTsWf6-N`V
z=T~A4Y@I>JGijQ2`{2WWaoSiMo10(XJF<mW=LXaT<aI{_Ym%QlkhtMm&}kK+KYyeu
z<00Jv+GyrgAWg2qwge<3(l=r?lkbHzNM;uYfD|>`^``j%F1@>cEea6-X^40O5q)0>
zcc{vxHuT0bdMrdi_-Z2_cC+pped|b43rE3satM)dm{*(pr2XrEk9*mjOFGlGofl%D
z1sL!>1)%|kS%e>p1c03SJt*_aWTXsg90ysJW;{^)SsHHoWo=QmiB<%mtU-9I@EI&L
z4GjpGU(JbuVDGg7z`iP4tn4dx=tzqRS;5T79Z+zh7s8M-*J{R7$-_fN<^DMC(xi|?
zhQ{5z4D4a{UmJ0xoXjE4(xj<<@20ET{y*=~;Bb^N--3GNnL{#DCMyUL20|e>lzd5|
zB9i(my?}gHoP{e24JMh~Ho^ZeMf>wMZAaLa1ouytvLT1<_7o~16z;%Hv#dBN!SoYO
zlRf^B_(1>5cHkSuPZ){-XX{fQ+c*8Cza?L!r3FyIfP582^=BcH5VrxSzY<7H<V|S5
zDbU}GuDzEuaHHH%P<w8A+Y6{6FVxmm`0{c_fNO(u!z9hiWAd^^D$p|?_?%j$$^TM%
zvm8T6LUX;)LoVP9$HBR;d(dxXGP{wysB!3PEoKqmu<ZZb9P&84fim<V1)I^Y*owP6
zD<Nw_=={bBVls4fhwDVUsHrr!wRh&pZUEOvz>dN5x(8?TcQ?UV+LHd!Oro$EO5dq6
zbQ5K_|KUd9wy|mRJA+okWLYj-n@_USIuP=UOhVyj@+6IP+-L1DAI%TWSl8|pB}wDI
zT3*}V{NKMLZluRsfoqlLD5|Pi1}Q@=)#M2mow$^)JMisYL%V-SnzAxej!D)ZVsA*`
zqLIgttbo)I=KCpsv;O@>1DWfMEJb}tSq4{0Re1o86|k<xsWHasu+Qu1_d(}e5uB={
z)vzDrmcCUbge!F`CdlIL=(gPw&fwDPfB)S{*fIZOh(_sO_lfDy0yQ+Xhk?3->$1$k
zKyu3iQ87_)D@>7uT)|JiDECfKc=Z~GxG{6|M}JH_#7-6AYec`m-cba>cgCG#Na&sN
z)jj*LL#x~Du;82Sm>NkM%o|}3bgDUhn)3W~gevF9yQAx0OUvTD9gL6w8UhKDq_rwE
zrCyFmbAM{CBFcK3E`|LD!c~BT5|2_Zasv*{KCfdk-YCF-tpGXu<@{RzY#$)i!D|{O
z0Ro7aXg2e>>1#(|>l;R~tqJ)0gkpMI{#EV{CvCSAbM+4Nz<fli#3(!y!BPXK8PY)E
z&V2JQ>Azh5dn-c4haP>!d0#GS5C5a!H<rB$d?(%X5wq(HS+Y|3?-t(p1bWKbcz69(
z*F7(J@Qq!FLe|oBN;3Sp`GYZ+JlQ>zfqTdGsZ5COaUbQwg!aXjBif(;MM+M|suE#7
zl-Bmh7sUB*xw-4;ZaY3%kSH>fvIlUM)q?bYv6Rt~q0}j)s|98CZkt6z6vWNJsqc`8
zDFA{7mXMU+PhD6ZkKw46)M;VMI2G%bRB0S*3M07K8}RP~$6@&@^^E^k)%ya*7ch~f
z$>&{mbgjQ)<n>RxYz0j%XjOP2(S<cyIZ#br<RUIiVx)lt*7N;E=lT7KJrxt(rRAFc
zI;F~+gy1C?8+#F=N5ZrSlyiCh45<oDov5d#e-Ufb*|a7CV1QnB_hIK75OUFcns~EH
z&AO*=kH3AEn9gOClSM@ye${@r;c2|-8Wn%8W#N_+6m$GZ<pS^TT7Rf%eKpC(=~nCg
zy!8z$*dvA#dCl85`2;D{5aw9iPMnO}{e#EpGR-U*maWaUL0dr3fg#Lk#}h3G^0!T2
z#xez)&5pkYNkG3D0*OE_yYsjOFKKZ&f6pa3^fLTNT()>+E#zq{MX}b|e7y&~X6;6F
z>UnEnYZ)#(ZCX)b2SJmFx&jT_u9`}JYYr>6#<q3Fz!cobHg`xw(#h7Ka5L(k+CwPR
zA1zfp^R5R7M5S{;b(4OD3!~BOLnADCb$PkVX|ofqB1`T_ii*YKxSmoVn^A4IP<BMj
z$q}Hz642>Fo3A2s80uOYe$DTH5b)HL(C^WuBea(UPbF-Hv+l{?1%2Lf@Mpwc^qGcs
zV*^pw{h?u{hDsEn;iI)D3$TR$Pk^`!Ldg(?iIzytVFDb?*_}BUQ>MX?*L7F-Pd>Zb
zX#5FKH|_oP<HZd|tnLGXGuhDtfTNltt<9HKerB%~T^P<EbPXgJhX?s@WXi9z4J-jy
zga%{0(_`_)8m)lX4L74<s3(KZvM<_9H(N&(rDD?yuX1UnWAFYWNdGdtR$sVsosAd`
z7La5%3OPMA8`KA?5lEdZ?iI7vTv|3;y*N=9lQGuzUJry3!@4g@-^g)g%yPIq7Iv2!
ziN+#E^em8AMf%>JAVER78YiRx3Pxhn66+%EtC1p=*4AEBYd+x*y6aRu&ztXx@~Ryn
zR#C?}(YvDRW~}5{Gjwo8qT$9BI^o2uqMA`MvNlGki#V9K+^fFm1HUKPL-A2QO|-}k
z-gUdp2xAv?m^BM+k0Yi(^S>R6k9nE7hbiGLD>Mcc*QBwy?V$%53B`frBkYP3lEH;$
zb{vnJBls<^D?Ss<`$a(T-7tBhn|srrS2G7-p^wqH?dMTY)C-DG#+-W}EE`8nD0233
zVgv`2DE*)*opZc2C99-iUJwYbxc@AKYj*95vth_zZAS-wY+knb`Be=a9eQCSTqqc%
z6rLpHMfT)4HTOLg8E2wiGjvXr!%&H(745z9nq3SY7Yl?SrM_WVEFbVjOKPf>Bq6Vy
zw~<qK<&BS%@;h<F-I=}KIC_v)8|c4Vi3&kE$zhbY=RW_8FXAyIN^?#Dj);mVu(4+L
zg32ba@pT-as}!M2xGNv?9XN6Ifux$5GT0yDiY63*LXRU>RgV!hfh_6%b=I==MgW~o
z0)q|;`sY}~+Kdtw#5f#+?Q%1`a>f;?oFDkUK<CXV9;jDX4PxJa=x^xW+$>D(GO^f9
z|6A>%)kvAe40LD?EnbV~Ix0poeuz0p=k-Bmuj0WMu${^mKA=pmKl<@OYQo?fWgqY)
z3^Ojc{ZzJp`{ph-3<=y)g3Yk(?BXD=qS?rC{W%F8hGYv6d7knCpyf$~Na651njgb_
zIw#v*+3!U;z2mTosL#D$Q>egzPUJTu$3h0$%u5wmdf-~BF}RTI^G>)C1n8)n%>35q
z7l}4Rb}B+m?`8Xs1^y*Q<YDU_{$S&wEN;rYi0=2mNK8-?yv($9?zwg?*MKv!%Ne+t
zv}0jPcn{Z3H##*vNCF;;Ys5Tp>O6_hktL0<tE_^3ha!>cUR>6!G^DNJH9Ur|U1~J5
zlj0Sy7<xpHi)88$E;d&TK)Bp;W(Q?k!=H)}$Pn%BT>8Ot^O|$qmAV~lpgUQpeX>Jk
z8$wHl4e5^8nL)nS#d@VnZ4w_k_Rn$Q5o@F>%=oKC))J{7<3G*tFOg%GeG1v97T=`T
zDw>cl2>4UTXco-ZT2dk;`!}3T=HhQ>t{k{lF>f6`vLH1!E>gvK)fK{yCWV9&Apf#a
z`N*>`8$3!}i&geQzFx4+_+9^4f0G?*cUAp|!?S`DG}|3`TVz(yB7U-UE%?q;8!9z)
zgau187|=gvHOjQbL*=1}cBOz-DrP)GhzqdxH-t~XMbcn17$of~N;hY5%h(?*Vaz-a
zRceUEwOdcEuJ|=*y+uV%!`iTn&r|nzqSuguP8lBsL@Ov9I!oI^qCGtJUvA7V?8+ah
zl3AhxYBr`}fo@oevHOPL#8YeiwC#86%;xyjU!_{OeBkr;bv+O6$eK2<?BbIE)J-q(
zHX~WV@hs#!c$Ja+x#}ik9d=KGc0?DeF2#u>hrO<MAQPiK9>^Ms;#;GG0pjzf_8(Th
z=~o@Jv|@6hwxiGqyTK|-xfKxtp_X$IbT^m352F|!oJ?wbShsVkvrnFTGA<LRMVUqR
z5)usckBx`_Y<woO(2BgbKA5Jj&<=wPDY-nVZuniQ`^gHqpdJ)!tQXdn%+YY6)|hOc
z74An?w3JolnqZaD?CY4zduU@qnglumlg^^+d9b+>5~Jj`FmzvPXruMoomf#-$OaV@
zBfDI<0Xnlq<Z&!c_XU#6-UqTja}&e=rf^YcZV}+pknxoh8ROh3VwMPd5No<xh11yn
zgZ%xDZ}j#7I1{6oc=?`Fp++v|7!N0R#6^bgqK(FXdB3Gs=X|FXEQ_>eeiZpXLuz-|
zjaJhAcR`BRi{@W*tOX6Ic#hX*(V-_f2`tL-{+KF`E1#Gu8iTv$)&bi6y6UpP@bH^+
z0Srw2B2ZKl%!-7nv=>5&#~~dNYR!1qB;)x^GwqZ%H<oI0tD=L)_Ylsx;15RbDj=d>
zg4pW~G!&5lm~qy0wG|rNYc8anP+ON{3_};rD>48an*T;q7)ExIks>^v_$}ekB>cJa
zvi&iTkv?z)7G{5y^=(j^QbA(J&ZLO{l_SNkwk|gbxp%Y|))%^mxg$u2EKyqXWAdsU
zS<CkTb@j!HkeNQK)ko1hX4AYr75P{wOl)F!HYMW-sz4DbC-D}XD4&Wy@oGbi#MMw(
zi@!Ox=6y_}b@0k{>$PLnmFgb?Nh~)S?F8}uz(4$KV17-P$$HgJDIKLvWMpD8ASM%w
z&qM!yqUdj!2gpaC`JOELFJCg2MgQ;Isp?3Z=w$}@+oAaq^doe%?dS#_%=7;~(YRTI
z-{agBriKM?z~bI<g6+K8g8jEk-J9fhzoj3Sx{{f{;)zSaDNRJ5InG4uRf-u#_=SV;
zd7Ni>v!))@7JwENUPcQTk2u8cpYcyvi7iN<^aAMjkc<Aca)K@(q?4d>yK#MqRzV6?
z9@<CotE)|k=Gp>zw^dJ(w07ek8uCTEWWr*mqRPvn=y9luMIg3mq1tO;g4Jg{jY0wB
z1#w*d13a2ShMIU8j0N7KzyOuZz?$6`6vx+@M7*uVAD}w`W;GKlr?NPBCBZ9(Wx2*S
z?P%UdSx~>!4)?~_-Q6V@Cp!H2Pqy1#@Kd)Oz<~Z}Brd1FqL19jUTa#!W^hYhrBt!6
z0t$6>mV`66<hH@u!^Nc`9B6}?eE0EyxpujErG%}qwkVzAIhCeWbgv6aNQJ(-{U3o9
zTK*?AmdIb2oUYofjSO*+1H4X%6ocx0IuIcmybaW;GLTxhT~C+qf-VxHkKX*+)Hq07
z^w4Ud#NCauvu^gL=}4D;co{w>!I(R=As?a`n0?>LYuos}vjX^$=D^X>B+#QO^!btl
zv7yjsKwkPD%EZIAKR*dI(7Nw1Zamlq6K)}1%Jy}ywmf&q^^(tGP`r^@|J9F3ys#YI
zk>Jq%I@~uR^KEj&oYc@D)+dOZtfX;&`)v5g*bQ~MOrh<2>jEPUkSs9@1p$!9d<>xh
z3mpU%w5dTo5;R2~$?8<TvlvuaQiE(H2{0KYtE5kRW?FPXY2ZqXX}kP+<C;;cI95sW
z4|tKlE^q4T$yXq?x>k;iC1W}jivSiC?hpJ=Su>Q%h{IV=_ZocE<u-^F16(jfY72%8
zVMM=DQC@f`;Ap~Xy#yQFi<M16b_i7S;BV1v(X+%X@cpPW^vU`?b^gGT>rRl05$=^Z
zLP{;8aBW71pvoK>Q3eBaOty4w>|(>Qc6suBptr+NVX%?l=ZRtcejq)-wlJ7}925`E
zvoJp#X#%iWuDBLizM}ZkYKKD=vEhBLQR<28!N__RFh4E-daLb_AljD9BQu0jC5s1d
zRNv3E8HW$TLpNWkdyOiV5Tag!&gW||o_&0j#pUFfxCCS(n;WteINL`;ocyh^&;%Gb
z-9~D*?P7J;r_cV{=tWOnK29OGh6Z;O#%nxc()_goJe?hQGrsqu=>+Z3ON6~p=<qH7
zJa+k;`wlE0uD_`n`aUS`jFL)KtzZs4EjR`deFA-HGS3sLE5sXHVIpK85?fro+DA51
zn9)ugfgljJwN~<nO^T<kov$}Q*L1amF#H2-N=y$IwAM&S(TEy<rz9H=O7oeVciEk{
zyD))YXWr!iHS=}g?}Z*`BLR~>8NE-&;Q{@wpV9}SbiV7bWylbxK{E~~{yQqsr?K`z
z2K9MpLU$z+dY2O)*85dC^oisQi7^cfun1}{2QY`2gZ8ER6-h|>H&)i2EX=~00XMw+
z+AnDY923_oOE4cqg>4z)-89*n)R;NpnGHA+2q@DXSbX($?s?|;&jMvG<&<CPMqVLa
z46g1iU~xI4v3{lnJu{(46)pi8=Qa{8(Pc@pjib==HxCd1K(Gt)>L7QcauC2CV#jd}
zT%vk+Du^0*VgM5^gTpyR<5?Y;0WJ<BG--<ZkE<+T<pwTxp&7id$HR9D^*y4DlyRs4
zQxEV4FD0DwjaIPSwp$?uW_m)vz;eJIo&QDa5BX~PSI+Hx573ZI!NC=ER)PJUtI%ES
z03%?oO_i{u{GmBq{{LM7Dzj)Mtz0lb5mIJQ47(b_Rcz@9@FGweITDsg%N>uY8r8bV
z{qp{_=eE{Uxl!h@0^}!tVLZ=XKGg^dua30!5UrBrvRZ+;dPV;kqkFoX)Str&*q?7H
zbw!t<_!@7uxC$-Z_!V!O&6jJjt$Z7b>6t>d)`>l7R6mtmmcq^cJ`CZBn7F+V<LXC?
zfLIVI>O{zBp=#Fcgm%y#0L>DlPaN<L0=-K;Pn*F#PJS`-%fn<k^Z#f%r|3w#ZVSh@
zZQH4&W81cEb!^+}*y-4|ZFV}g?R5V7&KT#SM%`AuyY|AI&syab&uwY`13s6YiwdaJ
zeJOSahRgH+_c4G54&Wd54iGhvn1q<LC6?nEk~sJ*Pj)+^Zp`fAvq2c-CR<HTcs1ae
zDE@SF69+W0=quZ!3)%`k7WR{HC=ni^j<3AJ*oKZiX=~}Vn`U>AVxV;6{&Hz(rADz&
zbiW*@rNI>a`;Hk&iB_S%bVWIYN~4MO8kw>GNbpYdBe3_2xd14jH|urbw(#o%1z1Er
zVfE4M4l6m^xWPvTmxGk?1Vu8SQa5<0mRMp)B<}A5=Sprm;7{c`oFZMKiwFF5h&@f3
zOSM7WxYt<KO8!CoG2iGz4{WDL=N}^GJALqhao-}mw%{fzKYJ%G@RJk|ZtMuq?i>3`
zz~hF{Bj^wH_a=ZE_yD2w86YKCxlgv^Pb{+9l>x0o!5GX`M*FnDp2WfkfMKk}|Bw%-
zna(?YF2RF`+A4CMnF8e)!XR<Zlukuwb8%ki?yhy#L85)L`HI4glZwGJVlk19(B~^r
z;`XVjq0){)u+h{5xI5Vqsni;7-SI;KN&?F@hEYJN5-|_=7D|qfWRO2)Jh=u%-di1P
zbek^<n2MAalw#CO85d^|#~G}JA$?-mfokB^Dd0GKEcj}BiJeAnu84&_X7Q4M7E@Nu
zt2T+>hc;1_FC3Wuf2X$;JOANrzTOOvPWN6mTnPaly2XsD>He_SLm7V__Ny;$I-mFh
zXzk4%wo+Faew^-V;Z^t*P-8q8>=Q69Q`0tKyia67er^#IF%EOEm3u+TtP>U+(7Y?O
z8#Wq?A?-@G|3KF0xC5K1eT(>o5tMuqy?WfSXKSQw@(_}LUe98hrLLD{r;hbg`=bd0
zR+y%qTf{Rz@R!FSml);|XZ8S0sQb~b@ic-SQ~`_EJK29Z7uY$TrH}T@dXA2^foKgq
z+6zC96_%?F0t4W*KJL(P)WZVJ2=t^ESK{Jp2eG7M)jTkPd14itQvX+2GyVIsq~$Wj
zdD?Ezy=X5VUpBamP#{}G2+FtIc!CMTQ$uzlG3s<#wbLJN_|C&&XApAqb2}8M_d4$x
z=J$`=N*2OHqJ}(hg5^UK73r2zn?sf{A;E0Crw|n09q*8<An*i8$RGtSNQDqUQ3ec(
zS2+Ci1yaUcn!;CLR_Dl*OsSsW1Qn@GMq|lfp5crlwAY)sA4E<Op$8ClAB@%nA58%g
z#x{6(!hBo6NTkB4p4kZqyxfpoEYO=ZeP4{mHC^VleU0uq=<>1PPF;7-a!$Mr-H%L-
zN~uxFo-+O%<^lSsRKQ3e)y6>vEHeb%z``oGg;QN1BZ*<1{ibpT(Dp0}aQuKg2C#{a
zQ4=L(yPEkgmU^841r)<5mBLUJ0c3r;tS@B_RZPN*E-ONmsGs%iZJ&REsNDp+R?8hf
z2=arJBSL_N373n}F5M{pa%|V7nE4;$J>0AfJKv!(foElqUpNtksz=s#hdN<(9Py5D
zm9N9KLP|tatn`P2dA%Hwz~X<pML#D?^y@thcsJ=Qz!iHjmK%Jt1@oXgKv5c62odl!
z>Z@F2!#akB(6`IbLpW?*pfxlQG{mKs@}b~Vmw?y^j*Dpu@b`c=kuAevrxOAc>l;r#
zf+OC05=SR~4JD*Ch>Gtw0gdkQ!eXGYU7^zp0kk*Nn5=~_t{H(Qlz=DxTO$|Hb}USW
zJyn4%<@ph`H?`ofLhT4bgJEg8;P>4%&5W_o3H#N`wHrHuatc7{qc2Bn$2(B6Fj>VT
zT9Z{B_2U(7z4GQ^dosY@xot@B!<o0ub$OjY$SQ4eBH9U?<e}V?LXC}$JL#Y<f-{N_
zpL>8d4>$A%2YQ<x_E?rDO4FG0zEA2>D{KEb@`qV5fvY041Z0t)Vr02J)H^!md}@><
zEh5KtRuQV5G)GS7uo_yvCwKL#ry{T^mfox`r!+tf1L!*!{;mSI_wgVR%mTXYsHyjm
zA;b)I2R*RwSt>Yl8gv*e{+A3;`8<(}dPsL}kZ5VRz${$kVvT>!T`lp@@@v6)szu9V
zP5!j|hO1ex4U$pQ5VKnBC#2)2tXdhWER|BuOvl=*?zYa0o#gMbNpUQfugT)fu<>+%
zJaPaD6$zq(op$LoFBUyI4yhN3BydLt+}%FD!25#XGTdLipz0V3Gt*G*nEPHI61eYR
z;3OnVGGd2*_ECLn#X{eAc_s()+#gemTe$4j8c}gq{@<PHMwjE(hZ3V%XgV^!q0iEc
zKlQhdx2ETsaB-9abK&8e&S?d`PSfyzxmES9{3QfJQ}aMk6zDs%dX-^^ooTOjs(Z5m
zdX1>w&7gF1a$PT&OeGZ{yFgNlUN}ZffJjv&CAt*%N^xT`CTCT8@j|zC$=SKQ)n*4O
zqUIBcwtm>g9%@@&<D<S$;_sR$BuXBd_Dat(T_#lO4qhH-eRVmDE%tt@8Q~BDn$HF$
zC8Zmm>y2Wa3->}mR{7`raA-SHJB2U}4{}QP@7<0d>pwpE6^d3s=t=V5De8j@2=3r=
z?bYb0;RhtpHDUp}Ws?66i4*ykWbIwEE1glcLYsL_G)A^zGoEZ3*%&Gi{}$hv)7+jm
z`GUx=*@>+A`6vV9F&tczriAm|hobTBSw={lzubhMO;KJXN(vYq0of@1Qia}Tw45$G
zUG};1f)+L(vq740V;Np$xDLg|Z&XD}NNAw8bQ-V^Ijv7L^xLo<`c4kgiz?;<l}E8T
z)lLjA&pkT1=5Wz)F%E`)qo<#wU~S_SVRtE?_psASlQM@?OY<~UQfZiDa+GN+KT2to
zeBO7$vfTM~ug>`K>3|eVogsV`|EJLv^LBz3TT~^yAK<Cw2J!~W1bKRzx}-jv<eq5K
z;6#E@Jp@0(k>)6#ZL~BH7?3*uOSiRugVpqbGxU5^@wp=%j)Hif2HTf<xOiCY$Gx+P
zrVMFf3|T@9X(D_nBHd(RKv1GWdnF2JAtyT6!x14Z@_O#r@y&KW{sD-1wyrPSW#8Q|
zydgbpTjulpPSwHgfl;k(xJP7Gvtg}yg`-C#D{^57$9(BSpW5+b-#>#p9Hjy>K=e4i
z@0ezDhW7~MRzI3ba4`|xr8rkfwRPj7C3H+dK<qs{XAOu3fNhkV{%OLorq6aQ!`M-`
zB(5W7L&Ye6dNlRClREN$Uk9jU6z;QPlvz3-t&pF7Ei4V__Q;C=zA<1pZku?k-<hP9
z&xFp(w;EQVU3Sz8d;X~xm;P55RhD8fdBHzb=~`zVAWp!*i%P-fh1Vh7842RutlqWh
zfF?xC29pnSTw3a?4TFHXm+a|@86}m>>@CKAOY&BUOW^-%i{tf$V-{<Vi}3u}{I?$b
z@5_y7XA9~)P&D2!YH7Y{ydYCn#r+(#U_&L*1Ue`Q<X8z&koZ;*OYv`HGH-l9vli!v
zFWgWa!RX;x%)m!J2j4z6R4k2k>A7uE#iWtNF5DmH5z4tE+807fo8R;P2MTW858f{y
zZX;*fvAtekz*;hLqN!&*PF^U3qqtUY{MO@?X%4vn1?b>7e>k{(XZT5}S>ViY(Xi;?
z9|6JjWPxPiKR%Nqs!SaoMas&c<H03k+yb`^il9~=*dx<ugB1g3%uA@mEcn{Atnvj#
z7xYU4`9Vqpa|Z_gdz{a%?P3|Z-;&bgKE235JyfKK4&AO}yd<e&nq+D9@E;wXO%lsT
z0<h*YiE7^<sYvW%3kUYYsTQtMW^}<6Y^Xnd%4{?kC4m@*5|CsBBB%cmZ>7F@tVMhl
zeAbdM49fapD}A>_ZriT(W!})kivK3lFTWe>RG1Qg;yTOyJL_;VY}-l+us8V+aebGs
zQvQqiIoryFsXVR#e?#vY?gG^l=`>ZWfh{|pcLClkF{Ey**C-3iOj0&d^f=ffsgV^R
zAzWalZ*H+}M>caI1ynMj>A!))x%_aa?(wKx+_qO)#nSB)kr5VT5E@*3_gltlNI(mo
z;O$<}=(IyqKDT})M$Et(Sp0_kt)kD!@_O9mym`B0fKz49#O)5=C?p}s2EHeM<$_BH
z714!En%e_?KY}NGAElOR#5BSh3)egeV{atC1Y)6`189~d!Ak>pX0G}MB?<=Wxacw{
zyZ7m_|4<&;1pWl{fPXV=$#4;t9Qcx^Y72S^r5_GLOV5ZvoKvC8Zi)a1C>wnD2#&S;
zL2Y7#9gup{;S%-i+5RB@$6=$vz-}+?RHE)T6z0>&Wb&<Aan?vG1NhuOA|G1Vl|o4>
zux4Ih4hW7~D+i8ViYl4ZOkWkqclA**sA)|2-TKjksG&UQj*YJg4x^jK&TdSRw?7ik
z3Dbso@?v(o!4Lcyuzq2DnOr?>Ip7z>{M?-cy5y$;pO9)C+yxfy)SHf*QJpRHD0OnC
zZ$RbvVAcK9=Mn@e&l`4RgD0xP!v(B)C6GAm4EJSM!Q997RG^L?A+BX6p<|CV=dGN$
z=;jW*LU$<+=rI5HFo61|78_EUR3ej*@Q4YpQyF+oT2kl*#hGj&z)XO|hZhe>=f2h*
z^hFZzV|iV`E+ru%UWtXq3|BM3FzLRk*7DSaB2a-#e2Sf_alhl_9FiSWx5!5e>Je7k
zjyka?#QQB&J=;Z-sYw%jMB2<LTDvrHD@0r1a0MsXe40*5Wtlx^gJF55=^(~KPh+|Z
zD)JVHvISf{m3c-yDEEyLo+lW(nWw<e_3(c-<9RJo^}o}e|MH#X_nl-WpDU=II6yK7
zsU~QDngMQu76cA+CT_Q41W~gn>)C9N)I-|T!wIJed<e($m;_B7cez?8Ud|SMkugpQ
z_WnQq1;_K8QX<zrKYsP1t<d8N?(yF(HR_L;T<?g@`fyHQ@eT|nQY-54xRI6i*!jBP
zK}!5bw5|7;JGtQZ_KyUB>7PmKGIhCuKVQ?W4%qMX>YEta^W~mkTlJ&Zv3b`)DMfOt
z%)TFbfqD&jx=dq)r7xdytR<$jV?|D~dkJ)jE4QHoc9aYykTZ`sIQdX&bD-?p{#N+!
zbC%g(C~qu8!vp<(VE60vC9OkarW6kK;j%lp++1}4t#wc8g&Y=Hm?%}i8NJjrfMk$^
zF>dIf%jHN74ED7z+u^@!kub_EfWofe^I)D6;hjGHG*SYYpg@$Fy}DR{2jgHD)`A&F
zO(L7Jo`domY9=;phO^S1VD)U$5;AR01~|^|Mm>_@7_4#==2Ug14{K98#<0YS=>q2|
z9Yq-B;5%h>;~?FHT@z_Q=LmX-g2E>2^wn>`uOVQ=akonR$vGSFp?ui11oXv<KK}Uy
z+XChA)4C9DV+z|UP>37Nv>-N7)}%lkUe1Xr{S0$o%Ke(jGZRv%pQQjGbWiFDtLOeR
zVk3pZFS3}Dj6!XmX7*TV`iNi0Grt;=&_P^)xK7>+x6|6b7C&&6ih7}_;TGq^+yn&5
zcR>1XQAq30(lH(><jSJRhS!+IZR!`r;AM#LCt-mDXaeC?o1X19yjb;w0nU?*L6doo
zQygj61x%U41$Q-^Mv(lh@vnX4ss~Y95<%9m2OtB>-Fu6T<NwCO<ohk%7HAC}B?5Xp
zn&#3a4{CHTSEn3pv^$a5E|S=0)px{u>HE55^|$G7+TPud7YG<b^Q+AUlIGUt3>V1Q
z9xpTy;Jw5AL~3o^LU~0=ps=(TDgp3|reKwc&Rj;^t0KOzYqx?7F*Fd0$AFgIMhX|Q
zy-SB<kYX>D|LTQiDddwN@W!ht=f=bVwR-jqUD724gSAhZPp(W|@bA1Hl@Mk!`BB^?
zM!#HV7?!O*RYGk%R6xErLPCk11BK3;vu3m24fRXli`DMaurDzB_`QJkYWyJ>XB@XN
z`9B^9@Ois7|50qI^+_j13d8kO)s<cVbm_&Lu6`8EAauKfFkO-n0dEpR$B~X&9gGO)
zwR6ielt?V&x58BiF|oTj3`GPIfe290z>IU(dV08#5Lfj>Ik!HSo%PR(!Wa^zH7qa;
z-~`743AS)k5;$}D@n8q37d$=5T1W2!)07tJqt+1-ecnOqBM&@Fs`dgAkFxH>$Q|y@
zDO3N+nC3l7vQ}jTOtCqa;0$>IVNr5z-LPw54b<SaxFB|&;D_hd2vZu{&v`QmH%V37
zfYZ7CqVON$oITa0dGUvpR8l%*7ey}#LdLbj=shjzz=CajGvwa^tJ{`8zsVg$qb0L3
zaGGTzVM6*?Zy*V{5dvu6$ym$j<8g3E9U;_*;-h7tx7ecwlR@Gs)^IkSFzo>WBH))2
zn)!XS{%^!k_@t+;sHk+HnG}qb-C|kscjfFMvXQ-Nlo1Zupa79wyHid=u+g-dMq>2Q
zSv3##eE<0v2*T~U;j5go{DdlxKv87O%t&uQ^hR#uAX4y|?1qb(o(J6w)lJKVM$y5l
z{<W}Qhmv{dUhGUkbtBjULBSr8Mv#QOA~mo82w}ovy`2`G&H`@LNxOr*47D91Uu(m1
zTwmLKp8W&*U)S^$T^b1I-$%yHb+%dDYOl{U(I1!=Eo>XsL2sJs=2~Z$w7#M#cbBR;
z_BfO_OX3a`bxI|XcL!hc#T<Om&W^pSU;7Ey?{)KsC-b|23`e>M<=e49Ej?UTx<tvj
zjhI#`XB;7rF>vW}ooy=*c0d^M3|<RdHtxLsm2Z6_g3yoI$F8ds6QhjidOujZN=s1!
z($1`8S8qp1c_=NNvpA3*So`uf9#|BYx(scyNkZV@@7cRvvf1Fp6km<zD%}C@Q<hG5
zzQKCx#tSQs!nOpw#E1HzXvtGze}&e&yVakrdCkoL8>>Y8Ibg2CM&Tp-4f%aNCXXXD
zQMf3jp*cw~PYV0R<DDv~z_7JzTE4+alX~m|c$pI%-HRX|IMpo&fdne=;=pdD;VIx-
zvHHEEE6KrDWO)H7z|rB^^5dD~URfoswM#}$MoB#%J*r0eju_Cp$_+nkR9-*Z*7+$~
z-P4n8?cE&TX%*TYE6aP=X48gMN%ST@GkTR+-xE1(s)EYc4zpucT%B=MO%HVG|78N=
zg5SF;D4YwQekg)aYpRIuTK;SDQrz4|uSae3j{c{)0P?sprKGyX!N0EE09NsS9fbeX
zAl~OIP&o0Nk7rXHp96>#@&!h4S&=6#x}g8^yRu;nkk|w^?&KU)I?|`k2c~19vG`jC
zOqM+Y$dqyaRUV)F_&9zK5GIur$((6G{Pn-#o$R{p&`Md+%r3h;#{^mqy%wk{!F!?#
zPq61N=}m86b8H>dMeg4E<J!&JRe0f=6IjJ2`gLD1d`eixZ`>Z%6dvZ0W2(_HkjVU8
zXM?5uTqBs1`mw?ypn#iG?Re$4$$DRou1`DGj(~HieYB`i{Y6YHHr4VgC^PtTz*9ii
zyf*}5;v;J0z^dbz?%}#%w{6vGbdWrK0jlaV-S~7jMG#M$YQGw&wVVI!0dMdmNU`(@
z$wz%okV08P!U0l114w$Mz!)1R=Mz(1-TbCbRmb`=L`t+yJ9Ah~Qe}PD10>@XxD|F!
zGy39(kOhPPQ3t?Tkt}V;KIOlooO4x!1%B7HGAArvR9t_qtog{=v>dM5Xmd4ok8`!&
zg<tK4jgQ6-?bn-$h|I!fu~0<pCQjgz%%U{11_5}qrJ&HL&`AbRns7~i#Q%h?8^lUa
zqSRiss9gE0B3pB<ar5=0`7l<c`||T*W$iDU(wIh{X5IN}PusOd+j$Ri%v=EB?AOf=
zWA7IB9ULhohn}f1*HFjul1i$uBmFrPu~(NFY=7ARM)=wM-+Irl_oH&dfG>LxEV`wb
z>pRZbW!g|@vqUgrcSxI{P$5jErut$Di<C%?9pxVass}luqPp~*wch+#IlX8HlJUjf
zF3m9R<NK#mG{b5q^W7!j`kMN&Pkql!Isejam8~5HAIEW!cKUErzNl5e<Rm1l8i|Cc
zHFxHt|B`o)ieCY~hx$Up>V6QeB(Yw8{;2~_R4CJ=OcAxiVE61}IAswL4K&*B1Rhhy
z%y-(sLK%4Cwp7xNj2!L4nzRZ;%j=yq%tHo+cu$F(+GJh|1|0~l$0v#Qobm+_W@j*s
zT4(4-#=FiAXWjVA-nolo$M1;=w42q|Af)<NtFB+2*5Odqx$0~Kr~npBnO!Cy{7?qo
zXS#?nYjuwLeqZi_H@ltvatXs@M3;XsQXlFKx8pY@KB<2kiKx+yUpy*PQ-9wP(25>*
zfYYTxF#udK(+xU7;a97Nrw=(SsLCF-ewvc&nUdpW|C(Rlj*fq_ZFo=T-m8A;g{<;_
zj<YiCA#fV`cWCwv;!W&_rAj>(JN}wE>Z*3Lp9g=lcws0hQBY8|xE#s8eP>bKeJAsp
zh1YrWH?&yMj*$>9RX`a;b$tLv9uX-*wcWO1_Yu=dcOz^;RFZ|C?KdekTRZH(Q6=+h
z@;S~=wK_!6Kc0?)n;MLwWA80iR`wDf*=bf*dm$(aV<<!xqf&81`RdV&#(dz7SGe3=
zXE`}WFl-1QfBIfWn7P3K=etmG_nr$vakRxR)be5E$f!zK11rY{hTDogWEbhQSxRwi
z)MXF^n;JRct-oqV&wteoJl?{LdM6lL=mor27S=!lpGvdfLkS58v>G)PD?1P26={cx
zz2wyf{4GV6bjgSLnn5(DV;5+x%0R=3!Qj9RAA(@9AS9OPEDeaqzA;2U_zLdj_j^D=
zr75Y#=d`(&$4se~??2v0zE_I({O#}s(Vo&T_?G58r)P=4ORyhb@Qq54vuR~i41PmU
zZq<USm<?tOk;P=1b^)%Y<t}?heQzTiV%tGx%f;1vzukDl!FLltPpvQg_9ylZn0q*!
zHp8%Ws;=C|0A<3(yx2lHX@3qcmdN^}>Y`<gdXiSyEL+$+znh6a1Zy01nn7ZQoFiSj
z<X{h`V-<&QhIKOdB?D4xSYKRbjR!W>0Uw&%L8H%Hu>^qFub+P-vZ82<J?%PH@ZTa6
zl$Ti=*iF&bALe!j#CBM#{io&%yriLLeQy|nnzIeU)mFlR;1(+K+DxpXk%bNKY+Yz@
z*vmsW)CD3uLidYP8eBG3bD^^^zD{R)!Np`u^xR6dL45eL#;};w@UL>}D4)!{^;yZy
z99QRuId5cG=_!}~EX{)vEe8Uc;S88DL~y_=fS*mJDn7vx+NnyYxt5{fHQ369IEJ+t
zPlFT{OI7cFZ9E^dwwtZr;1{bHD!Pb^6aZSY!9*$8KE$BKu96daupB=qy_67evbG&|
zOi7rDn?Iaa=ZjnnUGrptBiF(%C*7mw%+1dc>}S|TEXsT{cGlJntFPHZ#5k31GSXP8
z<@|M&NrXFeTE(AvDi{>?4^)nbczAdLR1Pr#!*H#DZ9@=bT-Rr|&|VxHPxsftVoM2t
zvCEfsa}8rp`%m;zU^{V1p|sLP|MPv$L&SxQZCK6^B;dS<@r5mjj;F#)-sQW<t2N&t
zNnkPB;a6l33sH`LEGfvruVHHnJPa&KmLWhGcyv|CA{9At9E%Q<15-9gD@1|!SY~;(
zCf%U<(jcUjo#W8syp)(meC5=j1_I<mv?#@0un8@G_OFI(Kf#FEm{shKPse}de%yQq
zUTT4vrq8e8=U&2Dt|Jk#5gu1#<^k`2M#2q)2=K6*3m*obM(k&>>qcj%F^G*6?q5cj
zx>hj-x334YtI@b1CP?bh@CTTkn6)kI=gXjkO2TKGMrg<t?6SCp`_*sViFOHSLE_Rw
zxyOJT6}mo>B;mtuSI#{=QU-6;w43r{q_c!$;xfOFJj66f>nMf`Y+D(Q9nsj73G5Q(
ztCLL!ca30R5p1n&g-c5}Q1aFT2&pBzVo?Og;oW-fOc*}0WI<1y?4}atA9hu5d!Y<`
zHqaozvf0w=2VoPe5Hx0GRLQY&8qnlpu%TE4=68c{*Wki#iI#@Q|2xCSTbi;6Ne~R`
zXx&cUg-&1VyALeBaz6R(CFIRzY_-{VXTvN>SX9QRMx>eLnAl_iy6B@}q#If7qupM}
z09*EztCq8~eM#*6k7-MvZI8L1-XPWCVb(B4H>g?33X~n>|1?n;kf7kmCmReunW|+~
z;syt&k4b!3L<l^vM01%#X}y{5DHvt3i_N8>B@C}<8I2JXWhfg`gIZhFr+{bGR@6{~
zNe=CEH!0|cztV6Q`rH^Cr4<T3O=;lV72e9lAaKLL(DAD0rti+Wso^gEhmD;l?k>;d
z;r{U75YCU~h=n1^=r#QVM|~C|$WL|rx>2vbJHr@5R_M#_2%n=yi=1ZKmW*Bt-pFrQ
z<R{x*4Hrs?1Dc>X0#ll#2-6@sTq*Turyj(4>`<!imp{3#RZYx^iMQp@phusPQ>6w`
zq$7TNzh&?#4n3!LQX|*rTNTQtM2c)0$go1WDmXZc4!WCIZU<`@p+#hzWZn4=h-wQ#
zZ5?`u?CHB${9G`gul+%ms3oI3tbg?vJ71YB;pXUOVC7F6_T1SpXzBW9tgP9LeC+pp
z;jBNiDcJdRXwl~o2*+*XG4!yc%_~{k$mJbHx7=*B6jF}1(sL?`46=nvbv?JWKfG%s
zcUeQl4e8#at>_#6yVoG05p%b5yF7KB>ucYi{Dy)+`hOOHej82t&{K{fc;TGGVo6Xt
zM8Y`fIACJ3JchaMK3U*k$To+3%`JcU{fNLf>Ti@1lg|OA=hH9b@TFQIzZsILZ2tpH
zB*K%tF!MD%xc-CnbmBeWE6rPnD0q+pi`$?L(Co%I5PiWk223@=7x$&WFz8$J>a}02
z_=N(_d^tEj>vz}8L{BSo=9tIASTmIlhKV)L_9YIJB5<#hAKvOdXpe+)AOOmoOzzmO
zN`^cd0|ZEYl=vOjaVa;P@0DIa0%epU@6H!a@_qbA(lld1txjH7hLJ*ZM(YZN3Bd_h
z5;xO5P+>d9sgTBs5~1Pe48}TBwX$?-b4(yl?3EmKSHhN<x<JPK>-h_Ag43K~vzDj2
z0mRP)+n%i1Kd_CxJu&{iI5KVXvh%0RgPaQ=wCM2^v{a4b)O5b#H8Wg^l{SE~1I@mT
z7dmeue?02ep4bWWp=U`9azV5B#V7PRN9UdS?dWGt`g5&M2$#{xu1nDf@9+_4!Rtv_
zjPlV!D=`@)d8uCz2+h_6Baw8a9=SfCBX^~Ej+EC>EC>bs{;WgvuvBqBEaBK6gS=7D
zk8rUy#^8rN21~q?nlXnr5+_EhtCwj6mfG)U9EYPao{cQ*$k;fX4ZKDYrJa$=_5DF}
zz!mHQAP;)JXzD5kDd<|F+TgZ}3xof=66bMi1qWN~2dCuFNC&sziUr?i_IqQ0*srrf
zN5z;64Z2kaE(V1-8Fd0%)1H@Y{+_a0lQ#Hxto%TRiA(}7tla{U(^Al4-AR61*0&k<
z(I7xJyx3^=`tvxEq6*??wtE<)*`}Bf|IEp#Rj<NEJ6p*q9mW|?PbY~QY6TdpEJ0dr
zmnfb^!^WCDlrAdXn~$U}!XSqOhnr2mvt$;h*3A`NQ?DEQ&21QV{n3}e!I-5}(4GWA
zY+hH`f@@!uF|@{~aD9Pf_yq&EiyDv&h@&{fpvi%z!_4tGgR1sBnJao2Y>HvE;f%e!
zkeC}%EPhF{jH&zd!dDRo<1u4Bv&k)Qrzaqjyy3&D(G39}QXI5p%4j$G#7eF^gh8N=
zXK;USpcaj(^XaJ-f@yasRIuE|;v(G2S?1#GrO^-~(&bi%JJsj4xLRZ$bzUak&CSkY
zv(Z55>N%ZR1Bk|%{WwNiX?#oGOtNgZB?c><S(Z?1%Vha*0N_t>oP`&;+()(7pE#V2
zfc96;c{Cxew$O4lP7Vxoork?PG^<o2hT$hxNF)$Cp($(G`r}pn`ukD(g{_VXsgyhd
z@tdK!f|J5>7UxILJL}2aIGL>yfHri4!C&v+w=|*NjmODtkj4GD7sL>$heHOGz9tt$
z$s8tnu{Q}_^RaBSTz5Pc1yT#}&&R8Aom|GH6*JQa({c*EAO%nuaLP%)dM)$69LBUQ
zzq~7oS)<&wK@U7-I1SR-To|zc9>A7550m?eys`VC^=hJ3oQOVT_mIPU&?;IJw7`DE
zdj0lKUvO@~12fK6M*^R?S5IR4`6-|*T%pM8j*LOC4Js}D_;%_Cov$<sEJ#H&hv|rW
z#@=*(AFO><^uboI#?V5!K|ip#3{LvG|G?qOuayv!m6m_i*Q!vr1l9H3*4BCtM?{qr
zW*%g-WiQM36v5ai7Fy0*b&qwPR8+VX>zJAl4-VmJ6MMbw;%4$}OA?L9`|}Xzhy+&w
zRY5+od|Pk$65rPM*M|W%22n&Vv@9Od0(>7HGm%iOf3Z-TssPY7r=uuA<4Mj50!ic?
zgg+QIC=<HIHGy{LIO!E6#B2*g>{qe&Z{(1pwJnVB*gE!!2(fRKJQ@-W#TG1Z|8Jo9
z#p-_#0*7Zkq#@6g>N8mh@zzNm=wBNVt_JLK<@itin(sD4{fr$0R#WTWEgw#|KN2t`
z=@PTCQCV!SIx0}G<{oI*_HPd^wtv!N<@RvR(?m~kWLr-%W7348=@qwAJu#e~C0%9C
zO2Xt4>^}e`*!rvmSrC{Xkiidzum9!?yyhcc!_a6fBBwohwby{GN(W9^{|=5Y$U>pw
zlsCm(?RO}^{iE=3oTz1ox>!G@)97B!!eN1-&?vSwHxi!%TSz*hCE+w8{^x$lX|}Ep
zKetX0I)d1f%on_cpsWPU>ow@c^o;VP(B2$-_RH}m+!g6-&W`*+RcYQCI2_>rb)@CD
z#CZq3TV;B1>i3FE@cuH!>gB7X>(hUo+BGaA`vVQ`NR2i$ayooy62Er%-j*5BvZJ|<
zywKeUxJyFejpS;nA3+)?wc)&=Z(Fp<0m5)In_W&xkEX{?#DRGfhm6{f`Rf4NP%JVL
zWcl$x6og7Kr=rz8ceUlP`@sQJkCF&Eay2#*5o_`I_gf@0tFprZ6fu1i_wC62c>BKm
zG>^ynqb;5Z>ynu8`d@6*_1h^_gE9a}+J5u-y)DzgV$7UqX$Na9>Ze;8L!VCjSxT{1
z^ECnk--R1Tb4$TRbj*CK4KAI0oYk35@KS9%%7y>im6p#R2{#9=2w?41rhss8y2Nbs
zf_*)jbmPd_D;ksPpBJNsJ8laBZ`EzO8>7F)3+xx^sy|BeMNM_9<S@psDw0?SWxMZ{
zK8w~0-egR@(ZQtkWLY?RnOM@sL&FFIX9|+i%={_$G=_V2XNo`iUT(hGoG-Qb_N@3q
z^Rp_|$Hs^sw-tHXN2MUtU^wOJ0J^10dTEv2%0m~3t~uR&b)zO1><wyk%S>`by*^h(
z8P0bdSjGLlpWVK}Z8%L0J&3YQ0@%6OHDk;3Frz*ntnMZ_=#tP%g!p5JcZIK`I)Bd1
zwYrT7L+KG`X0+T7)U}?Dxd+koVwb+Bx!iWX{SdA;p$&6Mm(V(ho#?I9@j|i97|5oU
z3*G?EgP#5Bc=PTn;=n#@C+avJlH!q~B7BS&Ij7gmw0JIXS;e}<!g$Py0gv_Gswgu`
zWi)as?D_6sbHopCx^Xb9Q)j1XPJm}~i5)>-GDC#Q?&Htg70<=0ZoZ99`z;kp@@4Y$
zbDNcu$}|skHs2l`HNv#BQG->G;ex4>Z{_?r9YqS5<heGlge-t9QmVL=dNNqfzce_V
zlF&+fQP}I+3J<Yol}_h^LFS6T{`=y^^wB6E&iQqOcpFl)_eV&*h5S9o`c)v9zo;(!
z>UJxtW%t(%Fm_=oQ4qwldVuO%m$;d$^&2Ia`ZU@oi0Pv=<QarE*RO8lbf7&5H&TbE
z<KMk;cpga-$TSrje?|dg(sdRd(Q)py&hr>JRYZ6%d|VaT9-F6w@@P`ccxZh_O>`lt
zf%gmuC{^6($iiXd2+Nu>l|A1~N)fz?QbmfMrIDDMT@#DHF>Ns>7T*wrS9F+p4h&VZ
z_Q!0Tm7pIFT^h<r_S_r=DGY{z9y356Fv{hOu`g5_+`2O5ydB{WYU}tXGCZAXWUNXZ
zYfqJw{((y5gzGpZzg6&tn05O$Y+tf&?2}4h0V4vg(Sie+t~lyv(eujPou$FsDEA8~
zEh5cUSk`evZ*LU4!{)0-KVuZgQl4~=d=FL@Idx`*hgO29gWN?8e7r3Cy<E3#CGXyH
zjY{`#=VptZeXOJ<;J-LX@g&U9@)?@&EeSo@4HRDFnV8TLfYjf*+s?ZmiCbAYjx6u8
zlqpU!e>njP|51u5=-g~5Nz-H3<$?nnG}D=ywSz6>Ug%u>)dBUvE~NN3xtyQFs_myw
z@(#rH-7%6oJX7P{!98Ux-0x7zB+1~4P-L?mu~P<Ndle<5+CIxj{Ga2w(AQm#@NjR~
z6!PO3FXUz65kD1?5Czv7J@0tUqOJP0%Uod0zqE&^m~2rY1efMV!An_$_FTu&QxhSU
zg%E4UwAjyxLzD@}BJ-5t5<D?@jC(9W<-5!ElPlb*9|Bj+Wu1?GwpF_Sy)7CL_*vjn
z#S=)n+YziZz^aXn9!TVyY1wtE7||l#`!2k*H(Y-?ik^fwDO=l=xaaTNXk)GPVQ`^S
z!j|%K&+aA;QYA=EsyS3}VCekXPerC=I0^fPn&OY(w%;UhkQ-l?!n_-3z&6Y||K5W)
z)OQ_1?CUqJY|q#bx|E`2b{zua#LFXkuYxYi(RRs>6tcK4QhI2A+T*oR8<ntDavXG8
zB=XqbU*rUDUz`tIt);Z;*@LTY--DCOCm1>GX90#Z<LYu^V3?=(n6qV<0Ns!&Cjef7
zgYKPAafal!Qz0;wm(n^t$^lL=M)gWk715&4^z~joRck`m?cZka*l4*UI?7<gPU_A4
zP=;RSQ@eTmrB1K~gl8qodEb|o#9>1Ys#C-alw#+YGj^{i;OXDq7+FLUd8zv%;LLuz
zw2v>tRIRA61*eXby)BFz-oKJe^mKP^Rx!yEQM1T)pFSBBQn=U846_!<da-nVVYQeJ
zY^G^>pS=OT`nqAUzw40q26w*HIoug!7`kOwWsMn5>K_*$8l0|v2R2a)y!JyEaabSh
zoi;2QF~-cFO+TJ`8tfR5lg2&&5N+G*2vxcxlBR_)z*;y@>S6jjm^s_AX{C5`GWP!d
zYFSFR_g#UKc1UWov}C#x71gzI<pjWjq;eD>4>^=W2v$#=gPIKb5w!y^LKBwV?g$G}
z?Q@c94V9ExR;*p*G~pqAuh~dNBCdpjfj>6#3oZ(|srYuis1!>LGJA(qgVM!<e`$Uz
z^k_{lxTVcrthA%U3Y}a@620`m&A`dyPLw+Se5i$+Z{a;tfsyBx0P&IgZZj#o9~a~f
z+)BYI&XtyS-)t`Ul?a};mNV6$0`39jSl0Q^zsbKpAASm!E`z9t>f9Hwv9ktYe_!A9
zf$kcC#xT?~OSze>ciVJiqhp&52L)`AZKmC?rNxD)g;Ys$HnKU^KGjO;Nohnks%}3s
zDZP~SWyGRp&SW*rh_Sesnalg+d!@F~T)w$jmTBy`F!D0%AUDL@+^x94Ln7A9NKe;<
zq)H-h#|;vcR!&#BIA(+U`2PS)X|7EGNS6c}vCw*<#W}L|k`px)K~qLH4nYw*oS&}N
zd^?$(AicTSO8>L`m|4|%IY_v{+3dP;Mx_&V1L%;x>AxLzSKo(`QW47Z%MxLio(02H
z&$hwQDX~m?5npgNoskl+uBg>$^{n$O9(MQ3)Z{2cy0XQGgPF|W1T=Mw7z^orhJzNO
z|1J!kd4u0ZBI%6ji?grM@)}BWCQy2oF)F81Qt`h-BVY>?=&Wukl-qhJ;4#7ja5~%~
zJq|mKPPpEYkgDu@!J3M}BhSBPCr<p*=%PIX0ZOV!mmk+JM78powo<K_B9+Vfq9Fat
zyGBp_elOqbfv_tkE_X!d;j+#Zi0owLM`Wg2R}d<6OR(rX`q-l$cpAg0y4CPbv=9rh
zMT8y^0Hpp6x>98V=LI>-Wy)9fFRD*xYx1)TSV1Ism%uCe6Y-M*>${>**Z5s0thup7
z3L^{C$I~PGNiAz9Si2ZUe!N9nT>Te-Z&4yshXUlt3GqoZPVH_~`15s7IZ&=L(<f;9
zt!7i&BC69#>|=Lf<#_V~CLL7aLZWP<lD;v(AFUwHGKqmbV<C`All^fTKT<Oa$iCf2
zWbis2hfHxmrKLmgtyp-Kl#E#$cCAdd@d-ykFIo7Z6qzDd%S7cqGiXrS(1V$aT}^I)
zFG9Ap-_`;9omwVmrG`vxt#Uh^vH6gL2Y{W9tWsP*YR}N{ggqkhk(Ty(Zml0}L=pUH
z=eg4x09&JtyC2-?mXZnw68rL!K;V5^=;%o-kafeUmW+_h22Cku+BMzU7fMcYQ3S6_
z$->ykwAaKq$U?OBrYBV}t5J+%nM=^|nb{f`E^=RojR&UC`8?mpD-a=6G%TPaMO;lu
zin^C|J8{+!Dx->yRjn@%;APKCWaD&8hL8xyl71AiIust}jxB#E2&cM-igyabBPo9p
zVP8TSJMfC^&OpgTsLfD{KOSW_ut_9Xlf~Hm;%5$cs`V>yl?83SL#w8xd?B5K{(19n
zdwO^ni&Aa4sQqV|K(f+1y|c^erKdE$M14}f+ZBnCYTa=3#08`S_R4Bgm!=&2jcDzV
zj}EbR6=gi_U)+SQQDv^8RV_Z6trY*n5elKFbSEwv_*uQM@K!AFKbI6gBBIE_S54U$
zT$ahkks~DeilGwBf*h@+MDrq}5%V!p7b~paIqYJJ=W{i2Z<(k-FOw4c6%&fPdhgTb
z;@o~F4A6z7dNKYkH9op6n^{S^zMccmM3FtzzI{~OFkNClfRsTm+01=@D0AH}I@9@E
z!X2#MkEV>3U=AtoroOL7Y%FHVWR+b+5#=paDo;4}Qc>6&{z<Z|0_`(dsD{A>yE44U
z+st4PD&wjeD$d0T<%>QBU1|8J3(CBp?o5cqJoi(f2mBy|xp_Ps(b@fzr9cmk`c<bU
zS^|H9{cWpaI{%q=Qw}Mw{RMcNu3#dg&{0NMcv)=QF=P;huFih=fA0<O`w%5gSjZNS
zfhcVYl5~c7q_o_ppE3BwLx|~7%-~gfre6?_oSV;?E0Mg4i#I1M#H6N8VHLrWJ$k6g
zv|HJiO#IHq+oRZ$^3SfcUuoRu4`*{1KK1pqBv-fj%J|CVb_1N&p^%pS!SvYPKp#m8
z#*t=)NCHo$Evp3}m%}N^7@3_KyP}U?ocUii%q2WOmL;LkOE7FS$#t-8{`oQgwSExL
z@p{?h=swGNf&PnJu}uBUoq}zGj?Ouh^>e~c0tUq8hD8cozn&5%sfGC|I*m<uLt|OM
z%Ymvjuoyp>Lz$;N>jo3ESyyDzFUDV<5Z>uu#7;zE2C|tGl%6Og;Yp6RZv}wcA3+r@
zAuhEHEqi$zuifP}HnjYFuYD4JXYnoa0z_!8xZ%)qCG+;Wy*Z13;C&7JWxI`^BS(Ie
z9>hkwA-hy<yXEZ8Q5_G@K{bWxIIX(4ym)eWExG=fBGoG8AKJ0isw9%Ha7`%s>%ig&
z&bX-JXnNS<{`nQe6a~-0E+rZKDcxYQXacE}LU0ktB#PNWq_7Q&9K0+zYg@byZM>On
zmLg=P6Qf8vNE64Oz_EGp)omhO41p{{Q~Bt23^^Ak4pC@)L}K1^Ubgyn4gBrTg`JK0
zK6hJ1FS2{{T23(?8{O~ESwV0o7M*J`T;SiM+Lf-2QnKpXL^Ed&)Gka24n{jMUZ-IP
zHCx3<iX=`Yuz%)YdfX`@WSvI2|4ofXf*01@haJJ}4o={poD<8@s|+g*!pg&)WQg~*
zJVo$zS*FWX5Op1Wr*2=*A|ptiyd2yp#h_-vfzQUzEvFG&LGSYTk|s2-_@&RU9@d}4
zsN0Hk?SI77QC|N;1LHiAO+h7>sad&-U?qF~^vn=EA1)z_KYOoI<e!<wcklAVFK@&1
zU$H4cbpfCUllM|oYj4ly>&{At@CQHgxt^?O9;%sQc{Z2JNx>7=vhRAg0SIHoT<i~n
z*L8kh4i&deXeGv~XHLX|6`E#-Mc%iC5&z(}Z{VN^QJQ<;P`f<KsC8iB++F0<{4(mr
zhf-h`C(7U>SYQ*!%LB1>$1b;MgT-4V3w17XV9a1bOirPceR2Q7hV-Y{#ru2y9au5;
zL$IC}h>xn$H;Z1-Zq?x98{k5waFJniLW}myH)V6@5OK`HM=U7}8f8-u-U(s}r|jXz
zW<>zmEsGa;*(wJnlWKeq-5~5`z5S-}Lr~SEUTJJfbEA{lyJPW~@C*abftl@&<5#3?
z)t}REM#Ly>4W7dFF{~0^aRu7Y*dMYF?e#?{rOgr~@=0z4U8dT^!=V)kGsPgf*>>#|
z=moUEZGOULd`I-fjmM+^LQ|GlL`-bsUbI^%mYo)~GM!?qpGAE7rx^0oZ?%|?I313&
z5R?rfMm7?B)qMRt3_OV@!zbel_sXM-ypB)p)P;@g_lI}?&ILTref#gPH%PC?0mLWi
zB9<-Z*j9ebqPC3BO)nz}yw3kc2M0%<JpRoh`;>-mM{q!^9F}P2Hf!sHJS=^H7MH1o
zFkCPl{NPqSm|1AXinvE@Dl*AfT>s?CCdON7VC*6#grzX1o<neegoRL6h*Gq?PiMGJ
zLQ@-lGuvvZY@U574RWN-bComvtTqQIWf=i+A``=i{`rpUcwn4q(IeRYQCsKtJUp9A
zPUFb;;7+NTkN)qG2Eb;|Qg1pooG$o&pg3rZ%xp9Bv)T8a+aTqJ>g6&MnjtgliKSl(
z=Iw#9Au+6NoFd}S@R204a(sCX{Es5#g&NEyay%1f$UGpC-}tlmJO@SL^|z^Vi>7h8
z6T)+Bn!oyRIGcx@-!;O`@P3mBZI7?q$iEu|JHjPzU6wq9_^8M}R8b>D742q~pK+B#
zzqr1SdV#|T@m>zR<l08%L?l;<;AkI6z4w#Xy^Om5poBPAqjfdB)y88L%gzdHQArf9
z`LU3A*1bn;8;PvfI95}Y2A8XZ@TTNhJO7!t+qF=Pzz<5-RMX@WCET{gEto&6av>}z
zi6mnNb87E6k+R_CDc&}kf;GC@r-?~tTxQ2l+!726!Q@dc$oD|3luM`=p8tt9_Y8db
zH;`-iey_iB=iKmqmQCsoQfey8<i(;}xmJ50|8eutb{rr75=jO#goY}&z?^3W{&2f2
z`JttSWQmI}3diiRIO2$#HD{GBf_F8S;;;(lOpy<RA;YqMG`CHqiM+&YE}6ye)oCX+
zV!+(iN*8#p^JlRDPLeA>^cOMArQ1yuKi(4lnj2{3Jy&Vk?HWi@WqAXEMOm3o-uJYn
zgTU)<NSBg8of`L|bbhIbzy-W0jjax(ko{OjuiMG=;o)_#=zvKm4Ang)V*Wa#XJc$0
znVBTmv71RrYIUJ6K%1^`5Ec8SKA6H%UabNm01*`6VeXm@hgav*e!KpuhusxxyE!^|
zkJ~wXASIQtKk&;*hyqtcfIeaPypk1NubAZC(im;?Da6uT04D@%41Erd4?Ya56GXGG
ztp1=|A(r^!yQu&{X#0Kb$Gl~?M7DWjPF21&nh_BQl)<L6=iPe~GLyke=gS}_`0ZS+
zFb*>cjtVLO3b{b!eA-*6QQ1q@hK)7;5{6c}p_i5y)AJNwFj*%~n}zvR=ZMabx3ev)
zVVo$zjG#4q;9<cX&juz3CyW=Dr==G{k;ej+3#^Qj7xx^N;9yVt6!JGspjE;x;C2-U
z-gZWRSSf$hEBNW!9B=S+L6j$l@AdrK=Nvu%HKww#5cY7U4rI?;8Ltw!1b^KbjO6Fs
zq|xMVZN^Jo@4rs-8F=hoP$6-O)>k>dTqSCR!q`RW`A!y81zc*{b$}NiC>qkR8&w!)
zfwcQ%;b~~>VyZK3C|hWl04_E{!ZaVPQ8sC125B@LzA-(5_<9*WBXZ=d6%Ux*qQbyR
z84ss=)ppis`I{=Zkbw^t9>WZlhOY&Ju($lnLe=hwBydO-IhNp@NKD(H<It?*u-!E#
zZcR<X$EQ5+GoSe5QA%;{m?o3~B{oVbtL@I!7b@4tREM$&bqJy`raO#N1}eRlI}&=q
zhQ65p2~kdxcIW2O?0sG{P5AB*5Xq0V<mf(BYfVOXr?Av%@>F9&561(mtY^#zRhI?`
zs_lnApr0dLpbnRH#n1p<R(geL>h@T0;)>y3K<8rlK;pk2zlnc(CY<8PzdGVBP@qwF
zr2pZU2R6})zunhYep6X4h|tatGRZ5|W*|Z-+0gT8ej)B>zo}58u+XMNAekPCF5+>=
zn8Hju&8JLPlG?-iQZjBWAy>`wXRbi$u>v@Ky)3&`yI+SzFepkq6C8BZp9hF+YB*(j
z10yNy?^+D5`-z22QVcSl{(8VwjS%YC?UJ4h;K5)Gb*6gWcAYEtzb()A-&$)lnYiIA
zDZOTmfAbFCi1*A4drRoO4daI<_B}lSf#L)pAoI)PYD2Ie(e6<o*bufjGO)VtgL61D
zr53qzohLG+bSDkCPDw)W@%>%ORJfHMjR!=+ydGwG@)M6qSj2+;)EAWUIl=hjW{1Lf
zpM@=8g63PbNWdMCSuWsJ>pxz4OEA6u)+EzdD;zrUwa+JZW8~XTTPWS4k^8nd_4Dsj
z9nearn;aC>4X3SPZ~QBi=H5g9mFD5=*oS6NvwvGA|6@~=A>Y7dyJHR1iY;6gAW8}y
zA%8p-U04&UWvv^(;>uc&kR49m=s*6n=N`3wf&!q#;$Qc76m5JJ1_4iSeU2=|qz2!2
z$5S0jvx;gbI|>`nu=g5d#;$SQBMp@~AoU~|N}+%VBgb2`JkJVqc&_buYj(B#*%I<g
z#NF<4+wyx?wa?w;WHzOKr1%pwC`Zo~|Dl^yQyW@~H!;M<{5MHjl<8P&euMMDV0hUv
zx3}b!jii_VSinl0#LJbNPBDqA9GoA-@0Ms0jL6`uS<p~a-e*MyUkDj0{c)GY3{3u}
z??k#NWpBcgf7_63_3RKc;1VRLXnvrny^OedYy`jfg!C+idC>k{fHduv??DWe?jku6
ztu!=Pwr+c!NFqCKZpAhFma#^O8nhDfA2i9i^NTs4#|MpnTX$)3J72yY&iD4{uG)QW
zAg0M2>8X3nJe1!R!8`t_9J#aD=Y#dk>dD$HK^`$H%ToMJ5TsHlG;zQ2NaGb>LBN!x
zjyxf$YyM0yCJu_WlF+wC?ZY=Jal4Kd4=WRjZk2=Z56ycdl?L9%2GPu}68nu2wmlx*
z3s*cX1&XOY{8<TtxYAX~zRcq`OVR)Si~ko_Uu0u98u+3X1^!<9wEI?s)Q{41!_5*R
zk;L8BhPm;=>&le6-uJD0dM3fT#m#O5>`<2U<d|19B<Lc@WPH=#u;}1Yi3;0IGGVC$
zBewd>^j+&NXJ&7=F;(U{D)wR&WTv+6-4u4wCq={e$-*?c0h;for6GJou$9s~>3YU4
z#F8#qJZ`Ye;QN+sv7I0w=wi}h!fMu;;xZM5F3GKtlSETNg?=9n0e7weZLmib5CwI^
zLgp&xS$G=JkDcl8S?l+fkc7VpIxM%w5Qza!z9n5B8|+*T-B|tSXhVZ7znjXVVCVJ|
zoJbTD5b7d>l0aa!K}?O+PBEaH43omyN&XgE=22~@^+6HjsrnV+Xb_vT!ySs{jw>%4
zQh*&~Ny@ZaBy}&<DThiFi9HwOhL`_FILC~3UMG8FNnLWHnf|4$#IA7eE`kma?Yj-3
zl5N)}-0XT0Rs7y2{1)J61Jl}=7N>W~#q-WMv#ni<<H>8<m<1f|vz4+(?J4xWpYKNL
zGdpT~J*{YRb8y#{7_qmikQb+ON+9p!^QCsMO*AmecZ1*GDC@#Q1?#_mHR1dgtEUqh
zowlql*AgmtYzS<Y<aw$XJRw`yqaASBDD*P6<6gQqolG$kuoA(@X}ZdNW=Ig4KWHm!
zJk<dgUzaXh00pP^=yUlfOW6A72&@v-598`d`sY;M+{c+qN^3-KQCtodBgX3(eUF(1
zO>x)?@Oj)$$E^%^p3{Jf3u|nxF88%q^(l1VW3B2zF4SqT0(H{%HzVj;+Ybkdsp*U!
zOjJ~YP53EGXs+G08f_L_BiHU1z@yz0*ewPNg<yQpDp+X1-D;=0_r)OKo9l-q5Bf(U
z?k>Rqx#+mt6*eW}n~g7x_IkslumM&Alkm29_GY(f{6G2p#%==4U5t$2-jbW1rLIqS
z`{}+Ggt!I#qymz*PV&mv5XL|&5N~z@oUG=ysWlA){>G(+k1`2S7pCIMU@f2jFaHn#
z?+FMZ|4ptP3q90}L}81tt*bBMUKhsWO|YU5hhouViRTDjM%t=%NBC7y^&Z7o^c=E)
zWI|M!BhIXR^gDiLfofQys%(@<?SZy&iifl>9pR3fBFb0wvOGr`cG-1_Jr!)jsAy^c
zxRHTfyFT*d$3Fh$@&0~!^KCZ6ow%^b3}=9A$r<(1E2L@TdS$NXY1^osBZm(4jU4XT
zw)~3AFKcLNSt<2ujRbv}t>jpBh?7C#Q+S{u4gvF~o$`tQm2tE^Vei!HYnW!+IT0!P
zVu*va^t``9kV@h!t*qmVBaq-TzY_D0q>dCXia!f^Xin*j@QlwPQKBKzkhtmelR2cw
z%x|@QHcX`B_ydElymH5rAN%;1CypN%&%i`_lm%W2uN@rK)$<reNpc|*=swlR)H76)
zez_0}NMH=_-+yp;|Ndv!-hA`b09NvQ3B;c`0VWj(ZD$43h8Z!;A-Gntj2$k!Z4&mP
zy1f2KMvd&UsZd)d7TF$p3;!o;1i`l~?mR{vSV?<{A$g6#_(erDV_MpHy<<E$)jMhr
z!|${`wG~g|92{Kr#O~d<KYhpVe<gSZz%G(=3u;yn4xds*NR^?qhn5SO06RdcNhXVg
z`e`jji0>-^{K%n0M~C+AeRRc@SDx3{+IlumK>Wd=WL{%P5yKu9Ua?YiO)z4}5Fcr(
zu^2fhkFmgV9xBbCcq1N4dMb!XomZyCu}hmEierjz_6HJ4==jiJ{9JbA2`d9z91F}O
z46+_taD#TXj#`aHiWk8w(Na7=Ftm5?2R41=_HQO@2DbS8S4z4mmu5***#^prQNt`*
zrnEB;n$x&+ken8#h}KTN`s#_%p5CWd-*EjpSE;N=Frggw=-Hvf)h3os6eapm3A{^r
zaJ7Q+d()x>J^&KMvkPnJIG}|y37o|BNN|hiwVaOYSQ#RTD$LQ7ID~_7n!e=O(cwZ6
zBjHh8uq4O4MVg}``e>mM`bQd~A`$Ogz)SFBB@84>m?~``eL{Ueuoy3l?Pq584ei@^
z`_sR7$A5%u63dQYQ_ncFfu7A1<QCoRb<Fz^v#kr#(1$fNr+qxQLw!X3@PPvZCw9O5
zAFHmtc5$Vt`4R^-uzQfjZTwt|Pn5x>uGq(un$p+g!RZaTs5qgqOsositD%@=p_C$7
ze2OL3uR)R!Q#%!08&;U8+aU@{Y%6;UQKLXIOnoB)x`<UhbLMY69;@G*F?7W#3`Rkk
z6!<`SDL6|nC!Sd9=!_WE7dr1^_v+Z_6VH6|lfU}n=l*VU*k_39NOF^lP`J(tL0;ei
zE1M-{Ye3oE@Stg|mLiIzJ>RFq<lLGA;6@I0j~{*R2T!<$%24OI=UffvTEw=Qz=Rgf
z(Mv?jZ8JhX3@@>@9tF_$MH7XUrW<3XB|f*tRV|<>l2}7Ti>tH5tP|!CP7E*3YXQe)
z+H=UFJHUzH=gu-k{2h%c^|X^LNVx=#JXaztUlTghdNU6W)#<U(d$!(r=j}b4Ht&QA
zW-2#11Dq-byU(;<n8hB3l_>UUpoi%u1_R?xIc;SjPurLQGYEPBm5F1=CwiZF@~K5<
zoN=)8?6WTi(CKKxqxBCHp9;2v))n{S6%d8hNy?Cf3=WCVB+4P72xM~0XRu<=MEK$z
zuM@l~nuJYdcyi>Mg*H9=!}uW{eQ?5IR}N(qPpv4^z_s4gmG={TiH6)B30n}Q)sNJw
zGynMPAAIU}4sY6g7-hrBY)p@9=VXo%&lz`@)aR6_Qtz~D4lx0q)7I2Y<wCEV*OB^2
zaNo1f?rdsb@K|$a=S9tn7Oe(Qk#I$0eVeX}p-WT)>kZ-=2U4D*d(qD9fTtcLh66D_
zu1pd+7pv!Ktk@v1hub0GYrckUaWZWRiHB5i2o&E+R6U{4PKe2*q+@%VY)IEYN>0Fu
zMKKZb$Ty}T!J~lbd-mS*-T(3IAO7Lz>Kx&gk{asV8Z}iOpuTa>c^Bh38j^=Bv^nG$
z=`@>^+o|UNYnir4+IwHE*7}}#rtj!;&p)*C+G`dzFIaG?2P*6#<n1fF*kw!Qf+e=v
zt2YWO%B=irjc^Q|A_xkpVtYq|Z3H0T5}iXbZVYou=G!Wgq8I5li*kCddTima*E8u|
zYG*P`1|RLCVI&{a%k{B%1CY7e(*5Y8AKZH9U)(n}G?eZ>=MpqrQbU~f$q9YVs7u?@
z!n*-^i$9-msovi--O6&AdX!v<RRQ292M33HzyHJ|tzBI^7oL9lrIp6UrKJUMammq$
znPBxGqA+^R;YTs&$#De^jZ)#E@I^xm>xIhdSS;?Py~+&r4gGS*D0n*Jn6r#!>!AXy
z07`8@hQ{LIO&|8wfg5n8sV!ZPoIH5&|2+1g5B<i0d+*!rXJ!B<$|i2uYR`3CDECed
z_fJbs9!=Uc7v6BG=Ru5Rp98_%$7Vgs1cK|PM@FiLAA5X9bz*$WvNv3|rqa-GmWQu^
zLMESD{7^69jm%q2d3yQlgG|}Yy(sM7#gnk<dP38XE+QO7f)?h{;1Vnu!vm$y-AG;G
zab&U2>0B2%XK09_qQG#_UE}cABc6mcyUDO)Azjx{=xCA*L__p0(k2<JHdWm{cI3z%
zPkrJOe=~BZdj#I|ZZgOCy!j@wBdkdy7rxF}1BUPDf1g|%IBD9|WjeE9^MGvq)3&)j
zyla?li17HOF$Z4SacHc!=UWYJZ9|JrU$X(;FXja!FRZO4)qM;bQhDp?MX1;^bNnvQ
zMG+$G;BCmls!|Fpdx};+-Qoc5D~y%!i=J>O6Q9PgNpOfEi4Do5M+R;j(~M=6Kn#U3
zB!L%s8XS)`;edOd`}F^Q|MQ>u?53%qA^yB%F2YFV0kFoD6^Ugp-5gG3F(-f7Ykp%6
zD2F;+e4S_MeQu{Z)lPn%=7dwv;sI2K_U@bRd-|E@+gGmI)Y93xrm?N<bO22NiU}xY
z5;9puwIhqJN>PfRp@J`K22n1~YL(xI$YfW%8gd@T$NJ)7vbHrdr`Z{pw$T^G7?BU)
zv5=C-D-FaW!tkS%BnZTK;Y(D$P;VnCE;SGTa?hsCzq93!{`jws{NM-uC<|_`q;t>0
zpIUPe%v{Kn!a}A$dngZ}l9H2K$mGg=+RfFb-mdnX*Gn(BVBy-g-26-H-}9c2d+*OG
zgoLFBD6Cp}5orqThI6Jwc650GnL9#Vx0qNwR6)crRRP#1vJppZITS08MGzfBwEVD#
z@lqCe?oooNsK)rnB48_qCr+IB*WGu0?XULTbI-o;;o;dzDhKuC0w~Kvu5CT|bCu{J
zI8*{`+?87Xv>iW7`>`j;{Y}FohMCI*#D3%b{S!xi@Z1a4v9WKpb}ngaJMFYJ02a!T
zh-k?;#?M&H5KK`h<RXQ}+QyV6Q!hf4+x*fnrD$p`IS51=*0CaS2*e9|AxJ%g;^hGS
zMijx5(1?wMJTsX(fM_D`LB=6R1AvLz%*^H=ef|p{c>Xh={mRkjpFdiwR(U>o?zt|V
z<D7t}-o<75)+?#(rQU<Bl6R%<^DFb!$k{Y_zIC&fwq?s&S6p?~RhNJKW1n=D%Jl%6
z=j<fKY?vipq!i1D#ii?PI}W+h24-+1@lgG+CfhsN^eWLXH;g>35+>E7p?vLYwF4)1
z?fR45U;Fy^x*vON0Q2|!vz1eph1Uqfw0W%x@slh+3Bs}Lvdfy!e%HI+y5@!(eiIHi
z!Tbg{ZA_Vx#?x#a=UeIsUXsFO>zuwdXY?>VK4Q|Y?BUYbKcl4aFTHCGXOt-o&r+r0
zO;AocgtDjm@lAif_uJq8O8?fa1EH>-K}4PUG%NzOP5aH(H`fM9T@J3fcC#RzD>>IT
z8v*qYov#<k5tQN>`!%$*RF+<F!O}}^|Hy3%*R1()V_Vw=5RXx^>>4@&utpCVtINC2
zX`53h^}dz#)9N>07_%&p(|)z;_;~k7clX`f{`PbKG_YgGo|(zXYQAT-ycQ2}su9U-
zeP(S_kHa~^PVeW^$a+ZB8{;QgDyQFYefybjed{l-zV5nr!~2`yTq8Fq#q*fWU5bTI
zEHS~M<!`v=u%q;i5a|qFoXDcuDkDrEGkP}a(lN_n4(}Z>?O_j{yr^AfN4j?Oe*cMk
zUwz<#&mZ2j`5;a$<UJJ`sb?fp%RZN}oo|VKax!o#8aLNsXtw*=6k@Jt^CGyhy}h#N
z%(b1De)OZ)Hnz5Yu;c7?S39`noW@MW$BL27&EyZRg|<!w$SO&AURo-YRWMzuX!<j0
zlhDaa4<C-Bt5b8Obxpdd2pTuSR2oKRCMI?b?cMv;7ykOMzkTx6gMHPpu_???XzP{P
z4CHKmb79qNV{p5AvR5}`N*mTge71JE@N2#y*=!bKHjh>B+Q4k?>}*|g<BeBc{97M>
zcSB3dF92?(2o0cdJD|4Iob4$IOg{GKVm1Y5X?H5cu0JyA;yE%~39yW(i2Wy=a}OWg
zy7jC3zWcpLyB~SvXwv&9vi8fs%gv|U17)S)XX*1(3C$|N{6nVsl({ShP!{spT-<y-
zRXrD47ng?C*2?;Kzq@nEh7Ipp_J&K}*|K=?72f;hIl<!3$(VXR%26lzR9I`+Oi)k|
z`|Ct7^@vNABy2KYDd6=?d66Ac!p@u1s@gY$OVMrw-tRc^$}5j|Kl125?D^KWy8TSG
zTAQxUwMgc2s@cQ2p7A)d$(FR6%M)<hQb`xpKaF_)$0<KmoVqT)xTCqF<D!c{@>{pG
zEMEMs#sv%3JLj6g%*(_m$tnV=u$h#liG#x5+#&!duWHTW-5aGaY1ard$)?FOY0aNQ
zjGh2fzB)ZHGdcM{&-b7B&f!g)whr#u(>K=FSHt`kwLeaoD<d^q-E4hc^EJ;v&J{_S
zEwhvo#<1#ngtYH`ke;s<nX5j<H@3Uv_K#fO*w(i3b#H(BwE(X09-V+q?fa63<U^A5
z175l3b^8IO4ZHc2QwW)+0K7Qb*SEFzi6<U9zWt>K4n6$v7+$*-|4Av!d?JB*eddef
ztk*8{Aa_3(5~s5GmhxJZX)gG$6-K;w4GopfbIw`XzGB6i3qSblR{^-CZP~Jm8r$2u
zoO2!UXq5LO%#N}wsy#{{?k!txXqd$n@k+b_FVcaMUkc5n=%T)85sz^LBMxqG?8uQl
z)$#GiUi#wyeRS-|kpt5sBS%NNyXBpP`3TfpVd;G2;#B8yHavdf_@o}<r{xxrfjt*v
z<_l-G_NTI_s#{jS=}n!B&N}n5=0zPBo%hS{yV84H1mIi%?RLAu#Y~T8eUOAt0=1kL
z)nnfD3H&-aCC=CuSyX}nR|EV(z`Z!y+xz^!?|yd&fET(SeeB?9PY-8^Qu<%3u%60X
zzLv4)S_{k-P0ZIQ;>Yn2z}!s8c?K!7g;Dj!%e6U`kn2>}O9n4jsZ?5)E^P(S3ZV6h
zPkj6`*VuRwfJ>HcxL|G5g7!`T9p3v6=Um5Jz)OpE<g*-l<eE~!MHXlTz~J=g*x<m<
z9X$Yc19-lF>kqdcxc~kE028(8>4~YKq3SF&pKAS&(@x4<o_enOdJ)HLkw^~TlKj2a
z{NJg1li39EwZfY3^-rsqF;-rC&BEr6j^zNl<p1;E|NgZdXPvnWaBDo!<$&d(-#WlI
z))9YD{Xqa@Mabj(05{;hKX~BYdk^(*+jb1VAb`H9;o)O_PdzPZ(bpPN&nHfwZ+R{J
npKp{<Pf>s}-Lo0`?0EklyRiJlJ$mJH00000NkvXXu0mjfgB0Lv

literal 0
HcmV?d00001

diff --git a/ui/app/images/favicons/favicon-32x32.png b/ui/app/images/favicons/favicon-32x32.png
new file mode 100755
index 0000000000000000000000000000000000000000..6652b911a7d74526e37a3dfeb8e6b67b9707e097
GIT binary patch
literal 1728
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
Wc#fc9JXy~G0000<MNUMnLSTX;dr!as

literal 0
HcmV?d00001

diff --git a/ui/app/images/favicons/favicon-96x96.png b/ui/app/images/favicons/favicon-96x96.png
new file mode 100755
index 0000000000000000000000000000000000000000..ba4ab8cd0fbcf5ba1ed799909aa32c8c37780626
GIT binary patch
literal 10749
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

literal 0
HcmV?d00001

diff --git a/ui/app/images/logo-small.svg b/ui/app/images/logo-small.svg
new file mode 100644
index 000000000..05d7d7f0a
--- /dev/null
+++ b/ui/app/images/logo-small.svg
@@ -0,0 +1,59 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 18.0.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 130 36" enable-background="new 0 0 130 36" xml:space="preserve">
+<g>
+	<path fill="#151632" d="M49.9,24.3c-1.9,2.7-5.1,4.3-8.6,4.3c-5.9,0-10.7-4.8-10.7-10.7c0-5.9,4.8-10.7,10.7-10.7
+		c3.5,0,6.7,1.7,8.6,4.4L46.2,14c-1.4-1.2-2.9-2.1-4.9-2.1c-3.3,0-6,2.7-6,6c0,3.3,2.7,6,6,6c2,0,3.3-0.7,4.9-2L49.9,24.3z"/>
+	<path fill="#FFFFFF" d="M67.7,20.2c0,1.2-0.3,2.3-0.7,3.3c-0.4,1-1.1,1.9-1.8,2.7c-0.8,0.8-1.7,1.4-2.7,1.8
+		c-1.1,0.5-2.2,0.7-3.3,0.7c-1.2,0-2.3-0.2-3.3-0.7c-1-0.4-1.9-1.1-2.7-1.8c-0.8-0.8-1.4-1.7-1.8-2.7c-0.4-1.1-0.7-2.2-0.7-3.3
+		c0-1.2,0.2-2.3,0.7-3.3c0.4-1,1.1-2,1.8-2.7c0.8-0.8,1.7-1.4,2.7-1.8c1.1-0.4,2.2-0.7,3.3-0.7c1.2,0,2.3,0.2,3.3,0.7
+		c1,0.4,1.9,1,2.8,1.8c0.8,0.8,1.4,1.7,1.8,2.8C67.4,17.9,67.6,19,67.7,20.2z M63.4,20.2c0-2.4-1.9-4.3-4.3-4.3
+		c-2.4,0-4.3,1.9-4.3,4.3c0,2.4,1.9,4.3,4.3,4.3C61.4,24.5,63.4,22.5,63.4,20.2z"/>
+	<path fill="#151632" d="M79.5,11.8v4.1c-0.3-0.1-0.7-0.1-1-0.1c-2.3,0-4.3,1.8-4.3,4.9c0,2.1,0,7.4,0,7.4h-4.8V12.1h4.8v1.9
+		c0.2-0.5,1.1-2.3,3.8-2.3C78.5,11.6,79.1,11.7,79.5,11.8z"/>
+	<path fill="#151632" d="M88.1,15.7c0,2.4,0,3.7,0,5.2c0,3.2,1.3,3.1,3,3.2v4.3c-6,1.1-8.1-2-8.1-5.9c0-1.8,0-3.8,0-6.8h-2.4V12h2.4
+		V6h5v6h4.4v3.7H88.1z"/>
+	<path fill="#151632" d="M109.6,25c-1.8,2.1-3.9,3.6-7,3.6c-4.4,0-8.1-3.3-8.5-7.7c-0.5-4.9,3.4-9.5,8.6-9.5c5.3,0,8.6,5.2,7.8,10.3
+		h-12c0.7,1.7,2.3,2.8,4.2,2.8c1.3,0,2.5-0.6,3.5-1.7L109.6,25z M98.4,18.7h8c0-1.7-1.9-3.1-3.8-3.1C100.3,15.6,98.4,17.1,98.4,18.7
+		z"/>
+	<path fill="#151632" d="M128,25.5l-3.1,3.1l-5.4-5.5l-5.5,5.4l-3.1-3.1l5.5-5.5l-5.5-5.4l3.1-3.1l5.5,5.4l5.4-5.5l3.1,3.1l-5.4,5.5
+		L128,25.5z"/>
+	<g>
+		<path fill="#FFFFFF" d="M27.2,18.8c0-2-1-2.2-2.8-2.4c-1.6-0.2-3.4-0.3-4.2-2.6c0-0.1,0-0.2,0-0.2c0-0.1,0.1-0.1,0.2-0.2
+			c0.2-0.1,0.3,0,0.4,0.2c0.7,1.9,2.2,2,3.6,2.2c0.7,0.1,1.6,0.2,2.2,0.5c0.1,0,0.2,0,0.2,0c0.1,0,0.1-0.1,0.1-0.2c-0.3-4-2-6-3.4-7
+			c-0.8-0.5-1.4-0.8-1.9-0.9c-0.1,0-0.2,0-0.2,0.1c-0.1,0.1-0.1,0.2,0,0.2c0.3,0.5,0.5,1.1,0.6,1.7c0.3,1.2,0.6,2.3,2,2.6
+			c0.1,0,0.1,0.1,0.2,0.1c0,0.1,0.1,0.1,0,0.2c0,0.1-0.2,0.2-0.3,0.2c0,0,0,0-0.1,0c-1.7-0.3-2.1-1.7-2.4-3
+			c-0.2-0.9-0.5-1.7-1.1-2.2C19.6,7.5,18.1,7,16.8,7c-0.2,0-0.4,0-0.6,0c-0.4,0.1-1,0.2-1.5,0.6c0,0-0.1,0.1-0.1,0.2
+			c0,0.1,0,0.1,0.1,0.2c0.6,0.7,1.2,1.6,1.7,2.6c0.1,0.1,0,0.3-0.1,0.4c-0.1,0.1-0.3,0-0.4-0.1c-0.6-1.2-1.3-2.2-2-2.8c0,0,0,0,0,0
+			c0,0,0,0,0,0c-1-0.9-1.9-1.1-2.4-1.1c-0.2,0-0.3,0-0.4,0c-0.8,0.2-1.3,0.7-1.5,1.1c0,0.1,0,0.1,0,0.2C9.7,8.6,9.9,8.9,10,9.2
+			c0.4,1,0.7,1.9,2.4,2c0.1,0,0.2,0,0.2,0.1c0.1,0.1,0.1,0.1,0.1,0.2c0,0.2-0.1,0.3-0.3,0.3c0,0,0,0,0,0c-2.1-0.1-2.6-1.4-2.9-2.4
+			C9.3,9,9.1,8.7,9,8.5c0,0,0,0,0,0c0,0,0,0,0,0c0,0,0,0,0,0C8.7,8.2,8.5,8.1,8.2,8.1c-0.7,0-1.3,0.2-1.6,0.7
+			C6.4,8.9,6.3,9.1,6.2,9.4c0,0,0,0,0,0c0,0,0,0.1,0,0.1c0,0,0,0,0,0c-0.2,0.6-0.2,1.3,0,1.9c0.2,1.2,1,2.6,3,3c0.2,0,0.4,0,0.6,0
+			c0.5,0,1-0.1,1.5-0.2c0.6-0.1,1.2-0.2,1.9-0.2c1,0,1.8,0.2,2.6,0.7c0.1,0,0.1,0,0.2,0c0.1,0,0.1-0.1,0.1-0.1
+			c0.4-0.9,0.9-1.5,1.3-2c0.9-0.9,1.5-1.6,0.6-4c0-0.1,0-0.2,0-0.2c0-0.1,0.1-0.1,0.2-0.2c0.2-0.1,0.3,0,0.4,0.2
+			c1,2.7,0.2,3.6-0.7,4.6c-0.5,0.5-1,1.1-1.3,2c0,0.1,0,0.2,0.1,0.2c2.1,1.5,3.2,2,4.3,2c0.1,0,0.3,0,0.4,0c0.2,0,0.3,0.1,0.3,0.3
+			c0,0.1,0,0.2-0.1,0.2c0,0.1-0.1,0.1-0.2,0.1c-0.2,0-0.4,0-0.5,0c-1.3,0-2.6-0.6-5-2.4c-0.8-0.6-1.7-0.9-2.8-0.9
+			c-0.6,0-1.2,0.1-1.8,0.2c-0.6,0.1-1.1,0.2-1.6,0.2c-0.3,0-0.5,0-0.7-0.1c-1.8-0.3-3.1-1.6-3.5-3.5c0-0.2-0.1-0.5-0.1-1
+			c0-0.1-0.1-0.2-0.1-0.2c-0.1,0-0.2,0-0.2,0c-1.7,1.6-1.8,3.2-1.7,4c0.1,1.3,0.9,2.2,1.6,2.5C5.1,17,5.4,17,5.7,17
+			c0.3,0,0.6,0,1-0.1c0.4-0.1,0.8-0.1,1.3-0.1c1.3,0,2.5,0.4,3.8,1.4c0.1,0.1,0.2,0.3,0.1,0.4c-0.1,0.1-0.3,0.2-0.4,0.1
+			c-1.2-0.9-2.3-1.3-3.4-1.3c-0.4,0-0.9,0.1-1.2,0.1c-0.4,0-0.7,0.1-1,0.1c-0.4,0-0.7-0.1-1-0.2c-0.8-0.3-1.6-1.3-1.9-2.4
+			c0-0.1-0.1-0.2-0.2-0.2c-0.1,0-0.2,0-0.2,0.1c-0.8,1.8-0.4,3.5,0.5,4.5c0.6,0.7,1.4,1.1,2.3,1.1c0.7,0,1.3-0.2,2-0.6
+			c0.1,0,0.1-0.1,0.1-0.1c0.1-0.4,0.3-0.8,0.4-1.1c0.1-0.1,0.3-0.2,0.4-0.1c0.1,0,0.1,0.1,0.1,0.2c0,0.1,0,0.2,0,0.2
+			c-0.6,1-0.7,2.6,0.1,3.8c0.6,0.9,1.7,1.4,3.2,1.4c0.1,0,0.3,0,0.4,0c0.1,0,0.2-0.1,0.2-0.1c0-0.1,0-0.2,0-0.2
+			c-0.8-1,0.1-2.1,0.9-3.1c0.8-1,1.6-2.1,1.3-3.3c0-0.2,0-0.3,0.2-0.4c0.2,0,0.3,0.1,0.4,0.2c0.4,1.5-0.6,2.8-1.4,3.8
+			c-0.9,1.2-1.4,1.9-0.8,2.5c0.3,0.3,0.5,0.4,0.8,0.4c0.4,0,0.9-0.3,1.9-0.8c0.8-0.5,1.9-1.2,3.4-1.6c0.1,0,0.1-0.1,0.2-0.2
+			c0-0.1,0-0.2-0.1-0.2c-0.4-0.2-0.7-0.4-0.9-0.7c-0.4-0.5-0.5-1.1-0.3-1.7c0-0.2,0.2-0.3,0.4-0.2c0.2,0,0.3,0.2,0.2,0.4
+			c-0.1,0.5-0.1,0.9,0.2,1.2c0.3,0.4,1.1,0.9,3.2,1.1c0.3,0,0.7,0,1,0c1,0,2.2-0.2,3-0.5c0.1,0,0.1-0.1,0.1-0.2c0-0.1,0-0.1,0-0.2
+			c-0.2-0.2-0.5-0.4-0.9-0.5c-0.6-0.3-1.3-0.6-1.4-1.6c0-0.2,0.1-0.3,0.3-0.3c0.2,0,0.3,0.1,0.3,0.3c0.1,0.7,0.5,0.9,1.1,1.1
+			c0.4,0.2,0.9,0.4,1.2,0.8c0,0,0.1,0.1,0.1,0.1c0.1,0,0.1,0,0.2,0C27,19.8,27.2,19.3,27.2,18.8z"/>
+		<g>
+			<path fill="#FFFFFF" d="M22.4,21.6c-0.2,0-0.3,0-0.5,0c-2.7,0-4.5,1.1-5.8,1.9c-0.4,0.3-0.9,0.5-1.3,0.7c-0.1,0-0.1,0.1-0.1,0.2
+				c0,0.1,0,0.2,0.1,0.2c0.2,0.1,0.5,0.3,0.7,0.4c0.3,0.1,0.6,0.2,0.9,0.2c0.8,0.1,1.4,0.2,1.7,2.4c0,0.1,0.1,0.2,0.2,0.2h1.5
+				c0.1,0,0.1,0,0.2-0.1c0,0,0.1-0.1,0.1-0.2c-0.3-2.1,0-2.3,0.6-2.6c0.2-0.1,0.4-0.2,0.7-0.5c0.6-0.5,1.2-1,1.4-2.6
+				c0-0.1,0-0.1-0.1-0.2C22.5,21.7,22.4,21.6,22.4,21.6z"/>
+		</g>
+	</g>
+</g>
+</svg>
diff --git a/ui/app/index.html b/ui/app/index.html
index dd66a60c0..4cd7775ad 100644
--- a/ui/app/index.html
+++ b/ui/app/index.html
@@ -9,7 +9,11 @@
     <meta name="viewport" content="width=device-width">
     <meta content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no" name="viewport">
 
-    <link rel="icon" type="image/png" href="favicon.png" />
+	<link rel="icon" type="image/png" href="images/favicons/favicon-196x196.png" sizes="196x196" />
+	<link rel="icon" type="image/png" href="images/favicons/favicon-96x96.png" sizes="96x96" />
+	<link rel="icon" type="image/png" href="images/favicons/favicon-32x32.png" sizes="32x32" />
+	<link rel="icon" type="image/png" href="images/favicons/favicon-16x16.png" sizes="16x16" />
+	<link rel="icon" type="image/png" href="images/favicons/favicon-128.png" sizes="128x128" />
 
     <!-- Place favicon.ico and apple-touch-icon.png in the root directory -->
     <!-- build:css(.) styles/vendor.css -->
diff --git a/ui/app/styles/main.css b/ui/app/styles/main.css
index 89bd2b28f..aa1f40fb2 100644
--- a/ui/app/styles/main.css
+++ b/ui/app/styles/main.css
@@ -7,13 +7,10 @@ body {
     margin-bottom: 30px;
 }
 
-
 .footer {
-    /*margin-top: 30px;*/
     height: 50px;
 }
 
-
 .clickable {
     cursor: pointer;
 }
@@ -26,12 +23,13 @@ body {
 .nowrap {
     white-space: nowrap;
 }
-/*.header,
-.footer {
-    padding-left: 15px;
-    padding-right: 15px;
-}*/
-
+.navbar-header {
+    padding-left: 10px;
+}
+.navbar-brand {
+    width: 130px;
+    padding: 12px 15px;
+}
 .footer {
     padding-top: 19px;
     border-top: 1px solid #e5e5e5;
diff --git a/ui/app/views/components/header.component.html b/ui/app/views/components/header.component.html
index af02acd2a..a681ee927 100644
--- a/ui/app/views/components/header.component.html
+++ b/ui/app/views/components/header.component.html
@@ -12,7 +12,10 @@
 <nav class="navbar navbar-static-top" ng-controller="NavCtrl as nav">
     <div class="container">
         <div class="navbar-header">
-            <a href class="navbar-brand"><b>Cortex</b></a>
+            <!-- <a href class="navbar-brand"><b>Cortex</b></a> -->
+            <a class="navbar-brand" ui-sref="analyzers">
+                <img alt="Cortex" src="images/logo-small.svg">
+            </a>
             <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar-collapse">
 				<i class="fa fa-bars"></i>
 			</button>

From cb73cb053f6562d66aff3eaff4ca9c7f88e8fc42 Mon Sep 17 00:00:00 2001
From: Nabil Adouani <nabil.adouani@gmail.com>
Date: Tue, 9 May 2017 10:12:17 +0200
Subject: [PATCH 24/32] Fix a compilation error

---
 build.sbt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/build.sbt b/build.sbt
index 21c447657..7943f8b20 100644
--- a/build.sbt
+++ b/build.sbt
@@ -36,7 +36,7 @@ mappings in packageBin in Assets ++= frontendFiles.value
 mappings in Universal ~= {
   _.flatMap {
     case (file, "conf/application.conf") => Nil
-    case (file, "conf/apllication.sample") => Seq(file -> "conf/application.conf"
+    case (file, "conf/apllication.sample") => Seq(file -> "conf/application.conf")
     case (file, "conf/logback.xml") => Nil
     case other => Seq(other)
   } ++ Seq(

From c499a2316af20ce4978ab27e8d4fe6109b190cc8 Mon Sep 17 00:00:00 2001
From: Nabil Adouani <nabil.adouani@gmail.com>
Date: Wed, 10 May 2017 17:11:57 +0200
Subject: [PATCH 25/32] #23 Get cortex version from status API and display it
 on the footer

---
 app/models/MispModule.scala                        |  2 +-
 ui/app/scripts/app.routes.js                       |  2 +-
 .../scripts/components/app-container.component.js  | 14 ++++++++++++--
 ui/app/scripts/services.js                         | 13 +++++++++++++
 .../views/components/app-container.component.html  | 11 ++++-------
 5 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/app/models/MispModule.scala b/app/models/MispModule.scala
index 14ef92350..c5c08f065 100644
--- a/app/models/MispModule.scala
+++ b/app/models/MispModule.scala
@@ -1,7 +1,7 @@
 package models
 
 case class MispModule(
-  name: String,
+    name: String,
     version: String,
     description: String,
     author: String,
diff --git a/ui/app/scripts/app.routes.js b/ui/app/scripts/app.routes.js
index 172416d10..2de624607 100644
--- a/ui/app/scripts/app.routes.js
+++ b/ui/app/scripts/app.routes.js
@@ -6,7 +6,7 @@
 
             $urlRouterProvider.otherwise('/analyzers');
 
-            $stateProvider
+            $stateProvider                
                 .state('analyzers', {
                     url: '/analyzers',
                     templateUrl: 'views/analyzers.html',
diff --git a/ui/app/scripts/components/app-container.component.js b/ui/app/scripts/components/app-container.component.js
index 6b873f0cb..be424aaa4 100644
--- a/ui/app/scripts/components/app-container.component.js
+++ b/ui/app/scripts/components/app-container.component.js
@@ -4,7 +4,17 @@
         .directive('appContainer', function() {
             return {
                 restrict: 'E',
-                templateUrl: 'views/components/app-container.component.html'                
+                templateUrl: 'views/components/app-container.component.html'                ,
+                controller: function(VersionSrv) {
+                    var self = this;
+                    self.config = {};
+
+                    VersionSrv.get()
+                        .then(function(response) {
+                            self.config = response.data;
+                        });
+                },
+                controllerAs: '$vm'
             };
         });
-})();
\ No newline at end of file
+})();
diff --git a/ui/app/scripts/services.js b/ui/app/scripts/services.js
index a9ef92a8a..2d1fbf445 100644
--- a/ui/app/scripts/services.js
+++ b/ui/app/scripts/services.js
@@ -44,6 +44,19 @@
                 return Notification.error(sanitized);
             };
         })
+        .service('VersionSrv', function($q, $http) {
+            this.get = function() {
+                var deferred = $q.defer();
+
+                $http.get('./api/status').then(function(response) {
+                    deferred.resolve(response);
+                }, function(rejection) {
+                    deferred.reject(rejection);
+                });
+                return deferred.promise;
+            }
+
+        })
         .service('AnalyzerSrv', function($q, $http) {
             var self = this;
 
diff --git a/ui/app/views/components/app-container.component.html b/ui/app/views/components/app-container.component.html
index b8ef66415..7eb95854f 100644
--- a/ui/app/views/components/app-container.component.html
+++ b/ui/app/views/components/app-container.component.html
@@ -1,5 +1,4 @@
 <header class="main-header"></header>
-<!--<main-sidebar class="main-sidebar"></main-sidebar>-->
 <div class="content-wrapper" fixed-height>
 	<div class="container">
 		<ui-view></ui-view>
@@ -8,12 +7,10 @@
 <footer class="main-footer">
 	<div class="container">
 		<div class="pull-right hidden-xs">
-			<strong>Version</strong>: 1.0.2
+			<strong>Version</strong>: {{$vm.config.versions.Cortex || '-'}}
+		</div>
+		<div>
+			<strong><a href="http://www.thehive-project.org" target="_blank">TheHive Project</a> 2016-2017, <a href="https://www.gnu.org/licenses/agpl-3.0.en.html" target="_blank">AGPL-V3</a></strong>
 		</div>
-		<strong>Copyright &copy; 2016-2017 <a href="http://www.thehive-project.org" target="_blank">TheHive Project</a></strong> All rights reserved.
 	</div>
 </footer>
-<!--
-<control-sidebar class="control-sidebar control-sidebar-dark"></control-sidebar>
-<div class="control-sidebar-bg"></div>
--->

From 5443a295a6d139fc433086059238b6ff2795ea66 Mon Sep 17 00:00:00 2001
From: Nabil Adouani <nabil.adouani@gmail.com>
Date: Thu, 11 May 2017 18:05:52 +0200
Subject: [PATCH 26/32] Update readme to add logo and gitter link

---
 README.md              |   4 ++++
 images/cortex-logo.png | Bin 0 -> 15130 bytes
 2 files changed, 4 insertions(+)
 create mode 100644 images/cortex-logo.png

diff --git a/README.md b/README.md
index 641b6d6de..ad1239b1c 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,7 @@
+![](images/cortex-logo.png)
+
+[![Join the chat at https://gitter.im/TheHive-Project/TheHive](https://badges.gitter.im/TheHive-Project/TheHive.svg)](https://gitter.im/TheHive-Project/TheHive)
+
 
 **Cortex** tries to solve a common problem frequently encountered by SOCs, CSIRTs and security researchers in the course of threat intelligence, digital forensics and incident response: how to **analyze observables** they have collected, **at scale**, **by querying a single tool** instead of several?
 
diff --git a/images/cortex-logo.png b/images/cortex-logo.png
new file mode 100644
index 0000000000000000000000000000000000000000..f35fabe202b40e70e913b9e7d027a37b34cca900
GIT binary patch
literal 15130
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

literal 0
HcmV?d00001


From 90929a1cc4522aa929f66156a1cb3884736595a9 Mon Sep 17 00:00:00 2001
From: To-om <toom@thehive-project.org>
Date: Fri, 12 May 2017 11:08:15 +0200
Subject: [PATCH 27/32] Update documentation

---
 docker/entrypoint                     |  50 ----
 docs/FAQ.md                           |  72 ++++++
 docs/README.md                        |  28 ++
 docs/admin/configuration.md           |  31 +++
 docs/api/README.md                    |  23 ++
 docs/api/delete-job.md                |  26 ++
 docs/api/get-analyzer-by-type.md      |  56 ++++
 docs/api/get-analyzer.md              |  39 +++
 docs/api/get-job-report.md            | 100 ++++++++
 docs/api/get-job.md                   |  44 ++++
 docs/api/how-to-create-an-analyzer.md | 357 ++++++++++++++++++++++++++
 docs/api/list-analyzers.md            |  51 ++++
 docs/api/list-jobs.md                 |  95 +++++++
 docs/api/run-analyzer.md              | 138 ++++++++++
 docs/api/wait-and-get-job-report.md   |  27 ++
 docs/images/cortex-report.png         | Bin 0 -> 63845 bytes
 docs/images/long-report.png           | Bin 0 -> 31252 bytes
 docs/images/short-report.png          | Bin 0 -> 17324 bytes
 docs/installation/README.md           |  10 +
 docs/installation/analyzers.md        |  92 +++++++
 docs/installation/binary-guide.md     |  95 +++++++
 docs/installation/build-guide.md      | 144 +++++++++++
 docs/installation/deb-guide.md        |  13 +
 docs/installation/docker-guide.md     |  50 ++++
 docs/installation/rpm-guide.md        |  18 ++
 25 files changed, 1509 insertions(+), 50 deletions(-)
 delete mode 100755 docker/entrypoint
 create mode 100644 docs/FAQ.md
 create mode 100644 docs/README.md
 create mode 100644 docs/admin/configuration.md
 create mode 100644 docs/api/README.md
 create mode 100644 docs/api/delete-job.md
 create mode 100644 docs/api/get-analyzer-by-type.md
 create mode 100644 docs/api/get-analyzer.md
 create mode 100644 docs/api/get-job-report.md
 create mode 100644 docs/api/get-job.md
 create mode 100644 docs/api/how-to-create-an-analyzer.md
 create mode 100644 docs/api/list-analyzers.md
 create mode 100644 docs/api/list-jobs.md
 create mode 100644 docs/api/run-analyzer.md
 create mode 100644 docs/api/wait-and-get-job-report.md
 create mode 100644 docs/images/cortex-report.png
 create mode 100644 docs/images/long-report.png
 create mode 100644 docs/images/short-report.png
 create mode 100644 docs/installation/README.md
 create mode 100644 docs/installation/analyzers.md
 create mode 100644 docs/installation/binary-guide.md
 create mode 100644 docs/installation/build-guide.md
 create mode 100644 docs/installation/deb-guide.md
 create mode 100644 docs/installation/docker-guide.md
 create mode 100644 docs/installation/rpm-guide.md

diff --git a/docker/entrypoint b/docker/entrypoint
deleted file mode 100755
index 5eda83a93..000000000
--- a/docker/entrypoint
+++ /dev/null
@@ -1,50 +0,0 @@
-#!/bin/bash
-
-if test -z "$DISABLE_ELASTICSEARCH"; then
-    echo "Starting ElasticSearch ..."
-    /docker-entrypoint.sh elasticsearch \
-        -Des.path.data=/data \
-        -Des.script.inline=on \
-        -Des.cluster.name=hive \
-        -Des.threadpool.index.queue_size=100000 \
-        -Des.threadpool.search.queue_size=100000 \
-        -Des.threadpool.bulk.queue_size=1000 &
-else
-    echo "Skip ElasticSearch startup"
-fi
-
-if test -z "$CRYPTO_SECRET"; then
-    echo "Generating random crypto secret ..."
-    CRYPTO_SECRET=$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 64 | head -n 1)
-else
-    echo "Using provided crypto secret"
-fi
-
-if test -z "$DISABLE_CORTEX"; then
-    echo "Starting Cortex ..."
-    if test ! -e conf/cortex.conf; then
-        cat > conf/cortex.conf <<- _EOF_
-play.crypto.secret="$CRYPTO_SECRET"
-analyzer {
-  path=/opt/Cortex-Analyzers/analyzers
-  config={}
-}
-include "analyzers.conf"
-_EOF_
-    fi
-    touch conf/analyzers.conf &> /dev/null
-    bin/cortex -Dconfig.file=conf/cortex.conf -Dhttp.port=9001 -Dpidfile.path=cortex.pid &
-else
-    echo "Skip Cortex startup"
-fi
-
-echo "Starting TheHive ..."
-if test ! -e conf/thehive.conf; then
-    cat > conf/thehive.conf <<- _EOF_
-play.crypto.secret="$CRYPTO_SECRET"
-play.modules.enabled+=connectors.cortex.CortexConnector
-cortex.local.url="http://127.0.0.1:9001"
-
-_EOF_
-fi
-bin/thehive -Dconfig.file=conf/thehive.conf -Dpidfile.path=thehive.pid
diff --git a/docs/FAQ.md b/docs/FAQ.md
new file mode 100644
index 000000000..6d2fbfd22
--- /dev/null
+++ b/docs/FAQ.md
@@ -0,0 +1,72 @@
+# Analyzers
+- [What version of MaxMind TheHive uses?](https://github.com/CERT-BDF/Cortex/wiki/FAQ#what-version-of-maxmind-cortex-uses)
+- [How often are the MaxMind databases refreshed?](https://github.com/CERT-BDF/Cortex/wiki/FAQ#how-often-are-the-databases-refreshed)
+- [How shall I configure the MaxMind analyzer?](https://github.com/CERT-BDF/Cortex/wiki/FAQ#how-shall-i-configure-the-maxmind-analyzer)
+- [Can I use the commercial versions of the databases?](https://github.com/CERT-BDF/Cortex/wiki/FAQ#can-i-use-the-commercial-versions-of-the-databases)
+
+## MaxMind
+### What version of MaxMind Cortex uses?
+The MaxMind analyzer includes the GeoLite2 free City and Country databases.
+
+### How often are the MaxMind databases refreshed?
+Cortex does not refresh those databases. It is up to you to create a cron job to refresh them at the frequency you want. The files to update are:
+- `analyzers/MaxMind/GeoLite2-City.mmdb`
+- `analyzers/MaxMind/GeoLite2-Country.mmdb`
+
+You can fetch up-to-date versions from <https://dev.maxmind.com/geoip/geoip2/geolite2/>.
+
+### How shall I configure the MaxMind analyzer?
+No configuration is required. If it looks like the analyzer is not working, please clear the cache of your browser and retry. If it still doesn't work, please join [TheHive User Discussion Forum](https://groups.google.com/a/thehive-project.org/d/forum/users) or [open an issue on GitHub](https://github.com/CERT-BDF/Cortex-analyzers/issues/new).
+
+### Can I use the commercial versions of the databases?
+The current version of Cortex does not offer that possibility. If you'd like to have it, please [request it](https://github.com/CERT-BDF/Cortex-analyzers/issues/new).
+
+# Authentication
+- [Does Cortex support authentication?](https://github.com/CERT-BDF/Cortex/wiki/FAQ/does-cortex-support-authentication)
+- [How can I make sure that only authorized users get access to Cortex?](https://github.com/CERT-BDF/Cortex/wiki/FAQ/how-can-i-make-sure-that-only-authorized-users-get-access-to-cortex)
+- [How can I make sure that only authorized services get access to the Cortex API?](https://github.com/CERT-BDF/Cortex/wiki/FAQ/how-can-i-make-sure-that-only-authorized-services-get-access-to-cortex-api)
+
+### Does Cortex support authentication?
+No. Cortex 1 does not support authentication. Cortex 2, slated for September 2017, [will support local, LDAP and AD authentication](https://github.com/CERT-BDF/Cortex/issues/7).
+
+### How can I make sure that only authorized users get access to Cortex?
+Cortex does not currently support authentication. The next major version (v2), slated for September 2017, [will implement it](https://github.com/CERT-BDF/Cortex/issues/7). In the meantime, you should either install an authenticating reverse proxy in front of Cortex or limit access to it using a firewall or an alternative filtering device.
+
+If you do not protect your Cortex instance, anyone who has access to your network may run jobs or retrieve existing reports.
+
+### How can I make sure that only authorized services get access to Cortex API?
+Cortex does not currently support service authentication or API keys. The next major version (v2), slated for September 2017, [will implement it](https://github.com/CERT-BDF/Cortex/issues/7).
+
+Any service may query Cortex without authentication. If you need to let only authorized services get access to your instance(s), make sure to use a filtering device and authorize only the IP addresses of those services.
+
+# Miscellaneous Questions
+- [Can I Enable HTTPS to Connect to Cortex?](https://github.com/CERT-BDF/Cortex/wiki/FAQ#can-i-enable-https-to-connect-to-cortex)
+
+### Can I Enable HTTPS to Connect to Cortex?
+#### TL;DR
+Add the following lines to `/etc/cortex/application.conf`
+
+    https.port: 9443
+    play.server.https.keyStore {
+      path: "/path/to/keystore.jks"
+      type: "JKS"
+      password: "password_of_keystore"
+    }
+
+HTTP can disabled by adding line `http.port=disabled`
+#### Details
+To enable HTTPS in the application, add the following lines to `/etc/cortex/application.conf`:
+```
+    https.port: 9443
+    play.server.https.keyStore {
+      path: "/path/to/keystore.jks"
+      type: "JKS"
+      password: "password_of_keystore"
+    }
+```
+As HTTPS is enabled HTTP can be disabled by adding `http.port=disabled` in configuration.
+
+To import your certificate in the keystore, depending on your situation, you can follow [Digital Ocean's tutorial](https://www.digitalocean.com/community/tutorials/java-keytool-essentials-working-with-java-keystores).
+
+**More information**:
+This is a setting of the Play framework that is documented on its website. Please refer to [https://www.playframework.com/documentation/2.5.x/ConfiguringHttps](https://www.playframework.com/documentation/2.5.x/ConfiguringHttps).
\ No newline at end of file
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 000000000..d36061c7a
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,28 @@
+Cortex is an analysis engine.
+
+## Hardware pre-requisites
+Cortex uses Java VM. We recommend using a virtual machine with 8vCPU, 8 GB of RAM and 10 GB of disk. You can also use a
+physical machine with similar specifications.
+
+## What's new
+
+- [Changelog](/CHANGELOG.md)
+
+## Installation guides
+
+TheHive can be installed using:
+- [rpm package](installation/rpm-guide.md)
+- [deb package](installation/deb-guide.md)
+- [docker](installation/docker-guide.md)
+- [binary](installation/binary-guide.md)
+- [ansible script](https://github.com/drewstinnett/ansible-cortex) contributed by
+[@drewstinnett](https://github.com/drewstinnett)
+- [build from sources](installation/build-guide.md)
+
+## Developer guides
+
+- [API documentation](api/README.md)
+- [How to create an analyzer](how-to-create-an-analyzer.md).
+
+## Other documentations
+- [FAQ](FAQ.md)
\ No newline at end of file
diff --git a/docs/admin/configuration.md b/docs/admin/configuration.md
new file mode 100644
index 000000000..627e1a55b
--- /dev/null
+++ b/docs/admin/configuration.md
@@ -0,0 +1,31 @@
+# Configuration
+
+Cortex back-end and analyzers can find their configuration in the same file.
+
+The only required parameter in order to start Cortex is the key of the server (`play.crypto.secret`). This key is used
+to authenticate cookies that contain data, and not only a session id. If Cortex runs in cluster mode, all instance must
+share the same key.
+
+You should generate a random key using the following command line:
+
+```
+sudo mkdir /etc/cortex
+(cat << _EOF_
+# Secret key
+# ~~~~~
+# The secret key is used to secure cryptographics functions.
+# If you deploy your application to several instances be sure to use the same key!
+play.crypto.secret="$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 64 | head -n 1)"
+_EOF_
+) | sudo tee -a /etc/cortex/application.conf
+
+```
+
+Please, note that this secret key is mandatory to start Cortex application. With this configuration, you will only be
+able to run analyzers that do not require any configuration parameter, an API key for instance. To configure other
+analyzers, refer to [analyzers](../installation/analyzers.md).
+
+**Warning**: By default, Cortex run an HTTP service on port `9000/tcp`. You can change the port by adding
+`http.port=8080` in the configuration file or add the `-Dhttp.port=8080` parameter to the command line below. If you run
+Cortex using a non-privileged user, you can't bind a port under 1024. If you run TheHive on the same system beware to
+use two different TCP ports.
diff --git a/docs/api/README.md b/docs/api/README.md
new file mode 100644
index 000000000..164c5e279
--- /dev/null
+++ b/docs/api/README.md
@@ -0,0 +1,23 @@
+
+If you are using [TheHive](https://github.com/CERT-BDF/TheHive) as a SIRP (Security Incident Response Platform), you
+don't need to master the Cortex REST API. If you have a different SIRP or would like to interface other tools with
+Cortex, please read on.
+
+## TL;DR
+The current Cortex version doesn't require authentication and all API call results are provided in JSON format.
+
+## Available API Calls
+
+- [List analyzers](list-analyzers.md)
+- [Get an analyzer's definition](get-analyzer.md)
+- [List analyzers for a given datatype](get-analyzer-by-type.md)
+- [Run an analyzer](run-analyzer.md)
+- [List jobs](list-jobs.md)
+- [Get a job definition](get-job.md)
+- [Delete a job](delete-job.md)
+- [Get a job report](get-job-report.md)
+- [Wait and get a job report](wait-and-get-job-report.md)
+
+## How to create an analyzer
+
+If you want to create an analyzer, follow this [guide](how-to-create-an-analyzer.md).
\ No newline at end of file
diff --git a/docs/api/delete-job.md b/docs/api/delete-job.md
new file mode 100644
index 000000000..b48667007
--- /dev/null
+++ b/docs/api/delete-job.md
@@ -0,0 +1,26 @@
+This API call lets you delete an existing job, identified by its ID.
+
+**URL**
+```
+DELETE /api/job/<JOB_ID>
+```
+
+`JOB_ID` must be a valid job `id`.
+
+**Output**
+
+This API call doesn't produce any output.
+
+**Response codes**
+
+| Status Code  | Description |
+| ------------ | ------------- |
+| 200  | The deletion has been made successfully |
+| 404  | **TBD**: The job is unknown |
+| 500  | An expected error occurred |
+
+**How to use it**
+
+```
+curl -XDELETE http://<CORTEX_SERVER>:<CORTEX_PORT>/api/job/<JOB_ID>
+```
diff --git a/docs/api/get-analyzer-by-type.md b/docs/api/get-analyzer-by-type.md
new file mode 100644
index 000000000..edfd2d05f
--- /dev/null
+++ b/docs/api/get-analyzer-by-type.md
@@ -0,0 +1,56 @@
+This API call returns the list of all the analyzers that can act upon a given datatype (IP address, hash, domain...). 
+
+**URL** 
+```
+GET /api/analyzer/type/<DATATYPE>
+```
+
+where `DATATYPE` is a valid observable datatype: ip, url, domain, and so on.
+
+**Output**
+
+Returns a JSON array representing a list of all the analyzers that can act upon that specific datatype. Each entry includes the following attributes:
+
+| Attribute  | Type | Description |
+| ------------ | ------------- | ------------- |
+| id  | String  | The analyzer's identifier  |
+| name  | String| The analyzer's name  |
+| version  | String  | The analyzer's version  |
+| dataTypeList  | String[]  | An array of the observable datatypes that the analyzer can act upon  |
+
+*Example*
+
+```json
+[  
+  {
+    "name": "Abuse_Finder",
+    "version": "1.0",
+    "description": "Use CERT-SG's Abuse Finder to find the abuse contact associated with domain names, URLs, IP and email addresses.",
+    "dataTypeList": [
+      "ip",
+      "domain",
+      "url",
+      "email"
+    ],
+    "id": "Abuse_Finder_1_0"
+  },
+  {
+    "name": "HippoMore",
+    "version": "1.0",
+    "description": "Hippocampe detailed report: provides the last detailed report for an IP, domain or a URL",
+    "dataTypeList": [
+      "ip",
+      "domain",
+      "fqdn",
+      "url"
+    ],
+    "id": "HippoMore_1_0"
+  }
+]
+```
+
+**How to use it**
+
+```
+curl http://<CORTEX_SERVER>:<CORTEX_PORT>/api/analyzer/type/domain
+```
\ No newline at end of file
diff --git a/docs/api/get-analyzer.md b/docs/api/get-analyzer.md
new file mode 100644
index 000000000..f12de90dc
--- /dev/null
+++ b/docs/api/get-analyzer.md
@@ -0,0 +1,39 @@
+This API call returns the details of a given analyzer when you supply its ID. If you don't know the ID of the analyzer, you can get a list of all the available analyzers and the corresponding IDs by referring to the [List analyzers](List-analyzers-API) page.
+
+**URL** 
+```
+GET /api/analyzer/<ANALYZER_ID>
+```
+
+`ANALYZER_ID` should be a valid analyzer `id`.
+
+**Output**
+
+Returns a JSON object representing an analyzer, with the following attributes:
+
+| Attribute  | Type | Description |
+| ------------ | ------------- | ------------- |
+| id  | String  | The analyzer's identifier  |
+| name  | String| The analyzer's name  |
+| version  | String  | The analyzer's version  |
+| dataTypeList  | String[]  | An array of the observable datatypes that the analyzer can act upon  |
+
+*Example*
+
+```json
+{
+  "name": "File_Info",
+  "version": "1.0",
+  "description": "Parse files in several formats such as OLE and OpenXML to detect VBA macros, extract their source code, generate useful information on PE, PDF files and much more.",
+  "dataTypeList": [
+    "file"
+  ],
+  "id": "File_Info_1_0"
+}
+```
+
+**How to use it**
+
+```
+curl http://<CORTEX_SERVER>:<CORTEX_PORT>/api/analyzer/<ANALYZER_ID>
+```
\ No newline at end of file
diff --git a/docs/api/get-job-report.md b/docs/api/get-job-report.md
new file mode 100644
index 000000000..30f335fb5
--- /dev/null
+++ b/docs/api/get-job-report.md
@@ -0,0 +1,100 @@
+This API call returns the details and report of a given job, identified by its ID.
+
+**URL** 
+```
+GET /api/job/<JOB_ID>/report
+```
+
+`JOB_ID` must be a valid job `id`.
+
+**Output**
+
+Returns a JSON object representing a job, with the following attributes:
+
+| Attribute  | Type | Description |
+| ------------ | ------------- | ------------- |
+| id  | String  | The job's id |
+| analyzerId  | String| The analyzer's id |
+| status  | String  | The job's status: `Success`, `InProgress` or `Failure` |
+| date  | Number  | A timestamp which represent the job's start date |
+| artifact  | Object  | The observable details |
+| report  | `<Report>` Object  | The job report |
+
+
+The `<Report>` could be any JSON object, but Cortex uses some conventions. The structure of the `<Report>` object as defined by Cortex is described below:
+
+| Attribute  | Type | Description |
+| ------------ | ------------- | ------------- |
+| success  | Boolean  | True if the job is successful, False if it failed |
+| errorMessage | String | Contains the error message if the job failed |
+| summary | Object  | A custom JSON object with any content (based on the analyzer) |
+| artifacts | `<Artifact>`[]  | An array of the artifacts extracted from the analysis |
+| full | Object  | A custom JSON object with any content (based on the analyzer). Represents the full analysis report |
+
+
+The `<Artifact>` is an object representing an observable and has two attributes:
+
+| Attribute  | Type | Description |
+| ------------ | ------------- | ------------- |
+| type  | String  | The artifact's datatype (url, hash, ip, domain...) |
+| value | String | The observable's value |
+
+
+*Example*
+
+```json
+{
+  "id": "vVQu93ps4PwHOtLv",
+  "analyzerId": "File_Info_1_0",
+  "status": "Success",
+  "date": 1490204071457,
+  "artifact": {
+    "attributes": {
+      "dataType": "file",
+      "tlp": 2,
+      "content-type": "text/x-python-script",
+      "filename": "sample.py"
+    }
+  },
+  "report": {
+    "artifacts": [
+      {
+        "type": "sha1",
+        "value": "cd1c2da4de388a4b5b60601f8b339518fe8fbd31"
+      },
+      {
+        "type": "sha256",
+        "value": "fd1755c7f1f0f85597cf2a1f13f5cbe0782d9e5597aca410da0d5f26cda26b97"
+      },
+      {
+        "type": "md5",
+        "value": "3aa598d1f0d50228d48fe3a792071dde"
+      }
+    ],
+    "full": {
+      "Mimetype": "text/x-python",
+      "Identification": {
+        "ssdeep": "24:8ca1hbLcd8yutXHbLcTtvbrbLcvtEbLcWmtlbLca66/5:8zHbLcdbOXbLc5jrbLcVEbLcPlbLcax",
+        "SHA1": "cd1c2da4de388a4b5b60601f8b339518fe8fbd31",
+        "SHA256": "fd1755c7f1f0f85597cf2a1f13f5cbe0782d9e5597aca410da0d5f26cda26b97",
+        "MD5": "3aa598d1f0d50228d48fe3a792071dde"
+      },
+      "filetype": "python script",
+      "Magic": "Python script, ASCII text executable",
+      "Exif": {
+        "ExifTool:ExifToolVersion": 10.36
+      }
+    },
+    "success": true,
+    "summary": {
+      "filetype": "python script"
+    }
+  }
+}
+```
+
+**How to use it**
+
+```
+curl http://<CORTEX_SERVER>:<CORTEX_PORT>/api/job/<JOB_ID>/report
+```
\ No newline at end of file
diff --git a/docs/api/get-job.md b/docs/api/get-job.md
new file mode 100644
index 000000000..321e6e200
--- /dev/null
+++ b/docs/api/get-job.md
@@ -0,0 +1,44 @@
+This API call returns the details of a given job, identified by its ID. It doesn't include the job's report, which can be fetched using the [Get job report API](Get-job-report-API).
+
+**URL** 
+```
+GET /api/job/<JOB_ID>
+```
+
+`JOB_ID` must be a valid job `id`.
+
+**Output**
+
+Returns a JSON object representing a job with the following attributes:
+
+| Attribute  | Type | Description |
+| ------------ | ------------- | ------------- |
+| id  | String  | The job's id |
+| analyzerId  | String| The analyzer's id |
+| status  | String  | The job's status: `Success`, `InProgress` or `Failure` |
+| date  | Number  | A timestamp which represents the job's start date |
+| artifact  | Object  | The observable details |
+
+*Example*
+
+```json
+{
+    "id": "c9uZDbHBf32DdIVJ",
+    "analyzerId": "MaxMind_GeoIP_2_0",
+    "status": "Success",
+    "date": 1490194495262,
+    "artifact": {
+        "data": "8.8.8.8",
+        "attributes": {
+        "dataType": "ip",
+        "tlp": 2
+        }
+    }
+}
+```
+
+**How to use it**
+
+```
+curl http://<CORTEX_SERVER>:<CORTEX_PORT>/api/job/<JOB_ID>
+```
\ No newline at end of file
diff --git a/docs/api/how-to-create-an-analyzer.md b/docs/api/how-to-create-an-analyzer.md
new file mode 100644
index 000000000..9b10a4aee
--- /dev/null
+++ b/docs/api/how-to-create-an-analyzer.md
@@ -0,0 +1,357 @@
+# Overview
+The main goal of Cortex is to run analysis on a given observable, defined by its data type, and a value. This observable could be of any type: IP, domain, URL, email, file... 
+
+The programs that Cortex invokes to analyze observables are called **Analyzers**. An **analyzer** could be written in any programming language supported by Linux as long as the resulting program is on the same machine as Cortex and is executable.
+
+# Create a Basic Analyzer
+From a technical standpoint, a minimal **analyzer** would be defined by:
+- A JSON definition file
+- An executable script. As of this writing, all the available analyzers are written in Python. However, analyzers can be written in any programming language supported by Linux
+
+Throughout this document, we will use the [Hippocampe_More](https://github.com/CERT-BDF/Cortex-Analyzers/tree/master/analyzers/Hippocampe) analyzer as an example to teach you how to write your own analyzer.
+
+Our **analyzer** will be defined inside a folder called `Hippocampe`. We use a convention. The folder where the analyzer is located is named after the product or service it leverages to do its work: MISP, MaxMind, PassiveTotal, VirusTotal, DomainTools...
+
+## The JSON Definition File
+As its name implies, the JSON definition file contain metadata describing the analyzer. The associated filename must be `<PRODUCT_NAME>_<SERVICE_NAME>.json`. For example: `Hippocampe_more.json` and `Hippocampe_hipposcore.json`.
+
+The structure of this file is described in the table below:
+
+| Attribute  | Type | Description |
+| ------------ | ------------- | ------------- |
+| name | String, `REQUIRED` | The analyzer's name |
+| version | String `REQUIRED` | The analyzer's version |
+| description | String `REQUIRED`| The analyzer's description |
+| dataTypeList | String[] `REQUIRED` | An array of strings, listing the observable data types that could be analyzed |
+| command | String `REQUIRED` | The command to invoke the analyzer's script. It must be relative to the root directory that contain all the analyzer folders |
+| baseConfig* | String `OPTIONAL` | The name of the configuration attribute defined in the Cortex configuration file |
+| config* | Object `OPTIONAL` | A configuration object that will be passed to the analyzer's command |
+
+**Note**: Fields marked with a star (*) will be described in depth later in this document. 
+
+**Example**
+```json
+{
+    "name": "HippoMore",
+    "version": "1.0",
+    "description": "Hippocampe detailed report: provides the last detailed report for an IP, domain or a URL",
+    "dataTypeList": ["ip", "domain", "fqdn", "url"],
+    "baseConfig": "Hippocampe",
+    "config": {
+        "check_tlp": false,
+        "max_tlp":3,
+        "service": "more"
+    },
+    "command": "Hippocampe/hippo.py"
+}
+```
+
+## The Script
+The analyzer script must be an executable script that Cortex runs using the `command` provided within the JSON definition file. The script could be written in any programming language, as long as it could be executed using a shell command.
+
+When running the analyzer's script file, Cortex provides some input data through the standard input, and expects an output through the standard output.
+
+### Analyzer Input
+In Cortex, we distinguish between two types of observables: 
+- Value-based observables 
+- File-based observables
+
+The input sent by Cortex to the analyzers depend on the observable type.
+
+*Note*: when using Cortex with [TheHive](https://github.com/CERT-BDF/TheHive/), we use some output conventions that allow us to normalize the way TheHive displays the analysis reports. 
+
+#### Input for Value-based Observables
+The input for value-based observables must have the following structure:
+
+```json
+{ 
+    "dataType": "ip", 
+    "data": "8.8.8.8", 
+    "config": {}
+}
+```
+
+The following table explains the JSON schema of the input:
+
+| Attribute  | Type | Description |
+| ------------ | ------------- | ------------- |
+| dataType | String, `REQUIRED` | The observables's type |
+| data | String `REQUIRED` | The observable's value |
+| config* | Object `OPTIONAL` | A config object, representing the analyzer's options and parameters if any |
+
+
+#### Input for File-based Observables
+The input for file-based observables must have the following structure:
+```json
+{ 
+    "dataType": "file", 
+    "attachment": {
+        "name": "<file.extension>"
+    },
+    "file": "/path/to/file/observable",
+    "config": {}
+}
+```
+
+The following table explains the JSON schema of the input:
+
+| Attribute  | Type | Description |
+| ------------ | ------------- | ------------- |
+| dataType | String, `REQUIRED` | The observable's type (`file` in this case) |
+| file | String `REQUIRED` | The observable's file path |
+| attachment.name | String `OPTIONAL` | The observable's file name |
+| config* | Object `OPTIONAL` | A config object, representing the analyzer's options and parameters if any |
+
+#### The Analyzer Configuration Object
+An analyzer can define a default configuration object in its JSON definition file. Cortex can override or add additional configuration properties using the Cortex's configuration file.
+
+Based on that, the `config` object passed to the analyzer's script results from the merge operation of three objects:
+- the `config` object defined in the analyzer's JSON definition file (defines the default values of the analyzer's config) 
+- the `baseConfig` object defined in the Cortex's configuration file using the `analyzer.config.<baseConfig>` property (used to hold sensitive properties like API keys or credentials)
+- the *global* analyzers configuration defined in the Cortex's configuration file using `analyzer.config.global` (generally contains proxy configuration information)
+
+
+### Analyzer Output
+The output from Cortex could technically be any JSON object. That said, Cortex's UI might rely on a specific attribute to decide if the job failed or succeeded. The property is named `success` and must be a Boolean value.
+
+In the existing analyzers we tried to stick to some conventions where we defined the formats defined below.
+
+#### Successful Analysis
+```json
+{
+    "success": true,
+    "summary": {},
+    "artifacts": [],
+    "full": {}
+}
+```
+
+The following table explains the JSON conventions of the output:
+
+| Attribute  | Type | Description |
+| ------------ | ------------- | ------------- |
+| success | Boolean `REQUIRED` | The analysis success flag |
+| summary | Object `OPTIONAL` | The analysis summary: a small report |
+| full | Object `REQUIRED` | The analysis complete report |
+| artifacts | Array[`<Artifact>`] `OPTIONAL` | An array of artifacts discovered by the analyzer |
+
+The `<Artifact>` object has the following structure:
+
+| Attribute  | Type | Description |
+| ------------ | ------------- | ------------- |
+| type | String `REQUIRED` | The artifact data type |
+| value | String `REQUIRED` | The artifact value |
+
+**Note**: the `artifacts` array will be used in the future by [TheHive](https://github.com/CERT-BDF/TheHive/) to display or import the extracted artifacts from an analysis report.
+
+#### Unsuccessful Analysis
+```json
+{
+    "success": false,
+    "errorMessage": ""
+}
+```
+
+# The Cortexutils Library
+`cortexutils` is a Python library available on `pip`. It provides a Python class that facilitates the creation of analyzer script files. It includes an abstract `Analyzer` class that a programmer may inherit and override in their script. It also provides some methods to quickly format the output to be compliant with the JSON schema expected by [TheHive](https://github.com/CERT-BDF/TheHive/).
+
+To create an analyzer class, developers have to:
+
+1. Create a subclass of `cortexutils.analyzer.Analyzer`
+2. Override the constructor, call the super constructor and if needed, read the specific analyzer's options (read specific configuration properties from the config object)
+3. Override the `run` method. It must either return a report, using the `report` method, or an error using the `error`method. If `run`is not overridden, the analyzer returns an empty report
+3. Optionally override the `summary` method. It should return a JSON object representing a summary of the analyzer report. If not overridden, the analyzer returns an empty summary
+3. Optionally override the `artifacts` method. It should return a JSON array representing a list of `artifact` objects (as described above). If not overridden, the analyzer returns the result of an `ioc-parser`, ran over the full JSON report.
+
+Below is an example of a basic analyzer that can handle IPs and domains:
+
+```python
+#!/usr/bin/env python
+# encoding: utf-8
+
+from cortexutils.analyzer import Analyzer
+
+# Define analyzer's class
+class BasicExampleAnalyzer(Analyzer):
+    # Analyzer's constructor
+    def __init__(self):
+        # Call the constructor of the super class
+        Analyzer.__init__(self)
+
+        # Read specific config options
+        self.optional_prop = self.getParam('config.optional_prop', '')
+        self.required_prop = self.getParam('config.required_prop', None, 'Error: Missing required_prop')
+
+    # Override the report method. This is the analyzer's entry point
+    def run(self):
+        # Put your analyzer's logic here
+        result = {}
+
+        # This is just an example
+        if self.data_type == 'ip':
+            result['findings'] = ['1.1.1.1', '2.2.2.2', '3.3.3.3']
+        elif self.data_type == 'domain':
+            result['findings'] = ['domain1.com', 'domain2.com', 'domain3.com']
+        else:
+            return self.error('Unsupported observable data type')
+
+        # Return the report
+        return self.report(result)
+
+    # Override the summary method
+    def summary(self, raw_report):
+        return {
+            'count': len(raw_report['findings'])
+        }
+
+    # Override the artifacts method
+    def artifacts(self, raw_report):
+        result = []
+        if 'findings' in raw_report:            
+            for item in raw_report['findings']:
+                result.append({'type': self.data_type, 'value': item})            
+
+        return result
+    
+# Invoke the analyzer
+if __name__ == '__main__':
+    BasicExampleAnalyzer().run()
+
+```
+
+To call this analyzer, we can run the following command:
+
+```
+python sample-analyzer.py <<< '{
+    "dataType":"ip", 
+    "data": "8.8.8.8", 
+    "config":{
+        "required_prop": "anyvalue"
+    }
+}'
+```
+
+This will generate the following output:
+
+```json
+{
+   "success" : true,
+   "artifacts" : [
+      {
+         "value" : "1.1.1.1",
+         "type" : "ip"
+      },
+      {
+         "value" : "2.2.2.2",
+         "type" : "ip"
+      },
+      {
+         "value" : "3.3.3.3",
+         "type" : "ip"
+      }
+   ],
+   "summary" : {
+      "count" : 3
+   },
+   "full" : {
+      "findings" : [
+         "1.1.1.1",
+         "2.2.2.2",
+         "3.3.3.3"
+      ]
+   }
+}
+```
+
+And in Cortex ![](../images/cortex-report.png)
+
+# TheHive and Cortex analyzers
+Using Cortex from an instance of [TheHive](https://github.com/CERT-BDF/TheHive/) helps the users improve the analysis report visualization. In fact, TheHive uses the outputs generated from Cortex analyzers in two ways:
+
+- Store the `summary` content as part of the observable's data. This is available for successful analysis jobs only.
+- Display the `full`report using the report templates defined within TheHive.
+
+## Report templates
+[TheHive](https://github.com/CERT-BDF/TheHive/) is based on Angular 1 and report templates have to be Angular templates which we try to fill using the job's report data. 
+
+We distinguish 2 types of report templates:
+
+### Short reports
+Generates what we call **mini reports**, to be displayed in the observable's details page and observables list. Short report templates receive the following data:
+
+| Attribute  | Type | Description |
+| ------------ | ------------- | ------------- |
+| name | String | Analyzer's ID |
+| content | Object | The job report's `summary` object |
+| artifact | Object | The observable details, as stored in TheHive |
+
+For example, if we want to create a short report template for the `BasicExampleAnalyzer`, we could write the following HTML short report file:
+
+```html
+<span class="label label-info">Basic: {{content.count || 0}} record(s)</span>
+```
+
+`content` being the following:
+
+```json
+{
+    "count" : 3
+}
+```
+
+The result in TheHive will be ![](../images/short-report.png)
+
+### Long reports
+Like short reports, the long reports are used to render the content of the `full` attribute of a job JSON report.
+
+Long report templates receive the following data:
+
+| Attribute  | Type | Description |
+| ------------ | ------------- | ------------- |
+| name | String | Analyzer's ID |
+| status | String | The job's status: `Success`, `Failure`, `InProgress` |
+| success | Boolean | The job's success status |
+| content | Object | The job report's `full` object |
+| artifact | Object | The observable details, as stored in TheHive |
+
+
+For example, if we want to create a long report template for the `BasicExampleAnalyzer`, we could write the following HTML long report file:
+
+```html
+<!-- Success case -->
+<div class="panel panel-info" ng-if="success">
+    <div class="panel-heading">
+        <strong>{{name}}</strong>
+    </div>
+    <div class="panel-body">
+      <div>{{content.findings.length}} {{artifact.dataType | uppercase}}(s) found form {{artifact.data | fang}}</div>
+      <ul>
+          <li ng-repeat="finding in content.findings">{{finding}}</li>
+      </ul>
+    </div>
+</div>
+
+<!-- Failure case -->
+<div class="panel panel-danger" ng-if="!success">
+    <div class="panel-heading">
+        <strong>{{artifact.data | fang}}</strong>
+    </div>
+    <div class="panel-body">
+        {{content.errorMessage}}
+    </div>
+</div>
+```
+
+`content` being the following:
+
+```json
+{
+    "findings" : [
+        "1.1.1.1",
+        "2.2.2.2",
+        "3.3.3.3"
+    ]
+}
+```
+
+The result in TheHive will be ![](../images/long-report.png)
\ No newline at end of file
diff --git a/docs/api/list-analyzers.md b/docs/api/list-analyzers.md
new file mode 100644
index 000000000..d1341a393
--- /dev/null
+++ b/docs/api/list-analyzers.md
@@ -0,0 +1,51 @@
+This API call returns the list of all the analyzers enabled within Cortex. 
+
+**URL** 
+```
+GET /api/analyzer
+```
+
+**Output**
+
+Returns a JSON array representing a list of all the enabled analyzers. Each entry includes the following attributes:
+
+| Attribute  | Type | Description |
+| ------------ | ------------- | ------------- |
+| id  | String  | The analyzer's identifier  |
+| name  | String| The analyzer's name  |
+| version  | String  | The analyzer's version  |
+| dataTypeList  | String[]  | An array of the observable datatypes that the analyzer can act upon  |
+
+*Example*
+
+```json
+[  
+  {
+    "name": "File_Info",
+    "version": "1.0",
+    "description": "Parse files in several formats such as OLE and OpenXML to detect VBA macros, extract their source code, generate useful information on PE, PDF files and much more.",
+    "dataTypeList": [
+      "file"
+    ],
+    "id": "File_Info_1_0"
+  },
+  {
+    "name": "HippoMore",
+    "version": "1.0",
+    "description": "Hippocampe detailed report: provides the last detailed report for an IP, domain or a URL",
+    "dataTypeList": [
+      "ip",
+      "domain",
+      "fqdn",
+      "url"
+    ],
+    "id": "HippoMore_1_0"
+  }
+]
+```
+
+**How to use it**
+
+```
+curl http://<CORTEX_SERVER>:<CORTEX_PORT>/api/analyzer
+```
\ No newline at end of file
diff --git a/docs/api/list-jobs.md b/docs/api/list-jobs.md
new file mode 100644
index 000000000..797be3e43
--- /dev/null
+++ b/docs/api/list-jobs.md
@@ -0,0 +1,95 @@
+This API call returns a list of analysis jobs.
+
+**URL** 
+```
+GET /api/job
+```
+
+**Input**
+
+This API call supports a list of filters and pagination parameters can be provided in the query:
+
+| Query Parameter  | Default value | Description |
+| ------------ | ------------- | ------------- |
+| dataTypeFilter  | Empty  | A datatype value: ip, domain, hash etc...  |
+| dataFilter  | Empty | A string representing a part of an observable value. Could be an IP or part of an IP, a domain, url and so on |
+| analyzerFilter  | Empty | An analyzer's ID  |
+| start  | 0  | A number representing the index of the page start |
+| limit  | 10  | A number representing a page size |
+
+*Example*
+```
+GET /api/job?analyzerFilter=Abuse_Finder_1_0&dataTypeFilter=domain&dataFilter=.com&start=0&limit=50
+```
+
+should return the list of Abuse_Finder jobs corresponding to domains which include `.com`.
+
+**Output**
+
+Returns a JSON array representing a list of jobs. Each entry includes the following attributes:
+
+| Attribute  | Type | Description |
+| ------------ | ------------- | ------------- |
+| id  | String  | The job's id |
+| analyzerId  | String| The analyzer's id |
+| status  | String  | The job's status: `Success`, `InProgress` or `Failure` |
+| date  | Number  | A timestamp which corresponds to the job's start date |
+| artifact  | Object  | The observable details |
+
+*Example*
+
+```json
+[
+  {
+    "id": "OsmbnQJGmeCgvDxP",
+    "analyzerId": "OTXQuery_1_0",
+    "status": "Failure",
+    "date": 1490194495264,
+    "artifact": {
+      "data": "8.8.8.8",
+      "attributes": {
+        "dataType": "ip",
+        "tlp": 2
+      }
+    }
+  },
+  {
+    "id": "c9uZDbHBf32DdIVJ",
+    "analyzerId": "MaxMind_GeoIP_2_0",
+    "status": "Success",
+    "date": 1490194495262,
+    "artifact": {
+      "data": "8.8.8.8",
+      "attributes": {
+        "dataType": "ip",
+        "tlp": 2
+      }
+    }
+  },
+  {
+    "id": "OcFlZbLNNUsIiJZq",
+    "analyzerId": "HippoMore_1_0",
+    "status": "InProgress",
+    "date": 1490194495259,
+    "artifact": {
+      "data": "8.8.8.8",
+      "attributes": {
+        "dataType": "ip",
+        "tlp": 2
+      }
+    }
+  }
+]
+```
+
+**How to use it**
+
+```
+curl http://<CORTEX_SERVER>:<CORTEX_PORT>/api/job
+```
+
+or
+
+```
+curl 'http://<CORTEX_SERVER>:<CORTEX_PORT>/api/job?start=0&limit=100'
+```
\ No newline at end of file
diff --git a/docs/api/run-analyzer.md b/docs/api/run-analyzer.md
new file mode 100644
index 000000000..836063002
--- /dev/null
+++ b/docs/api/run-analyzer.md
@@ -0,0 +1,138 @@
+The API calls described below will let you run analyzers on one observable at a time. Two types of observables can be analyzed:
+- Value-based: generally string values such as IP addresses, domains, hashes and so on.
+- File-based: the file that you'd like to analyze must be submitted.
+
+## Analyze Value-based Observables
+
+**URL** 
+```
+POST /api/analyzer/<ANALYZER_ID>/run
+```
+
+`ANALYZER_ID` must be a valid analyzer `id`.
+
+**Input**
+
+This API call requires a JSON POST body describing an observable and the following attributes:
+
+| Attribute  | Type | Description |
+| ------------ | ------------- | ------------- |
+| data  | String  | The observable's value  |
+| attributes  | `<Attributes>`Object | The observable's attributes |
+
+
+The `<Attributes>` object structure is the following:
+
+| Attribute  | Type | Description |
+| ------------ | ------------- | ------------- |
+| dataType  | String | The observable's data type |
+| tlp  | Number | The observable's TLP: 0 for `WHITE`, 1 for `GREEN`, 2 for `AMBER`, 3 for `RED` |
+
+*Example*
+
+```
+curl -XPOST -H 'Content-Type: application/json' http://<CORTEX_SERVER>:<CORTEX_PORT>/api/analyzer/Hipposcore_1_0/run -d '{
+    "data":"mydomain.com",
+    "attributes":{
+        "dataType":"domain",
+        "tlp":2
+    }
+}'
+```
+
+This returns the details of the created analysis job.
+
+**Output**
+
+Returns a JSON object representing the started analysis job:
+
+| Attribute  | Type | Description |
+| ------------ | ------------- | ------------- |
+| id  | String  | The job's ID |
+| analyzerId  | String| The analyzer's ID |
+| status  | String  | The job's status: `Success`, `InProgress` or `Failure` |
+| date  | Number  | A timestamp which represents the job's start date |
+| artifact  | Object  | The observable details |
+
+*Example*
+
+```json
+{
+    "id": "ymlrxZB8efyZhFEg",
+    "analyzerId": "Hipposcore_1_0",
+    "status": "Success",
+    "date": 1490263456480,
+    "artifact": {
+        "data": "mydomain.com",
+        "attributes": {
+            "dataType": "domain",
+            "tlp": 2
+        }
+    }
+}
+```
+
+## Analyze File-based observables
+
+**URL** 
+```
+POST /api/analyzer/<ANALYZER_ID>/run
+```
+
+`ANALYZER_ID` must be a valid analyzer `id`.
+
+**Input**
+
+This API call requires submitting the file to be analyzed by sending a request as a multipart format:
+
+- The first part must be named `data` and must contain the file.
+- The second part must be named `_json` and must specify the observable details in JSON format, as described below:
+
+| Attribute  | Type | Description |
+| ------------ | ------------- | ------------- |
+| dataType  | String | The observable's data type |
+| tlp  | Number | The observable's TLP: 0 for `WHITE`, 1 for `GREEN`, 2 for `AMBER`, 3 for `RED` |
+
+*Example*
+
+```
+curl -XPOST http://<CORTEX_SERVER>:<CORTEX_PORT>/api/analyzer/File_Info_1_0/run \
+    -F '_json={
+        "dataType":"file",
+        "tlp":2        
+    };type=application/json' \
+    -F 'attachment=@file.png;type=image/png'
+```
+
+This returns the details of the created analysis job.
+
+**Output**
+
+Returns a JSON object representing the started analysis job.
+
+| Attribute  | Type | Description |
+| ------------ | ------------- | ------------- |
+| id  | String  | The job id |
+| analyzerId  | String| The analyzer's id |
+| status  | String  | The job's status: `Success`, `InProgress` or `Failure` |
+| date  | Number  | A timestamp which represents the job's start date |
+| artifact  | Object  | The observable details |
+
+*Example*
+
+```json
+{
+    "id": "LOcqObDtJEOayPuV",
+    "analyzerId": "File_Info_1_0",
+    "status": "Success",
+    "date": 1490265356725,
+    "artifact": {
+        "attributes": {
+            "dataType": "file",
+            "tlp": 2,
+            "content-type": "image/png",
+            "filename": "file.png"
+        }
+    }
+}
+```
diff --git a/docs/api/wait-and-get-job-report.md b/docs/api/wait-and-get-job-report.md
new file mode 100644
index 000000000..a81e6ccd7
--- /dev/null
+++ b/docs/api/wait-and-get-job-report.md
@@ -0,0 +1,27 @@
+This API call is almost the same as [Get Job Report API](Get-job-report-API) but introduces an asynchronous behavior. It means that this API can wait for a given amount of time until the job completes. It also supports a timeout parameter.
+
+Instead of returning the details of an in-progress job, it will wait until it finishes then returns the report, provided it doesn't timeout.
+
+**URL** 
+```
+GET /api/job/<JOB_ID>/waitreport?atMost=<DURATION>
+```
+
+`JOB_ID` must be a valid job `id`.
+`DURATION` should be a valid duration, default to infinite. The duration format is a string composed by a number and a unit (based on [Scala durations](http://www.scala-lang.org/api/2.9.3/scala/concurrent/duration/Duration.html)), for example:
+- 10seconds
+- 1minute
+- 10minutes
+- 2hours
+
+If `atMost`query parameter is not specified, it defaults to *Infinite* (which can be a very, very long time considering the age of the Universe).
+
+**Output**
+
+Same output as [Get Job Report API](Get-job-report-API).
+
+**How to use it**
+
+```
+curl http://<CORTEX_SERVER>:<CORTEX_PORT>/api/job/<JOB_ID>/waitreport
+```
\ No newline at end of file
diff --git a/docs/images/cortex-report.png b/docs/images/cortex-report.png
new file mode 100644
index 0000000000000000000000000000000000000000..d10e618e18bd05d1d937c74b4ff52c40b3bd9cab
GIT binary patch
literal 63845
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
UJPC$b_;24HwLcU8ICS>^0i6c?y#N3J

literal 0
HcmV?d00001

diff --git a/docs/images/long-report.png b/docs/images/long-report.png
new file mode 100644
index 0000000000000000000000000000000000000000..6a384959e9139f9960da3cde690a8dad9d142e0b
GIT binary patch
literal 31252
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
N5S9H<BCPlA{{sAtJ<|XH

literal 0
HcmV?d00001

diff --git a/docs/images/short-report.png b/docs/images/short-report.png
new file mode 100644
index 0000000000000000000000000000000000000000..2a7eaf4110d85a7a17fdd93f2e2db92b8c3c3096
GIT binary patch
literal 17324
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
R^!qbK2@zT0O2MxI{|8{wWrF|!

literal 0
HcmV?d00001

diff --git a/docs/installation/README.md b/docs/installation/README.md
new file mode 100644
index 000000000..e35be780a
--- /dev/null
+++ b/docs/installation/README.md
@@ -0,0 +1,10 @@
+# Installation guides
+
+TheHive can be installed using:
+- [rpm package](rpm-guide.md)
+- [deb package](deb-guide.md)
+- [docker](docker-guide.md)
+- [binary](binary-guide.md)
+- [ansible script](https://github.com/drewstinnett/ansible-thehive) contributed by
+[@drewstinnett](https://github.com/drewstinnett)
+- [build from sources](build-guide.md)
\ No newline at end of file
diff --git a/docs/installation/analyzers.md b/docs/installation/analyzers.md
new file mode 100644
index 000000000..32a56d0eb
--- /dev/null
+++ b/docs/installation/analyzers.md
@@ -0,0 +1,92 @@
+# Cortex analyzers
+
+Analyzers are autonomous applications managed by and run through the Cortex core engine. Analyzers have their
+[own dedicated GitHub repository](https://github.com/CERT-BDF/Cortex-Analyzers). They are included in the Cortex binary
+package but you have to get them from the repository if you decide to build Cortex from sources or if you need to update
+them.
+
+## Pre-requisites
+Currently, all provided analyzers are written in Python. They don't require any build phase but their dependencies have
+to be installed. Before proceeding, you'll need to install the system package dependencies that are required by some of
+them:
+
+```
+apt-get install python-pip python2.7-dev ssdeep libfuzzy-dev libfuzzy2 libimage-exiftool-perl libmagic1 build-essential
+```
+
+Each analyzer comes with its own, pip compatible `requirements.txt` file. You can install all requirements with the
+following commands:
+
+```
+cd analyzers
+sudo pip install $(cat */requirements.txt | sort -u)
+```
+
+## From repository
+If you want to get up-to-date analyzers, you can clone the GitHub repository:
+
+```
+git clone https://github.com/CERT-BDF/Cortex-Analyzers
+```
+
+Next, you'll need to tell Cortex where to find the analyzers. Currently, all the analyzers must be in the same
+directory. Add the following to the Cortex configuration file (`application.conf`):
+
+```
+analyzer {
+  path = "path/to/analyzers"
+}
+```
+## Configuration
+
+Analyzers configuration is stored in Cortex configuration file (application.conf) in `analyzer.config` section. There is
+one subsection for each analyzer group. The configuration provided to analyzer is the merge of:
+ - the global configuration: all item in `analyzer.config.global` section. This settings are applied for all analyzers.
+ It is particularly useful for proxy settings (cf. example below)
+ - the analyzer group configuration. Some analyzers shares configuration items, VirusTotal API key for all VirusTotal
+ analyzers for example. Group name can be found in JSON description file in analyzer folder, under `baseConfig` key.
+ - the analyzer configuration defined in JSON description file, under `config` key.
+
+Here is the complete configuration you should provide to make all analyzers work:
+
+
+```
+analyzer {
+  path = "path/to/Cortex-Analyzers/analyzers"
+  config {
+    global {
+      proxy {
+        http="http://PROXY_ADDRESS:PORT",
+        https="http://PROXY_ADDRESS:PORT"
+      }
+    }
+    DNSDB {
+      server="https://api.dnsdb.info"
+      key="..."
+    }
+    DomainTools {
+      username="..."
+      key="..."
+    }
+    VirusTotal {
+      key="..."
+    }
+    Hippocampe {
+      url="..."
+    }
+    OTXQuery {
+      key="..."
+    }
+    PhishTank {
+      key="..."
+    }
+    PhishingInitiative {
+      key="..."
+    }
+    PassiveTotal {
+      key="..."
+      username="..."
+    }
+  }
+}
+```
diff --git a/docs/installation/binary-guide.md b/docs/installation/binary-guide.md
new file mode 100644
index 000000000..88a381a9c
--- /dev/null
+++ b/docs/installation/binary-guide.md
@@ -0,0 +1,95 @@
+# Installation Guide for Ubuntu 16.04 LTS
+
+This guide describes the manual installation of Cortex from binaries in Ubuntu 16.04.
+
+# 1. Minimal Ubuntu Installation
+
+Install a minimal Ubuntu 16.04  system with the following software:
+ * Java runtime environment 1.8+ (JRE)
+
+Make sure your system is up-to-date:
+
+```
+sudo apt-get update
+sudo apt-get upgrade
+```
+
+# 2. Install a Java Virtual Machine
+You can install either Oracle Java or OpenJDK.
+
+## 2.1. Oracle Java
+```
+echo 'deb http://ppa.launchpad.net/webupd8team/java/ubuntu trusty main' | sudo tee -a /etc/apt/sources.list.d/java.list
+sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-key EEA14886
+sudo apt-get update
+sudo apt-get install oracle-java8-installer
+```
+
+## 2.2 OpenJDK
+```
+sudo add-apt-repository ppa:openjdk-r/ppa
+sudo apt-get update
+sudo apt-get install openjdk-8-jre-headless
+
+```
+
+# 3. Install Cortex
+
+Binary package can be downloaded at [thehive-cortex.zip](https://dl.bintray.com/cert-bdf/cortex/cortex-latest.zip)
+
+Download and unzip the chosen binary package. TheHive files can be installed wherever you want on the filesystem. In
+this guide, we decided to set it in `/opt`.
+
+```
+cd /opt
+wget https://dl.bintray.com/cert-bdf/cortex/cortex-latest.zip
+unzip cortex-latest.zip
+ln -s cortex-x.x.x cortex
+```
+
+
+# 4. First start
+
+Change your current directory to Cortex installation directory (`/opt/cortex` in this guide), then execute:
+
+```
+bin/cortex -Dconfig.file=/etc/cortex/application.conf
+```
+
+It is recommended to use a dedicated non-privilege user to start Cortex. If so, make sure that your user can create log file in `/opt/cortex/logs`
+
+If you'd rather start the application as a service, do the following:
+```
+sudo addgroup cortex
+sudo adduser --system cortex
+sudo cp /opt/cortex/package/cortex.service /usr/lib/systemd/system
+sudo chown -R cortex:cortex /opt/cortex
+sudo chgrp cortex /etc/cortex/application.conf
+sudo chmod 640 /etc/cortex/application.conf
+sudo systemctl enable cortex
+sudo service cortex start
+```
+
+Please note that the service may take some time to start.
+
+Cortex comes with a simplistic frontend. Open your browser and connect to `http://YOUR_SERVER_ADDRESS:9000/`
+
+# 5. Plug analysers
+
+Now that Cortex starts successfully, downloads `Cortex-Analyzers` and edit the configuration file and set the path to
+`Cortex-Analyzers/analyzers`. Follow details available in the [analyzers page](analyzers.md).
+
+## 6. Update
+
+To update Cortex from binaries, just stop the service, download the latest package, rebuild the link `/opt/cortex` and
+restart the service.
+
+```
+service cortex stop
+cd /opt
+wget https://dl.bintray.com/cert-bdf/cortex/cortex-latest.zip
+unzip cortex-latest.zip
+rm /opt/cortex && ln -s cortex-x.x.x cortex
+chown -R cortex:cortex /opt/cortex /opt/cortex-x.x.x
+service cortex start
+```
diff --git a/docs/installation/build-guide.md b/docs/installation/build-guide.md
new file mode 100644
index 000000000..adb7e0e26
--- /dev/null
+++ b/docs/installation/build-guide.md
@@ -0,0 +1,144 @@
+# Build from sources
+
+This document is a step-by-step guide to build Cortex from sources.
+
+## 1. Pre-requisites
+
+The following softwares are required to download and build Cortex.
+
+* Java Development Kit 8 (JDK)
+  * downloadable from http://www.oracle.com/technetwork/java/javase/downloads/index.html
+* git
+  * Use the system package or downloadable it from http://www.git-scm.com/downloads
+* NodeJs with its package manager (NPM)
+  * downloadable from https://nodejs.org/en/download/
+* Grunt
+  * After NodeJs installation, run `sudo npm install -g grunt-cli`
+* Bower
+  * After NodeJs installation, run `sudo npm install -g bower`
+
+
+# 2. Quick Build Guide
+
+To install the requirements and build Cortex from sources, please follow the instructions below depending on your
+operating system.
+
+## 2.1. CentOS/RHEL
+
+### 2.1.1. Packages
+
+```
+sudo yum -y install git bzip2
+```
+
+### 2.1.2. Installation of OpenJDK
+
+```
+sudo yum -y install java-1.8.0-openjdk-devel
+```
+
+### 2.1.3. Installation of NodeJs
+
+Install the EPEL Repository:
+
+You should have the "extras" repository enabled, then:  
+```
+sudo yum -y install epel-release
+```
+
+Then, you can install NodeJs:
+
+```
+sudo yum -y install nodejs
+```
+
+### 2.1.4. Installation of bower and grunt
+
+```
+sudo npm install -g bower grunt-cli
+```
+
+## 2.2. Ubuntu
+
+### 2.2.1. Packages
+
+```
+sudo apt-get install git wget
+```
+
+### 2.2.2. Installation of Oracle JDK
+
+```
+echo 'deb http://ppa.launchpad.net/webupd8team/java/ubuntu trusty main' | sudo tee -a /etc/apt/sources.list.d/java.list
+sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-key EEA14886
+sudo apt-get update
+sudo apt-get install oracle-java8-installer
+```
+
+### 2.2.3. Installation of NodeJs
+
+```
+sudo apt-get install wget
+wget -qO- https://deb.nodesource.com/setup_4.x | sudo bash -
+sudo apt-get install nodejs
+```
+
+### 2.2.4. Installation of bower and grunt
+
+```
+sudo npm install -g bower grunt-cli
+```
+
+## 2.3. Cortex
+
+### Download sources
+
+```
+git clone https://github.com/CERT-BDF/Cortex.git
+```
+
+### Build the projects
+
+```
+cd Cortex
+bin/activator clean stage
+```
+
+It will download all dependencies (could be long) then build the back-end.
+This command clean previous build files and create an autonomous package in `target/universal/stage` directory. This
+packages contains Cortex binaries with required libraries (`/lib`), analyzers (`/analyzers`), configuration files
+(`/conf`) and startup scripts (`/bin`).
+
+Binaries are built and stored in `Cortex/target/universal/stage/`. Install them in `/opt/cortex` for example.
+
+```
+sudo cp -r Cortex/target/universal/stage /opt/cortex
+```
+
+Follow the [configuration guide](../admin/configuration.md) to run Cortex.
+
+
+### First start
+
+Follow [First start in the Installation guide](binary-guide.md#4-first-start) to start using Cortex.
+
+
+## Build the front-end only
+Building back-end builds also front-end, so you don't need to build front-end separately. This section is useful only
+for troubleshooting or in order to install front-end in a reverse proxy.
+
+Go to front-end directory:
+```
+cd Cortex/ui
+```
+
+Install NodeJs libraries (required by building step), bower libraries (javascript libraries downloaded by browser). Then
+build the front-end :
+```
+npm install
+bower install
+grunt build
+```
+
+This step generates static files (html, javascript and related resources) in `dist` directory. These files are ready to
+be imported in http server.
diff --git a/docs/installation/deb-guide.md b/docs/installation/deb-guide.md
new file mode 100644
index 000000000..fab273c22
--- /dev/null
+++ b/docs/installation/deb-guide.md
@@ -0,0 +1,13 @@
+# Installation of TheHive using DEB package
+
+Debian packages are published on Bintray repository. All packages are signed using the key 562CBC1C (fingerprint: 0CD5
+AC59 DE5C 5A8E 0EE1  3849 3D99 BB18 562C BC1C):
+
+```
+echo 'deb https://dl.bintray.com/cert-bdf/debian any main' | sudo tee -a /etc/apt/sources.list.d/thehive-project.list
+sudo apt-key adv --keyserver hkp://pgp.mit.edu --recv-key 562CBC1C
+sudo apt-get update
+sudo apt-get install cortex
+```
+
+After package installation, you should configure Cortex (see [configuration guide](../admin/configuration.md))
\ No newline at end of file
diff --git a/docs/installation/docker-guide.md b/docs/installation/docker-guide.md
new file mode 100644
index 000000000..13696c543
--- /dev/null
+++ b/docs/installation/docker-guide.md
@@ -0,0 +1,50 @@
+# Install TheHive using docker
+
+This guide assume that you will use docker.
+
+## How to use this image
+
+Easiest way to start Cortex:
+```
+docker run certbdf/cortex
+```
+
+From version 1.1.0, we don't provide the all-in-one docker (an image which contained TheHive and Cortex). If you want to
+run TheHive and Cortex in docker, follow the
+[TheHive docker guide](https://github.com/CERT-BDF/TheHive/blob/master/docs/installation/docker-guide.md).
+
+## Analyzers
+
+Analyzers are embedded in docker image in /opt/Cortex-Analyzers/analyzers. If you want to update then, you should
+install them outside docker and overwrite existing ones:
+```
+docker run --volume /path/to/analyzers:/opt/Cortex-Analyzers/analyzers:ro certbdf/cortex:latest  
+```
+
+Most analyzers require configuration. You can inject configuration file using volume argument:
+```
+docker run --volume /path/to/your/configuration:/etc/cortex/application.conf:ro certbdf/cortex:latest  
+```
+
+You should also publish HTTP service to make Cortex available. This is done by adding publish parameter:
+```
+docker run --publish 0.0.0.0:8080:9000 certbdf/cortex:latest  
+```
+This command exposes Cortex service on port 8080/tcp.
+
+## Customize Cortex docker
+
+By Default, Cortex docker add minimal configuration:
+ - choose a random secret (play.crypto.secret)
+ - configure analyzer path
+
+This behavious can be disabled by adding `--no-config` to docker command line:
+`docker run certbdf/cortex:latest --no-config`.
+ 
+Docker image accepts more options:
+ - --no-config            : do not try to configure Cortex (add secret and analyzers location)
+ - --no-config-secret     : do not add random secret to configuration
+ - --secret <secret>      : secret to secure sessions
+ - --analyzer-path <path> : where analyzers are located
+
+
diff --git a/docs/installation/rpm-guide.md b/docs/installation/rpm-guide.md
new file mode 100644
index 000000000..92f4a9865
--- /dev/null
+++ b/docs/installation/rpm-guide.md
@@ -0,0 +1,18 @@
+# Installation of TheHive using RPM package
+
+RPM packages are published on Bintray repository. All packages are signed using the key 562CBC1C (fingerprint: 0CD5
+AC59 DE5C 5A8E 0EE1  3849 3D99 BB18 562C BC1C)
+
+First install rpm release package:
+```
+yum install install https://dl.bintray.com/cert-bdf/rpm/thehive-project-release-1.0.0-3.noarch.rpm
+```
+This will install TheHive Project repository (in /etc/yum.repos.d/thehive-rpm.repo) and the GPG public key (in
+/etc/pki/rpm-gpg/GPG-TheHive-Project).
+ 
+Then you will able to install Cortex package using yum
+```
+yum install cortex
+```
+
+After package installation, you should configure Cortex (see [configuration guide](../admin/configuration.md))
\ No newline at end of file

From 10168589949018c41361ccf2f75288732b2765e3 Mon Sep 17 00:00:00 2001
From: To-om <toom@thehive-project.org>
Date: Fri, 12 May 2017 11:21:03 +0200
Subject: [PATCH 28/32] Fix datatype lookup

---
 app/services/MispSrv.scala | 2 +-
 build.sbt                  | 7 +++----
 2 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/app/services/MispSrv.scala b/app/services/MispSrv.scala
index 139eb749c..c75ee7c23 100644
--- a/app/services/MispSrv.scala
+++ b/app/services/MispSrv.scala
@@ -261,7 +261,7 @@ class MispSrv(
     "mutex" → "other",
     "target-user" → "other",
     "target-email" → "mail",
-    "target-machine" → "hostname",
+    "target-machine" → "fqdn",
     "target-org" → "other",
     "target-location" → "other",
     "target-external" → "other",
diff --git a/build.sbt b/build.sbt
index 7943f8b20..5bc8677c3 100644
--- a/build.sbt
+++ b/build.sbt
@@ -35,9 +35,9 @@ mappings in packageBin in Assets ++= frontendFiles.value
 // Install files //
 mappings in Universal ~= {
   _.flatMap {
-    case (file, "conf/application.conf") => Nil
+    case (_, "conf/application.conf") => Nil
     case (file, "conf/apllication.sample") => Seq(file -> "conf/application.conf")
-    case (file, "conf/logback.xml") => Nil
+    case (_, "conf/logback.xml") => Nil
     case other => Seq(other)
   } ++ Seq(
     file("package/cortex.service") -> "package/cortex.service",
@@ -54,7 +54,7 @@ packageDescription := """--""".stripMargin
 defaultLinuxInstallLocation := "/opt"
 linuxPackageMappings ~= { _.map { pm =>
   val mappings = pm.mappings.filterNot {
-    case (file, path) => path.startsWith("/opt/cortex/package") || path.startsWith("/opt/cortex/conf")
+    case (_, path) => path.startsWith("/opt/cortex/package") || path.startsWith("/opt/cortex/conf")
   }
   com.typesafe.sbt.packager.linux.LinuxPackageMapping(mappings, pm.fileData).withConfig()
 } :+ packageMapping(
@@ -139,7 +139,6 @@ publish := {
 
 // Scalariform //
 import scalariform.formatter.preferences._
-import com.typesafe.sbt.SbtScalariform
 import com.typesafe.sbt.SbtScalariform.ScalariformKeys
 
 ScalariformKeys.preferences in ThisBuild := ScalariformKeys.preferences.value

From bdf3a2fe50dae4af233f4b78c3e3e9b31e5955d3 Mon Sep 17 00:00:00 2001
From: To-om <toom@thehive-project.org>
Date: Fri, 12 May 2017 11:33:23 +0200
Subject: [PATCH 29/32] #20 Publish rpm and deb packages

---
 build.sbt             | 12 ++++++---
 project/Bintray.scala | 61 ++++++++++++++++++++++++++++++++++++++-----
 2 files changed, 63 insertions(+), 10 deletions(-)

diff --git a/build.sbt b/build.sbt
index 5bc8677c3..f4212af3b 100644
--- a/build.sbt
+++ b/build.sbt
@@ -69,10 +69,9 @@ linuxPackageMappings ~= { _.map { pm =>
 packageBin := {
   (packageBin in Universal).value
   (packageBin in Debian).value
-  //(packageBin in Rpm).value
+  (packageBin in Rpm).value
 }
 // DEB //
-//debianPackageRecommends := Seq("elasticsearch")
 debianPackageDependencies += "java8-runtime-headless | java8-runtime"
 maintainerScripts in Debian := maintainerScriptsFromDirectory(
   baseDirectory.value / "package" / "debian",
@@ -82,7 +81,7 @@ linuxEtcDefaultTemplate in Debian := (baseDirectory.value / "package" / "etc_def
 linuxMakeStartScript in Debian := None
 
 // RPM //
-rpmRelease := "8"
+rpmRelease := "1"
 rpmVendor in Rpm := "TheHive Project"
 rpmUrl := Some("http://thehive-project.org/")
 rpmLicense := Some("AGPL")
@@ -94,6 +93,11 @@ maintainerScripts in Rpm := maintainerScriptsFromDirectory(
 linuxPackageSymlinks in Rpm := Nil
 rpmPrefix := Some(defaultLinuxInstallLocation.value)
 linuxEtcDefaultTemplate in Rpm := (baseDirectory.value / "package" / "etc_default_cortex").asURL
+packageBin in Rpm := {
+  val rpmFile = (packageBin in Rpm).value
+  s"rpm --addsign $rpmFile".!!
+  rpmFile
+}
 
 // DOCKER //
 import com.typesafe.sbt.packager.docker.{ Cmd, ExecCmd }
@@ -135,6 +139,8 @@ publish := {
   (publish in Docker).value
   PublishToBinTray.publishRelease.value
   PublishToBinTray.publishLatest.value
+  PublishToBinTray.publishRpm.value
+  PublishToBinTray.publishDebian.value
 }
 
 // Scalariform //
diff --git a/project/Bintray.scala b/project/Bintray.scala
index 55dec6007..40644bf90 100644
--- a/project/Bintray.scala
+++ b/project/Bintray.scala
@@ -1,10 +1,13 @@
 import java.io.File
 
 import bintray.BintrayCredentials
-import bintray.BintrayKeys.{bintrayEnsureCredentials, bintrayOrganization, bintrayPackage, bintrayRepository}
+import bintray.BintrayKeys.{ bintrayEnsureCredentials, bintrayOrganization, bintrayPackage, bintrayRepository }
 import bintry.Client
+import com.typesafe.sbt.packager.Keys.debianSign
+import com.typesafe.sbt.packager.debian.DebianPlugin.autoImport.Debian
+import com.typesafe.sbt.packager.rpm.RpmPlugin.autoImport.Rpm
 import com.typesafe.sbt.packager.universal.UniversalPlugin.autoImport.Universal
-import dispatch.{FunctionHandler, Http}
+import dispatch.{ FunctionHandler, Http }
 import sbt.Keys._
 import sbt._
 
@@ -15,6 +18,9 @@ import scala.concurrent.duration.Duration
 object PublishToBinTray extends Plugin {
   val publishRelease: TaskKey[Unit] = taskKey[Unit]("Publish binary in bintray")
   val publishLatest: TaskKey[Unit] = taskKey[Unit]("Publish latest binary in bintray")
+  val publishDebian: TaskKey[Unit] = taskKey[Unit]("publish debian package in Bintray")
+  val publishRpm: TaskKey[Unit] = taskKey[Unit]("publish rpm package in Bintray")
+
 
   override def settings = Seq(
     publishRelease := {
@@ -48,7 +54,34 @@ object PublishToBinTray extends Plugin {
           "latest",
           sLog.value)
       }
-    })
+    },
+    publishDebian in ThisBuild := {
+      val file = (debianSign in Debian).value
+      btPublish(file.getName,
+        file,
+        bintrayEnsureCredentials.value,
+        bintrayOrganization.value,
+        "debian",
+        bintrayPackage.value,
+        version.value,
+        sLog.value,
+        "deb_distribution" -> "any",
+        "deb_component" -> "main",
+        "deb_architecture" -> "all"
+      )
+    },
+    publishRpm in ThisBuild := {
+      val file = (packageBin in Rpm).value
+      btPublish(file.getName,
+        file,
+        bintrayEnsureCredentials.value,
+        bintrayOrganization.value,
+        "rpm",
+        bintrayPackage.value,
+        version.value,
+        sLog.value)
+    }
+  )
 
   private def asStatusAndBody = new FunctionHandler({ r => (r.getStatusCode, r.getResponseBody) })
 
@@ -61,15 +94,29 @@ object PublishToBinTray extends Plugin {
     }
   }
 
-  private def btPublish(filename: String, file: File, credential: BintrayCredentials, org: Option[String], repoName: String, packageName: String, version: String, log: Logger) = {
+  private def btPublish(filename: String,
+                        file: File,
+                        credential: BintrayCredentials,
+                        org: Option[String],
+                        repoName: String,
+                        packageName: String,
+                        version: String,
+                        log: Logger,
+                        additionalParams: (String, String)*) = {
     val BintrayCredentials(user, key) = credential
     val owner: String = org.getOrElse(user)
     val client: Client = Client(user, key, new Http())
     val repo: Client#Repo = client.repo(org.getOrElse(user), repoName)
 
-    log.info(s"Uploading $file ...")
-    Await.result(repo.get(packageName).version(version).upload(filename, file)(asStatusAndBody), Duration.Inf) match {
-      case (201, _)  => log.info(s"$file was uploaded to $owner/$packageName@$version")
+
+    val params = additionalParams
+      .map { case (k, v) => s"$k=$v" }
+      .mkString(";", ";", "")
+    val upload = repo.get(packageName).version(version).upload(filename + params, file)
+
+    log.info(s"Uploading $file ... (${org.getOrElse(user)}/$repoName/$packageName/$version/$filename$params)")
+    Await.result(upload(asStatusAndBody), Duration.Inf) match {
+      case (201, _) => log.info(s"$file was uploaded to $owner/$packageName@$version")
       case (_, fail) => sys.error(s"failed to upload $file to $owner/$packageName@$version: $fail")
     }
   }

From c2054e3abb7ab6e44d8deb7b96c310ccd5aa14cc Mon Sep 17 00:00:00 2001
From: To-om <toom@thehive-project.org>
Date: Fri, 12 May 2017 11:41:31 +0200
Subject: [PATCH 30/32] Update version and changelog

---
 CHANGELOG.md | 18 ++++++++++++++++--
 version.sbt  |  2 +-
 2 files changed, 17 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 503c8d8c0..66c904f35 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,7 +1,21 @@
 # Change Log
 
-## [1.0.2](https://github.com/CERT-BDF/Cortex/tree/1.0.2) (2017-04-18)
+## [1.1.0](https://github.com/CERT-BDF/Cortex/tree/1.1.0) (2017-05-12)
 
+[Full Changelog](https://github.com/CERT-BDF/Cortex/compare/1.0.2...1.1.0)
+
+**Implemented enhancements:**
+
+- Packaging [\#20](https://github.com/CERT-BDF/Cortex/issues/20)
+- Display analyzers metadata [\#18](https://github.com/CERT-BDF/Cortex/issues/18)
+- MISP integration feature request [\#21](https://github.com/CERT-BDF/Cortex/issues/21)
+
+**Closed issues:**
+
+- Display Cortex version on the footer [\#23](https://github.com/CERT-BDF/Cortex/issues/23)
+- Use new logo and favicon [\#22](https://github.com/CERT-BDF/Cortex/issues/22)
+
+## [1.0.2](https://github.com/CERT-BDF/Cortex/tree/1.0.2) (2017-04-19)
 [Full Changelog](https://github.com/CERT-BDF/Cortex/compare/1.0.1...1.0.2)
 
 **Fixed bugs:**
@@ -29,4 +43,4 @@
 ## [1.0.0](https://github.com/CERT-BDF/Cortex/tree/1.0.0) (2017-02-01)
 
 
-\* *This Change Log was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*
+\* *This Change Log was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*
\ No newline at end of file
diff --git a/version.sbt b/version.sbt
index 11475a2c5..48af491ec 100644
--- a/version.sbt
+++ b/version.sbt
@@ -1 +1 @@
-version in ThisBuild := "1.0.2"
+version in ThisBuild := "1.1.0"

From 12ea7156b5068c907daeffc2dafc11338ca20836 Mon Sep 17 00:00:00 2001
From: To-om <toom@thehive-project.org>
Date: Fri, 12 May 2017 12:05:37 +0200
Subject: [PATCH 31/32] Add PGP public key

---
 CHANGELOG.md                   |  3 +-
 PGP-PUBLIC-KEY                 | 52 ++++++++++++++++++++++++++++++++++
 docs/installation/deb-guide.md |  4 +--
 docs/installation/rpm-guide.md |  4 +--
 4 files changed, 58 insertions(+), 5 deletions(-)
 create mode 100644 PGP-PUBLIC-KEY

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 66c904f35..63e644c68 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,7 +6,7 @@
 
 **Implemented enhancements:**
 
-- Packaging [\#20](https://github.com/CERT-BDF/Cortex/issues/20)
+- Add support to .deb and .rpm package generation [\#20](https://github.com/CERT-BDF/Cortex/issues/20)
 - Display analyzers metadata [\#18](https://github.com/CERT-BDF/Cortex/issues/18)
 - MISP integration feature request [\#21](https://github.com/CERT-BDF/Cortex/issues/21)
 
@@ -14,6 +14,7 @@
 
 - Display Cortex version on the footer [\#23](https://github.com/CERT-BDF/Cortex/issues/23)
 - Use new logo and favicon [\#22](https://github.com/CERT-BDF/Cortex/issues/22)
+- Scala code cleanup [\#19](https://github.com/CERT-BDF/Cortex/issues/19)
 
 ## [1.0.2](https://github.com/CERT-BDF/Cortex/tree/1.0.2) (2017-04-19)
 [Full Changelog](https://github.com/CERT-BDF/Cortex/compare/1.0.1...1.0.2)
diff --git a/PGP-PUBLIC-KEY b/PGP-PUBLIC-KEY
new file mode 100644
index 000000000..756215599
--- /dev/null
+++ b/PGP-PUBLIC-KEY
@@ -0,0 +1,52 @@
+-----BEGIN PGP PUBLIC KEY BLOCK-----
+Version: GnuPG v1
+
+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
+=f0Hb
+-----END PGP PUBLIC KEY BLOCK-----
diff --git a/docs/installation/deb-guide.md b/docs/installation/deb-guide.md
index fab273c22..7fbecf1af 100644
--- a/docs/installation/deb-guide.md
+++ b/docs/installation/deb-guide.md
@@ -1,7 +1,7 @@
 # Installation of TheHive using DEB package
 
-Debian packages are published on Bintray repository. All packages are signed using the key 562CBC1C (fingerprint: 0CD5
-AC59 DE5C 5A8E 0EE1  3849 3D99 BB18 562C BC1C):
+Debian packages are published on Bintray repository. All packages are signed using the key [562CBC1C](/PGP-PUBLIC-KEY)
+(fingerprint: 0CD5 AC59 DE5C 5A8E 0EE1  3849 3D99 BB18 562C BC1C):
 
 ```
 echo 'deb https://dl.bintray.com/cert-bdf/debian any main' | sudo tee -a /etc/apt/sources.list.d/thehive-project.list
diff --git a/docs/installation/rpm-guide.md b/docs/installation/rpm-guide.md
index 92f4a9865..8cc639d6c 100644
--- a/docs/installation/rpm-guide.md
+++ b/docs/installation/rpm-guide.md
@@ -1,7 +1,7 @@
 # Installation of TheHive using RPM package
 
-RPM packages are published on Bintray repository. All packages are signed using the key 562CBC1C (fingerprint: 0CD5
-AC59 DE5C 5A8E 0EE1  3849 3D99 BB18 562C BC1C)
+RPM packages are published on Bintray repository. All packages are signed using the key [562CBC1C](/PGP-PUBLIC-KEY)
+(fingerprint: 0CD5 AC59 DE5C 5A8E 0EE1  3849 3D99 BB18 562C BC1C)
 
 First install rpm release package:
 ```

From 8921d159b103d77d2e665d87201c13814a85ffa2 Mon Sep 17 00:00:00 2001
From: To-om <toom@thehive-project.org>
Date: Fri, 12 May 2017 16:19:58 +0200
Subject: [PATCH 32/32] Use master branch of cortex analyzers to build docker

---
 build.sbt | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/build.sbt b/build.sbt
index f4212af3b..75bf94c82 100644
--- a/build.sbt
+++ b/build.sbt
@@ -124,8 +124,8 @@ dockerCommands ~= { dc =>
         "apt-get update && " +
           "apt-get install -y --no-install-recommends python-pip python2.7-dev ssdeep libfuzzy-dev libfuzzy2 libimage-exiftool-perl libmagic1 build-essential git && " +
           "cd /opt && " +
-          "git clone -b develop https://github.com/CERT-BDF/Cortex-Analyzers.git && " +
-          "pip install $(cat Cortex-Analyzers/analyzers/*/requirements.txt | grep -v hashlib | sort -u)"),
+          "git clone https://github.com/CERT-BDF/Cortex-Analyzers.git && " +
+          "pip install $(sort -u Cortex-Analyzers/analyzers/*/requirements.txt)"),
       Cmd("ADD", "var", "/var"),
       Cmd("ADD", "etc", "/etc"),
       ExecCmd("RUN", "chown", "-R", "daemon:daemon", "/var/log/cortex")) ++