diff --git a/assets/images/kane-ai/features/custom_headers/add_custom_headers.jpeg b/assets/images/kane-ai/features/custom_headers/add_custom_headers.jpeg new file mode 100644 index 000000000..7da736ea1 Binary files /dev/null and b/assets/images/kane-ai/features/custom_headers/add_custom_headers.jpeg differ diff --git a/assets/images/kane-ai/features/custom_headers/create_web_test_custom_headers.jpeg b/assets/images/kane-ai/features/custom_headers/create_web_test_custom_headers.jpeg new file mode 100644 index 000000000..591ce409e Binary files /dev/null and b/assets/images/kane-ai/features/custom_headers/create_web_test_custom_headers.jpeg differ diff --git a/assets/images/kane-ai/features/custom_headers/custom_headers_appliend.jpeg b/assets/images/kane-ai/features/custom_headers/custom_headers_appliend.jpeg new file mode 100644 index 000000000..f9d375b83 Binary files /dev/null and b/assets/images/kane-ai/features/custom_headers/custom_headers_appliend.jpeg differ diff --git a/assets/images/kane-ai/features/custom_headers/custom_headers_modal.jpeg b/assets/images/kane-ai/features/custom_headers/custom_headers_modal.jpeg new file mode 100644 index 000000000..4d16e3ead Binary files /dev/null and b/assets/images/kane-ai/features/custom_headers/custom_headers_modal.jpeg differ diff --git a/assets/images/kane-ai/features/custom_headers/custom_headers_testcase_modal.jpeg b/assets/images/kane-ai/features/custom_headers/custom_headers_testcase_modal.jpeg new file mode 100644 index 000000000..539e55f65 Binary files /dev/null and b/assets/images/kane-ai/features/custom_headers/custom_headers_testcase_modal.jpeg differ diff --git a/assets/images/kane-ai/features/custom_headers/view_custom_headers_in_testcase.jpeg b/assets/images/kane-ai/features/custom_headers/view_custom_headers_in_testcase.jpeg new file mode 100644 index 000000000..21ad6b562 Binary files /dev/null and b/assets/images/kane-ai/features/custom_headers/view_custom_headers_in_testcase.jpeg differ diff --git a/assets/images/kane-ai/features/custom_headers/view_custom_headers_while_authoring.jpeg b/assets/images/kane-ai/features/custom_headers/view_custom_headers_while_authoring.jpeg new file mode 100644 index 000000000..66ec13107 Binary files /dev/null and b/assets/images/kane-ai/features/custom_headers/view_custom_headers_while_authoring.jpeg differ diff --git a/docs/kaneai-custom-headers.md b/docs/kaneai-custom-headers.md new file mode 100644 index 000000000..7bae158d5 --- /dev/null +++ b/docs/kaneai-custom-headers.md @@ -0,0 +1,99 @@ +--- +id: kaneai-custom-headers +title: Custom Headers in KaneAI +hide_title: true +sidebar_label: Custom Headers +description: Guide for usage of Database custom headers in KaneAI +keywords: + - Custom Headers + - Headers +url: https://www.lambdatest.com/support/docs/kaneai-custom-headers/ +site_name: LambdaTest +slug: kaneai-custom-headers/ +--- + + + +# Custom Headers in KaneAI Web Test Authoring + +Custom hеadеrs providе you thе ability to kееp crucial information about thе rеquеst or rеsponsе, such as thе mеthod, URL, and body contеnt. You can modify thе paramеtеrs of thе HTTP rеquеsts dеlivеrеd in your tеsts by manipulating thеsе hеadеrs. + +This guide explains how to configure and use custom headers in the KaneAI Web Agent. + +## Steps to Use Custom Headers in KaneAI Web Agent + +Follow the steps below to add and manage custom headers for your Web tests: + +### Step 1: Configure & Add Custom Headers for a Section +Start by creating a Web session by going on the [KaneAI page](https://kaneai.lambdatest.com/objective) and clicking on the **Create a Web Test** button. You will find the **Custom Headers** section there. + +objective-page + +Enable the **Custom Headers** toggle to add custom HTTP headers for the test session. + +You can add new header rows by clicking the **+** button. Each row will have two fields: **Header Name** and **Header Value**. + + +:::note +You can add up to 10 custom headers. +::: + +objective-page + +#### Example Use-case: +**User Identification and Session Management**: Used to send tokens, session IDs to authenticate and identify users. This helps in managing user sessions, implement stateless authentication mechanisms, track user behavior. + +Example: The Custom header `X-Session-ID`is used to track user sessions. + +```java +X-Session-ID: 1234567890 +``` + +:::note + If you provide a Default Header in the Custom Header section your Default header will get overridden. +::: + +### Step 2: Authoring with Custom Headers +After configuring the custom headers, initiate the Web Authoring session. The headers you added will be applied during the test session, allowing you to test under the configured conditions. + +Custom Headers will be applied to all the API call you make in the session like 'Go to https://lambdatest.com' or doing API testing like shown below: + +objective-page + +To see the list of Custom Headers applied in the Authoring session click on the `Custom Headers` option present on the top left side in the navbar. + +objective-page + +You will see the list of applied Custom Headers. + +objective-page + +### Step 3: View the Custom Headers in the Summary Page +Once the session completes, the custom headers used during the session will be displayed on the summary page, similar to how Chrome options are shown. + +You can click on `view details` to see the value of Custom Headers. + +objective-page +objective-page \ No newline at end of file diff --git a/sidebars.js b/sidebars.js index 3816b2c85..41546ec82 100644 --- a/sidebars.js +++ b/sidebars.js @@ -1206,6 +1206,7 @@ module.exports = { "kane-ai-assertions", "kaneai-dynamic-url-replacement", "kaneai-chrome-options", + "kaneai-custom-headers", "kaneai-totp", "kaneai-scheduled-test-runs", "kaneai-database",