diff --git a/.vitepress/sidebars/guides.ts b/.vitepress/sidebars/guides.ts index e0964cca..ac2b22c1 100644 --- a/.vitepress/sidebars/guides.ts +++ b/.vitepress/sidebars/guides.ts @@ -12,6 +12,10 @@ export const guidesSidebar: DefaultTheme.SidebarItem[] = [ text: "Importing Caido's CA Certificate", link: "/guides/ca_certificate_importing", }, + { + text: "Using the Caido Browser Extension", + link: "/guides/caido_extension", + }, { text: "Using FoxyProxy", link: "/guides/foxyproxy.md", diff --git a/src/_images/caido_extension_auto.png b/src/_images/caido_extension_auto.png new file mode 100644 index 00000000..794ec158 Binary files /dev/null and b/src/_images/caido_extension_auto.png differ diff --git a/src/_images/caido_extension_enable.png b/src/_images/caido_extension_enable.png new file mode 100644 index 00000000..30deb4ea Binary files /dev/null and b/src/_images/caido_extension_enable.png differ diff --git a/src/_images/caido_extension_manual.png b/src/_images/caido_extension_manual.png new file mode 100644 index 00000000..74cf72ea Binary files /dev/null and b/src/_images/caido_extension_manual.png differ diff --git a/src/_images/caido_extension_options.png b/src/_images/caido_extension_options.png new file mode 100644 index 00000000..743493c6 Binary files /dev/null and b/src/_images/caido_extension_options.png differ diff --git a/src/_images/firefox_add_caido_extension.png b/src/_images/firefox_add_caido_extension.png new file mode 100644 index 00000000..b700d812 Binary files /dev/null and b/src/_images/firefox_add_caido_extension.png differ diff --git a/src/_images/firefox_caido_extension_added.png b/src/_images/firefox_caido_extension_added.png new file mode 100644 index 00000000..1f0002d0 Binary files /dev/null and b/src/_images/firefox_caido_extension_added.png differ diff --git a/src/guides/ca_certificate_importing.md b/src/guides/ca_certificate_importing.md index fca1b576..4717232a 100644 --- a/src/guides/ca_certificate_importing.md +++ b/src/guides/ca_certificate_importing.md @@ -38,4 +38,4 @@ Once the certificate has been downloaded, continue with the import instructions 5. **Click** `OK` to close the Certificate Manager window. -6. Continue with either the [Using FoxyProxy](/guides/foxyproxy.md#firefox) or [Using ZeroOmega](/guides/zeroomega.md#firefox) guides for Firefox. +6. Continue with either the [Using the Caido Extension](/guides/caido_extension.md), [Using FoxyProxy](/guides/foxyproxy.md#firefox) or [Using ZeroOmega](/guides/zeroomega.md#firefox) guides for Firefox. diff --git a/src/guides/caido_extension.md b/src/guides/caido_extension.md new file mode 100644 index 00000000..9bb0f89a --- /dev/null +++ b/src/guides/caido_extension.md @@ -0,0 +1,56 @@ +--- +description: "A step-by-step guide to installing and configuring the Caido browser extension for Firefox." +--- + +# Using the Caido Browser Extension + +Caido's browser extension gives you the ability to quickly enable/disable your browser's use of Caido as a proxy. + +## Firefox + +To install the browser extension, launch the Firefox browser, navigate to [https://addons.mozilla.org/en-US/firefox/addon/caido-extension/](https://addons.mozilla.org/en-US/firefox/addon/caido-extension/), and **click** on the `Add to Firefox` button. + +In the pop-up window, select `Allow extension to run in private windows`, and then click on the `Add` button. + +Add FoxyProxy pop-up window. + +In the subsequent pop-up window, **click** on the `OK` button. + +FoxyProxy added to Firefox. + +Once the extension is installed, [continue to the configuration instructions](#configuring-the-caido-browser-extension). + +## Configuring the Caido Browser Extension + +**Click** on the Caido Extension toolbar button. + +The Caido Extension toolbar interface. + +### Automatic Configuration + +To automatically detect the proxy settings of your instance and create a configuration, launch Caido and **click** on the Auto-detect button. + +Auto-detect. + +**Click** on the Confirm button to save the configuration. + +### Manual Configuration + +To manually create a configuration, **click** on the `+ Create a proxy` button. + +In the configuration interface, give an arbitrary name to the proxy configuration in the `Name` input field, and set the following settings: + +- `Host`: `127.0.0.1` +- `Port`: `8080` + +Manual configuration. + +Once the configuration is set, **click** on the `+ Create` button. + +## Enabling/Disabling Proxying + +To enable proxying to pass web traffic through Caido, **click** on the Caido Extension toolbar button and **click** on the sliding radio button. + +Enabling the configuration. + +To disable proxying, **click** on the sliding radio button to remove its fill.