diff --git a/integrations/ctfd_dploy/README.md b/integrations/ctfd_dploy/README.md new file mode 100644 index 0000000..2a3653b --- /dev/null +++ b/integrations/ctfd_dploy/README.md @@ -0,0 +1,152 @@ +# CTFd → Dploy plugin + +A [CTFd](https://ctfd.io) plugin that lets players **start, stop, extend and +check** an on-demand [Dploy](https://docs.dploy.dev) environment **directly from +the challenge view** — no separate Dploy login, no copy-pasting tokens. + +It pairs with the companion +[`ctfd-oidc-provider`](https://github.com/AYDEV-FR/ctfd-oidc-provider) plugin: +CTFd is the **OIDC Provider** of Dploy, so a CTFd-issued token is exactly what +Dploy's API trusts. The plugin obtains one for the logged-in player behind the +scenes and forwards it to Dploy. + +## How a challenge becomes a "Dploy challenge" + +There is **no custom challenge type**. Any standard challenge becomes a Dploy +challenge when its **Connection Info** is a Dploy *run URL*: + +``` +https://dploy.example.com/run/