Updated docs and ran notebooks

Author: Cyb3rWard0g

.gitignore

@@ -1,3 +1,5 @@
+docs/_build/
+docs/source/
 # Byte-compiled / optimized / DLL files
 __pycache__/
 *.py[cod]

Dockerfile

@@ -20,7 +20,7 @@ RUN adduser --disabled-password \
     ${NB_USER} \
     && python3 -m pip install --upgrade six==1.15.0 attackcti==0.3.4.3 pandas==1.1.4 altair vega
 
-COPY notebooks ${HOME}/notebooks
+COPY docs/playground/* ${HOME}/notebooks
 
 RUN chown -R ${NB_USER}:${NB_USER} ${HOME} ${JUPYTER_DIR}
 

docs/Makefile

@@ -0,0 +1,37 @@
+# Book settings
+# Learn more at https://jupyterbook.org/customize/config.html
+
+title: ATTACK Python Client
+author: Roberto Rodriguez @Cyb3rWard0g
+logo: logo.png
+
+# Force re-execution of notebooks on each build.
+# See https://jupyterbook.org/content/execute.html
+execute:
+  execute_notebooks: force
+
+# Define the name of the latex output file for PDF builds
+latex:
+  latex_documents:
+    targetname: book.tex
+
+# Add a bibtex file so that we can create citations
+#bibtex_bibfiles:
+#  - references.bib
+
+# Information about where the book exists on the web
+repository:
+  url: https://github.com/OTRF/ATTACK-Python-Client # Online location of your book
+  path_to_book: docs  # Optional path to your book, relative to the repository root
+  branch: master  # Which branch of the repository should be used when creating links (optional)
+
+# Add GitHub buttons to your book
+# See https://jupyterbook.org/customize/config.html#add-a-link-to-your-repository
+html:
+  use_repository_button: true
+  use_issues_button: true
+  baseurl: https://attackcti.com/
+
+launch_buttons:
+  notebook_interface: "classic" # The interface interactive links will activate ["classic", "jupyterlab"]
+  binderhub_url: "https://mybinder.org"

docs/_config.yml

@@ -0,0 +1,13 @@
+# Table of content
+# Learn more at https://jupyterbook.org/customize/toc.html
+#
+- file: intro
+- part: Playground
+  chapters:
+  - file: playground/ATT&CK_DataSources
+  - file: playground/Export_All_Techniques
+  - file: playground/export_groups_navigator_layers
+  - file: playground/ICS_ATTACK_Exploration
+  - file: playground/techniques_by_datasources
+  - file: playground/Usage_Basics
+  - file: playground/Usage_Filters

docs/_toc.yml

@@ -0,0 +1,95 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Introduction\n",
+    "\n",
+    "[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/OTRF/ATTACK-Python-Client/master)\n",
+    "[![Open_Threat_Research Community](https://img.shields.io/badge/Open_Threat_Research-Community-brightgreen.svg)](https://twitter.com/OTR_Community)\n",
+    "[![Open Source Love svg1](https://badges.frapsoft.com/os/v3/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/)\n",
+    "\n",
+    "A Python module to access up to date ATT&CK content available in STIX via public TAXII server. This project leverages the python classes and functions of the [cti-python-stix2](https://github.com/oasis-open/cti-python-stix2) and [cti-taxii-client](https://github.com/oasis-open/cti-taxii-client) libraries developed by MITRE.\n",
+    "\n",
+    "## Goals\n",
+    "\n",
+    "* Provide an easy way to access and interact with up to date ATT&CK content available in STIX via public TAXII server\n",
+    "* Allow security analysts to quickly explore ATT&CK content and apply it in their daily operations\n",
+    "* Allow the integration of ATT&Ck content with other platforms to host up to date information from the framework\n",
+    "* Help security analysts during the transition from the ATT&CK MediaWiki API to the STIX/TAXII 2.0 API\n",
+    "* Learn STIX2 and TAXII Client Python libraries\n",
+    "\n",
+    "## Current Status: Production/Stable\n",
+    "\n",
+    "The project is currently in a Production/Stable stage, which means that the current main functions are more stable. I would love to get your feedback to make it a better project.\n",
+    "\n",
+    "## Resources\n",
+    "\n",
+    "* [MITRE CTI](https://github.com/mitre/cti)\n",
+    "* [OASIS CTI TAXII Client](https://github.com/oasis-open/cti-taxii-client)\n",
+    "* [OASIS CTI Python STIX2](https://github.com/oasis-open/cti-python-stix2)\n",
+    "* [MITRE ATT&CK Framework](https://attack.mitre.org/wiki/Main_Page)\n",
+    "* [ATT&CK MediaWiki API](https://attack.mitre.org/wiki/Using_the_API)\n",
+    "* [Invoke-ATTACKAPI](https://github.com/Cyb3rWard0g/Invoke-ATTACKAPI)\n",
+    "* [Mitre-Attack-API](https://github.com/annamcabee/Mitre-Attack-API)\n",
+    "\n",
+    "### Requirements\n",
+    "\n",
+    "Python 3+\n",
+    "\n",
+    "### Installation\n",
+    "\n",
+    "You can install it via PIP:\n",
+    "\n",
+    "```\n",
+    "pip install attackcti\n",
+    "```\n",
+    "\n",
+    "Or you can also do the following:\n",
+    "\n",
+    "```\n",
+    "git clone https://github.com/OTRF/ATTACK-Python-Client\n",
+    "cd ATTACK-Python-Client\n",
+    "pip install .\n",
+    "```\n",
+    "\n",
+    "## Author\n",
+    "\n",
+    "* Roberto Rodriguez [@Cyb3rWard0g](https://twitter.com/Cyb3rWard0g)\n",
+    "\n",
+    "## Official Committers\n",
+    "\n",
+    "* Jose Luis Rodriguez [@Cyb3rPandaH](https://twitter.com/Cyb3rPandaH)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "PySpark_Python3",
+   "language": "python",
+   "name": "pyspark3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.7.3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}