docs: add action docs (#19)

docs/action.mdx

@@ -0,0 +1,35 @@
+---
+title: Action List
+description: Learn how to configure your actions in CasWAF.
+keywords: [caswaf]
+authors: [casbin]
+---
+`Action` is related to the rules used in the site to handle requests.
+
+This section will provide a detailed explanation of the properties and usage of `Action`.
+
+## Action properties
+
+- `Name`: The name of the action.
+- `Type`: The type of the action. It can be set to `Allow`, `Block` and `Captcha`.
+- `Status Code`: The status code of the action. It can be set to any HTTP status code.
+
+## Manage Actions
+
+![actions](/img/actions/actions.jpg)
+
+In the Actions page, you will see all actions you have created. You can create, edit, delete and view the action details. But now we don't have any actions.
+
+## Add an action
+
+![addaction](/img/actions/addaction.jpg)
+
+Just click the `Add` button, you will create an action. The created action will have some default information that you can modify.
+
+## Edit action
+
+After you create an action, you can click the `edit` button to edit the action.
+
+![editaction](/img/actions/editaction.jpg)
+
+Each field's meaning is as described above, and you can freely modify them according to the actual situation of your website.

docs/allow-action.mdx

@@ -0,0 +1,11 @@
+---
+title: Allow Action
+description: Learn how to configure your Allow Action in CasWAF.
+keywords: [caswaf]
+authors: [casbin]
+---
+CasWAF provides a easy-to-use Allow Action feature to help you control the access of your website. You can add Allow Actions to allow specific requests to your website.
+
+![allow-action](/img/actions/allow-action.jpg)
+
+It is recommended to set the `Status Code` to `200` for the `Allow` action. When the rule is hitted and its action is `Allow`, CasWAF will respond with a status code of `200`.

docs/block-action.mdx

@@ -0,0 +1,11 @@
+---
+title: Block Action
+description: Learn how to configure your Block Action in CasWAF.
+keywords: [caswaf]
+authors: [casbin]
+---
+CasWAF provides a easy-to-use Block Action feature to help you control the access of your website. You can add Block Actions to block specific requests to your website.
+
+![block-action](/img/actions/block-action.jpg)
+
+It is recommended to follow the HTTP status code standard when setting the `Status Code` for the `Block` action. When the rule is hitted and its action is `Block`, CasWAF will respond with the specified status code.

docs/captcha-action.mdx

@@ -0,0 +1,15 @@
+---
+title: Captcha Action
+description: Learn how to configure your Captcha Action in CasWAF.
+keywords: [caswaf]
+authors: [casbin]
+---
+CasWAF provides a easy-to-use Captcha Action feature to help you control the access of your website. You can add Captcha Actions to require users to pass a CAPTCHA verification before accessing your website.
+
+![captcha-action](/img/actions/captcha-action.jpg)
+
+Before adding a Captcha Action, you need to make sure that you have added a Captcha applications in your Casdoor instance and your Casdoor version is greater than or equal to `v1.681.0`.
+
+## Captcha Action properties
+
+- `Immunity times`: Used in the `Captcha` type. The times that the user can access the site without captcha verification after passing the captcha verification. It should be a positive integer.

sidebars.js

@@ -51,6 +51,17 @@ module.exports = {
         "compound-rule",
       ],
     },
+    {
+      type: "category",
+      label: "Actions",
+      link: {type: "generated-index"},
+      items: [
+        "action",
+        "allow-action",
+        "block-action",
+        "captcha-action",
+      ],
+    },
     // {
     //   type: "category",
     //   label: "",