Compare commits
8 Commits
propose-wa
...
main
| Author | SHA1 | Date | |
|---|---|---|---|
| ccad9617d3 | |||
| bad4eefb1a | |||
| 1bc7ad86dd | |||
| 03dfa28ad9 | |||
| ead72230ce | |||
| 3a15b1ebd8 | |||
| d0437f6afb | |||
| c25c20bac6 |
@ -134,6 +134,8 @@ Response Parameters
|
||||
+-----------------------+-----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| protect_status | Integer | WAF status of the protected domain name. |
|
||||
| | | |
|
||||
| | | - -1: Bypassed. Requests are directly sent to the backend servers without passing through WAF. |
|
||||
| | | |
|
||||
| | | - 0: Suspended. WAF only forwards requests for the domain name but does not detect attacks. -1: Enabled. WAF detects attacks based on the configured policy. |
|
||||
+-----------------------+-----------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| access_status | Integer | Whether a domain name is connected to WAF. |
|
||||
@ -324,7 +326,7 @@ Example Requests
|
||||
|
||||
.. code-block:: text
|
||||
|
||||
POST https://{Endpoint}/v1/{project_id}/premium-waf/host?
|
||||
POST https://{Endpoint}/v1/{project_id}/premium-waf/host?enterprise_project_id=0
|
||||
|
||||
{
|
||||
"hostname" : "www.demo.com",
|
||||
|
||||
@ -68,6 +68,8 @@ Response Parameters
|
||||
+-----------------------+-----------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+
|
||||
| protect_status | Integer | WAF status of the protected domain name. The value can be: |
|
||||
| | | |
|
||||
| | | - -1: Bypassed. Requests are directly sent to the backend servers without passing through WAF. |
|
||||
| | | |
|
||||
| | | - 0: Suspended. WAF only forwards requests for the domain name but does not detect attacks. |
|
||||
| | | |
|
||||
| | | - 1: Enabled. WAF detects attacks based on the configured policy. |
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -94,6 +94,8 @@ Response Parameters
|
||||
+-----------------------+---------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| protect_status | Integer | WAF status of the protected domain name. The value can be: |
|
||||
| | | |
|
||||
| | | - -1: Bypassed. Requests are directly sent to the backend servers without passing through WAF. |
|
||||
| | | |
|
||||
| | | - 0: Suspended. WAF only forwards requests for the domain name but does not detect attacks. |
|
||||
| | | |
|
||||
| | | - 1: Enabled. WAF detects attacks based on the configured policy. |
|
||||
|
||||
@ -45,7 +45,7 @@ Request Parameters
|
||||
+--------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| Parameter | Mandatory | Type | Description |
|
||||
+====================+=================+=================+============================================================================================================================================================================================================+
|
||||
| name | Yes | String | Rule name. |
|
||||
| name | No | String | Rule name. |
|
||||
+--------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| description | No | String | Rule description. |
|
||||
+--------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
|
||||
@ -73,9 +73,7 @@ Request Parameters
|
||||
| | | | |
|
||||
| | | | - Israel: Israel |
|
||||
| | | | |
|
||||
| | | | - Iraq: Iraq |
|
||||
| | | | |
|
||||
| | | | - Afghanistan: Afghanistan |
|
||||
| | | | - Iraq: Afghanistan |
|
||||
| | | | |
|
||||
| | | | - Libya: Libya |
|
||||
| | | | |
|
||||
@ -152,9 +150,7 @@ Response Parameters
|
||||
| | | |
|
||||
| | | - Israel: Israel |
|
||||
| | | |
|
||||
| | | - Iraq: Iraq |
|
||||
| | | |
|
||||
| | | - Afghanistan: Afghanistan |
|
||||
| | | - Iraq: Afghanistan |
|
||||
| | | |
|
||||
| | | - Libya: Libya |
|
||||
| | | |
|
||||
|
||||
@ -88,9 +88,7 @@ Response Parameters
|
||||
| | | |
|
||||
| | | - Israel: Israel |
|
||||
| | | |
|
||||
| | | - Iraq: Iraq |
|
||||
| | | |
|
||||
| | | - Afghanistan: Afghanistan |
|
||||
| | | - Iraq: Afghanistan |
|
||||
| | | |
|
||||
| | | - Libya: Libya |
|
||||
| | | |
|
||||
@ -165,7 +163,7 @@ Example Requests
|
||||
|
||||
.. code-block:: text
|
||||
|
||||
DELETE https://{Endpoint}/v1/{project_id}/waf/policy/{policy_id}/geoip/{rule_id}?
|
||||
DELETE https://{Endpoint}/v1/{project_id}/waf/policy/{policy_id}/geoip/{rule_id}?enterprise_project_id=0
|
||||
|
||||
Example Responses
|
||||
-----------------
|
||||
|
||||
@ -45,7 +45,7 @@ Request Parameters
|
||||
+=================+=================+=================+==============================================================================================================+
|
||||
| X-Auth-Token | Yes | String | User token. It can be obtained by calling the IAM API (value of **X-Subject-Token** in the response header). |
|
||||
+-----------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------+
|
||||
| Content-Type | No | String | Content type. |
|
||||
| Content-Type | Yes | String | Content type. |
|
||||
| | | | |
|
||||
| | | | Default: **application/json;charset=utf8** |
|
||||
+-----------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------+
|
||||
|
||||
@ -13,17 +13,17 @@ This API is used to delete a reference table.
|
||||
URI
|
||||
---
|
||||
|
||||
DELETE /v1/{project_id}/waf/valuelist/{valuelist_id}
|
||||
DELETE /v1/{project_id}/waf/valuelist/{table_id}
|
||||
|
||||
.. table:: **Table 1** Path Parameters
|
||||
|
||||
+--------------+-----------+--------+---------------------------------------------------------------------------------------+
|
||||
| Parameter | Mandatory | Type | Description |
|
||||
+==============+===========+========+=======================================================================================+
|
||||
| project_id | Yes | String | Project ID |
|
||||
+--------------+-----------+--------+---------------------------------------------------------------------------------------+
|
||||
| valuelist_id | Yes | String | Valuelist ID. It can be obtained by calling the API Querying the Reference Table List |
|
||||
+--------------+-----------+--------+---------------------------------------------------------------------------------------+
|
||||
+------------+-----------+--------+---------------------------------------------------------------------------------------------+
|
||||
| Parameter | Mandatory | Type | Description |
|
||||
+============+===========+========+=============================================================================================+
|
||||
| project_id | Yes | String | Project ID |
|
||||
+------------+-----------+--------+---------------------------------------------------------------------------------------------+
|
||||
| table_id | Yes | String | Reference table ID. It can be obtained by calling the API Querying the Reference Table List |
|
||||
+------------+-----------+--------+---------------------------------------------------------------------------------------------+
|
||||
|
||||
Request Parameters
|
||||
------------------
|
||||
|
||||
@ -58,7 +58,7 @@ Rule Management
|
||||
- :ref:`Deleting a Geolocation Access Control Rule <deletegeoiprule>`
|
||||
- :ref:`Querying the Reference Table List <listvaluelist>`
|
||||
- :ref:`Creating a Reference Table <createvaluelist>`
|
||||
- :ref:`Querying a Reference Table <showvaluelist>`
|
||||
- :ref:`Querying a Reference Table by ID <showvaluelist>`
|
||||
- :ref:`Modifying a Reference Table <updatevaluelist>`
|
||||
- :ref:`Deleting a Reference Table <deletevaluelist>`
|
||||
|
||||
@ -119,6 +119,6 @@ Rule Management
|
||||
deleting_a_geolocation_access_control_rule
|
||||
querying_the_reference_table_list
|
||||
creating_a_reference_table
|
||||
querying_a_reference_table
|
||||
querying_a_reference_table_by_id
|
||||
modifying_a_reference_table
|
||||
deleting_a_reference_table
|
||||
|
||||
@ -13,17 +13,17 @@ This API is used to modify a reference table.
|
||||
URI
|
||||
---
|
||||
|
||||
PUT /v1/{project_id}/waf/valuelist/{valuelist_id}
|
||||
PUT /v1/{project_id}/waf/valuelist/{table_id}
|
||||
|
||||
.. table:: **Table 1** Path Parameters
|
||||
|
||||
+--------------+-----------+--------+---------------------------------------------------------------------------------------+
|
||||
| Parameter | Mandatory | Type | Description |
|
||||
+==============+===========+========+=======================================================================================+
|
||||
| project_id | Yes | String | Project ID |
|
||||
+--------------+-----------+--------+---------------------------------------------------------------------------------------+
|
||||
| valuelist_id | Yes | String | Valuelist ID. It can be obtained by calling the API Querying the Reference Table List |
|
||||
+--------------+-----------+--------+---------------------------------------------------------------------------------------+
|
||||
+------------+-----------+--------+---------------------------------------------------------------------------------------------+
|
||||
| Parameter | Mandatory | Type | Description |
|
||||
+============+===========+========+=============================================================================================+
|
||||
| project_id | Yes | String | Project ID |
|
||||
+------------+-----------+--------+---------------------------------------------------------------------------------------------+
|
||||
| table_id | Yes | String | Reference table ID. It can be obtained by calling the API Querying the Reference Table List |
|
||||
+------------+-----------+--------+---------------------------------------------------------------------------------------------+
|
||||
|
||||
Request Parameters
|
||||
------------------
|
||||
|
||||
@ -37,7 +37,7 @@ Request Parameters
|
||||
+=================+=================+=================+============================================+
|
||||
| X-Auth-Token | Yes | String | User token |
|
||||
+-----------------+-----------------+-----------------+--------------------------------------------+
|
||||
| Content-Type | No | String | Content type |
|
||||
| Content-Type | Yes | String | Content type |
|
||||
| | | | |
|
||||
| | | | Default: **application/json;charset=utf8** |
|
||||
+-----------------+-----------------+-----------------+--------------------------------------------+
|
||||
@ -88,9 +88,7 @@ Response Parameters
|
||||
| | | |
|
||||
| | | - Israel: Israel |
|
||||
| | | |
|
||||
| | | - Iraq: Iraq |
|
||||
| | | |
|
||||
| | | - Afghanistan: Afghanistan |
|
||||
| | | - Iraq: Afghanistan |
|
||||
| | | |
|
||||
| | | - Libya: Libya |
|
||||
| | | |
|
||||
|
||||
@ -45,7 +45,7 @@ Request Parameters
|
||||
+=================+=================+=================+==============================================================================================================+
|
||||
| X-Auth-Token | Yes | String | User token. It can be obtained by calling the IAM API (value of **X-Subject-Token** in the response header). |
|
||||
+-----------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------+
|
||||
| Content-Type | No | String | Content type. |
|
||||
| Content-Type | Yes | String | Content type. |
|
||||
| | | | |
|
||||
| | | | Default: **application/json;charset=utf8** |
|
||||
+-----------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------+
|
||||
|
||||
@ -2,28 +2,28 @@
|
||||
|
||||
.. _ShowValueList:
|
||||
|
||||
Querying a Reference Table
|
||||
==========================
|
||||
Querying a Reference Table by ID
|
||||
================================
|
||||
|
||||
Function
|
||||
--------
|
||||
|
||||
This API is used to query a reference table.
|
||||
This API is used to query a reference table by ID.
|
||||
|
||||
URI
|
||||
---
|
||||
|
||||
GET /v1/{project_id}/waf/valuelist/{valuelist_id}
|
||||
GET /v1/{project_id}/waf/valuelist/{table_id}
|
||||
|
||||
.. table:: **Table 1** Path Parameters
|
||||
|
||||
+--------------+-----------+--------+---------------------------------------------------------------------------------------+
|
||||
| Parameter | Mandatory | Type | Description |
|
||||
+==============+===========+========+=======================================================================================+
|
||||
| project_id | Yes | String | Project ID |
|
||||
+--------------+-----------+--------+---------------------------------------------------------------------------------------+
|
||||
| valuelist_id | Yes | String | Valuelist ID. It can be obtained by calling the API Querying the Reference Table List |
|
||||
+--------------+-----------+--------+---------------------------------------------------------------------------------------+
|
||||
+------------+-----------+--------+---------------------------------------------------------------------------------------------+
|
||||
| Parameter | Mandatory | Type | Description |
|
||||
+============+===========+========+=============================================================================================+
|
||||
| project_id | Yes | String | Project ID |
|
||||
+------------+-----------+--------+---------------------------------------------------------------------------------------------+
|
||||
| table_id | Yes | String | Reference table ID. It can be obtained by calling the API Querying the Reference Table List |
|
||||
+------------+-----------+--------+---------------------------------------------------------------------------------------------+
|
||||
|
||||
Request Parameters
|
||||
------------------
|
||||
@ -53,7 +53,7 @@ Request Parameters
|
||||
+=================+=================+=================+==============================================================================================================+
|
||||
| X-Auth-Token | Yes | String | User token. It can be obtained by calling the IAM API (value of **X-Subject-Token** in the response header). |
|
||||
+-----------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------+
|
||||
| Content-Type | No | String | Content type. |
|
||||
| Content-Type | Yes | String | Content type. |
|
||||
| | | | |
|
||||
| | | | Default: **application/json;charset=utf8** |
|
||||
+-----------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------+
|
||||
|
||||
@ -112,9 +112,7 @@ Response Parameters
|
||||
| | | |
|
||||
| | | - Israel: Israel |
|
||||
| | | |
|
||||
| | | - Iraq: Iraq |
|
||||
| | | |
|
||||
| | | - Afghanistan: Afghanistan |
|
||||
| | | - Iraq: Afghanistan |
|
||||
| | | |
|
||||
| | | - Libya: Libya |
|
||||
| | | |
|
||||
|
||||
@ -75,9 +75,7 @@ Request Parameters
|
||||
| | | | |
|
||||
| | | | - Israel: Israel |
|
||||
| | | | |
|
||||
| | | | - Iraq: Iraq |
|
||||
| | | | |
|
||||
| | | | - Afghanistan: Afghanistan |
|
||||
| | | | - Iraq: Afghanistan |
|
||||
| | | | |
|
||||
| | | | - Libya: Libya |
|
||||
| | | | |
|
||||
@ -154,9 +152,7 @@ Response Parameters
|
||||
| | | |
|
||||
| | | - Israel: Israel |
|
||||
| | | |
|
||||
| | | - Iraq: Iraq |
|
||||
| | | |
|
||||
| | | - Afghanistan: Afghanistan |
|
||||
| | | - Iraq: Afghanistan |
|
||||
| | | |
|
||||
| | | - Libya: Libya |
|
||||
| | | |
|
||||
|
||||
@ -8,8 +8,6 @@ Change History
|
||||
+-----------------------------------+----------------------------------------------------------------------------------------------------+
|
||||
| Released On | Description |
|
||||
+===================================+====================================================================================================+
|
||||
| 2023-04-23 | Revised the document based on review comments. |
|
||||
+-----------------------------------+----------------------------------------------------------------------------------------------------+
|
||||
| 2023-03-30 | - Added "Geographical Location Codes." |
|
||||
| | - Revised the document based on review comments. |
|
||||
+-----------------------------------+----------------------------------------------------------------------------------------------------+
|
||||
|
||||
@ -18,7 +18,7 @@ import os
|
||||
import sys
|
||||
|
||||
extensions = [
|
||||
'otcdocstheme'
|
||||
'otcdocstheme',
|
||||
]
|
||||
|
||||
otcdocs_auto_name = False
|
||||
@ -30,6 +30,17 @@ otcdocs_repo_name = 'docs/web-application-firewall-dedicated'
|
||||
otcdocs_git_fqdn = 'gitea.eco.tsi-dev.otc-service.com'
|
||||
otcdocs_git_type = 'gitea'
|
||||
|
||||
# Those variables are needed for indexing into OpenSearch
|
||||
otcdocs_doc_environment = 'internal'
|
||||
otcdocs_doc_link = '/web-application-firewall-dedicated/api-ref/'
|
||||
otcdocs_doc_title = 'API Reference'
|
||||
otcdocs_doc_type = 'api-ref'
|
||||
otcdocs_service_category = 'security-services'
|
||||
otcdocs_service_title = 'Dedicated Web Application Firewall'
|
||||
otcdocs_service_type = 'wafd'
|
||||
otcdocs_search_environment = 'hc_de'
|
||||
otcdocs_search_url = "https://opensearch.eco.tsi-dev.otc-service.com/"
|
||||
|
||||
# If extensions (or modules to document with autodoc) are in another directory,
|
||||
# add these directories to sys.path here. If the directory is relative to the
|
||||
# documentation root, use os.path.abspath to make it absolute, like shown here.
|
||||
|
||||
0
doc/best-practice/source/_static/.placeholder
Normal file
0
doc/best-practice/source/_static/.placeholder
Normal file
117
doc/best-practice/source/conf.py
Normal file
117
doc/best-practice/source/conf.py
Normal file
File diff suppressed because it is too large
Load Diff
2
doc/best-practice/source/docutils.conf
Normal file
2
doc/best-practice/source/docutils.conf
Normal file
@ -0,0 +1,2 @@
|
||||
[html writers]
|
||||
table-style: table, caption-top
|
||||
4
doc/best-practice/source/index.rst
Normal file
4
doc/best-practice/source/index.rst
Normal file
@ -0,0 +1,4 @@
|
||||
==================================================
|
||||
Dedicated Web Application Firewall - Best Practice
|
||||
==================================================
|
||||
|
||||
@ -1,7 +1,10 @@
|
||||
sphinx>=2.0.0,!=2.1.0 # BSD
|
||||
|
||||
otcdocstheme # Apache-2.0
|
||||
|
||||
# releasenotes
|
||||
reno>=3.1.0 # Apache-2.0
|
||||
|
||||
otc-sphinx-directives>=0.1.0
|
||||
sphinx-minify>=0.0.1 # Apache-2.0
|
||||
git+https://gitea.eco.tsi-dev.otc-service.com/infra/otc-metadata.git#egg=otc_metadata
|
||||
@ -31,6 +31,17 @@ otcdocs_repo_name = 'docs/web-application-firewall-dedicated'
|
||||
otcdocs_git_fqdn = 'gitea.eco.tsi-dev.otc-service.com'
|
||||
otcdocs_git_type = 'gitea'
|
||||
|
||||
# Those variables are needed for indexing into OpenSearch
|
||||
otcdocs_doc_environment = ''
|
||||
otcdocs_doc_link = ''
|
||||
otcdocs_doc_title = ''
|
||||
otcdocs_doc_type = ''
|
||||
otcdocs_service_category = 'security-services'
|
||||
otcdocs_service_title = 'Dedicated Web Application Firewall'
|
||||
otcdocs_service_type = 'wafd'
|
||||
otcdocs_search_environment = 'hc_de'
|
||||
otcdocs_search_url = "https://opensearch.eco.tsi-dev.otc-service.com/"
|
||||
|
||||
# If extensions (or modules to document with autodoc) are in another directory,
|
||||
# add these directories to sys.path here. If the directory is relative to the
|
||||
# documentation root, use os.path.abspath to make it absolute, like shown here.
|
||||
|
||||
@ -8,6 +8,8 @@ Web Application Firewall (WAF) keeps web services stable and secure. It examines
|
||||
:class: container-sbv
|
||||
|
||||
.. service_card::
|
||||
:environment: internal
|
||||
:service_type: wafd
|
||||
:umn: This document helps you know about the Web Application Firewall (Dedicated) and guide you on how to use the service.
|
||||
:api-ref: This document describes application programming interfaces (APIs) of the Web Application Firewall (Dedicated) and provides API parameter description and example values.
|
||||
:api-ref: This document describes application programming interfaces (APIs) of the Web Application Firewall (Dedicated) and provides API parameter description and example values.
|
||||
:best-practice: To use Web Application Firewall (Dedicated) more securely, reliably, flexibly, and efficiently, you are advised to follow the following best practices.
|
||||
|
||||
@ -18,7 +18,7 @@ import os
|
||||
import sys
|
||||
|
||||
extensions = [
|
||||
'otcdocstheme'
|
||||
'otcdocstheme',
|
||||
]
|
||||
|
||||
otcdocs_auto_name = False
|
||||
@ -30,6 +30,17 @@ otcdocs_repo_name = 'docs/web-application-firewall-dedicated'
|
||||
otcdocs_git_fqdn = 'gitea.eco.tsi-dev.otc-service.com'
|
||||
otcdocs_git_type = 'gitea'
|
||||
|
||||
# Those variables are needed for indexing into OpenSearch
|
||||
otcdocs_doc_environment = 'internal'
|
||||
otcdocs_doc_link = '/web-application-firewall-dedicated/umn/'
|
||||
otcdocs_doc_title = 'User Guide'
|
||||
otcdocs_doc_type = 'umn'
|
||||
otcdocs_service_category = 'security-services'
|
||||
otcdocs_service_title = 'Dedicated Web Application Firewall'
|
||||
otcdocs_service_type = 'wafd'
|
||||
otcdocs_search_environment = 'hc_de'
|
||||
otcdocs_search_url = "https://opensearch.eco.tsi-dev.otc-service.com/"
|
||||
|
||||
# If extensions (or modules to document with autodoc) are in another directory,
|
||||
# add these directories to sys.path here. If the directory is relative to the
|
||||
# documentation root, use os.path.abspath to make it absolute, like shown here.
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user