Send Data – Headers – Controlling Headers


Custom Headers – and overall Header Control


To remove the X-Ident header (or any other header) from your Axios request, especially if it's being automatically added by an interceptor, you have a few options depending on how your application is structured and where the header is being added. Given the interceptor code you provided, it looks like the X-Ident header is added by the setSiteIdentifierHeader function within your request interceptor setup.

Option 1: Conditionally Apply the Header

Modify the interceptor logic to conditionally add the X-Ident header based on the URL being requested or based on specific conditions passed in the request configuration. For example, you could check if the request is going to a third-party service and skip adding the header:

const setSiteIdentifierHeader = (config) => {
  // Example condition: Check if the URL is not for a third-party service
  if (!config.url.includes('')) {
    config.headers['x-ident'] = getXIndentHeader();
  return config;

You would replace '' with the actual domain or part of the path you use to identify requests that should not include this header.

Option 2: Use a Flag in Request Configuration

Another approach is to introduce a custom flag in your request configuration that tells your interceptor whether to add the X-Ident header. This method provides more flexibility, allowing you to control the presence of the header on a per-request basis:

First, modify the setSiteIdentifierHeader function to check for a custom flag:

const setSiteIdentifierHeader = (config) => {
  // Check for a custom flag to decide whether to add the header
  if (!config.headers.skipXIdentHeader) {
    config.headers['x-ident'] = getXIndentHeader();
  return config;

Then, when making a request where you want to omit the X-Ident header, add the custom flag to your request configuration:'', data, {
  headers: {
    skipXIdentHeader: true, // Custom flag to skip adding the X-Ident header
  // Other configurations...

Remember to clean up any flags or modifications to the headers object before the request is sent, as you might not want these custom flags to actually be part of the outgoing HTTP request:

// Inside your interceptor, after processing the custom flag
delete config.headers.skipXIdentHeader; // Clean up custom flag

Option 3: Remove the Header for All Requests

If you decide the X-Ident header should never be added for any requests, you can simply remove or comment out the line in your interceptor that adds this header:

// config.headers['x-ident'] = getXIndentHeader();

This approach is straightforward but removes the flexibility of having the header added for specific requests or under certain conditions.

Choosing the Best Approach

Which option to choose depends on your specific requirements:

  • Option 1 is suitable if you can identify third-party requests based on the URL.
  • Option 2 offers the most flexibility, allowing you to control header inclusion on a per-request basis.
  • Option 3 is the simplest and most direct approach if the header is universally unnecessary.

After making these adjustments, ensure to test your application thoroughly to verify that the X-Ident header is being included or excluded as expected and that no functionality is inadvertently affected.


In axios interceptor


Your code snippet is correctly structured to conditionally manage headers based on custom flags (doNotAddUserTokenAuthorization, doNotSetSiteIdentifierHeader, doNotSendCsrfToken) and to handle token expiration with a potential token refresh. The use of axios.interceptors.request.eject(interceptor); within the logic for handling token refresh is a strategic use of the interceptor's identifier to temporarily remove it during the token refresh process, preventing the interceptor from being invoked on the refresh request itself, which is exactly the right approach to avoid recursion.

Here's a minor clarification to ensure everything is clear:

export const createRequestInterceptor = () => {
  // Creating and registering the interceptor
  const interceptor = axios.interceptors.request.use(config => {
    // Conditional logic for setting headers
    if (!config.headers.doNotAddUserTokenAuthorization) {
    if (!config.headers.doNotSetSiteIdentifierHeader) {
    if (!config.headers.doNotSendCsrfToken) {
    } else {
      delete config.headers['X-CSRF-TOKEN'];

    // Clean up custom flags
    delete config.headers.doNotAddUserTokenAuthorization;
    delete config.headers.doNotSetSiteIdentifierHeader;
    delete config.headers.doNotSendCsrfToken;

    // Prepare for asynchronous operations, such as token refresh
    let asyncReqInterceptorOperations = Promise.resolve();
    if (!hasTokenExpired() && config.url !== '/auth/refresh') {
      const refreshPromise = getTokenRefreshPromise();
      if (refreshPromise) {
        // Eject the interceptor to prevent recursion during token refresh
        asyncReqInterceptorOperations = refreshPromise;

    // After handling async operations, return config
    return asyncReqInterceptorOperations.then(() => {
      // Additional handling, e.g., CSRF token, can be performed here
      handleCSRFToken(config); // Ensure this function's logic accounts for `doNotSendCsrfToken`
      return config;

  return interceptor; // Returns the interceptor ID, useful if you need to eject it later

This setup ensures that your Axios requests are intercepted and modified according to your application's needs, including header management and token lifecycle handling. The return value of createRequestInterceptor is the interceptor ID, which is useful if you ever need to remove (eject) this interceptor from the Axios interceptor chain, as demonstrated within the token refresh logic.





About CORS and headers

Understanding the Headers

  • Authorization: Carries credentials containing the authentication information of the client for the resource being requested. This is standard for requests requiring authentication.
  • Content-Type: Specifies the media type of the resource, which is application/x-www-form-urlencoded;charset=UTF-8 in your case. This is standard and indicates you're sending form data.
  • X-Csrf-Token: Used for CSRF protection. It's not universally required for API calls but is included as a security measure in web applications to prevent CSRF attacks.
  • X-Ident: Appears to be a custom header, possibly used for additional security or identification purposes.

Why They Might Be Added

  1. Framework or Library Defaults: If you're using a web framework or library (like Axios in a React application), it might have built-in CSRF protection that automatically adds the X-Csrf-Token header. Similarly, if you have custom interceptors or middleware, these might add headers like X-Ident.
  2. Application Code: Your application code or a library you're using might explicitly add these headers for security or functional reasons.

How to Address Them

  1. Review Axios Configuration: If using Axios, check your global Axios configuration and any request-specific configurations for headers being added.
  2. Check Middleware or Interceptors: If your application uses middleware or interceptors that modify HTTP requests, review them to see if they're adding these headers.
  3. Server-Side Adjustment: Since the issue arises from CORS policy enforcement, the server ( needs to allow these headers. Specifically, they need to include X-Csrf-Token and X-Ident (if required for the API call to succeed) in the Access-Control-Allow-Headers response header of the preflight response.

Request to the Server Administrator

To enable your requests to succeed without CORS errors, you would need the server to respond to preflight requests with headers that specifically allow the ones you're sending. You could ask the server administrators to add the following headers to their preflight response:

  • Access-Control-Allow-Headers: Authorization, Content-Type, X-Csrf-Token, X-Ident
  • Optionally, if the server needs to support various content types or authentication methods, they could consider broadening the allowed headers.

This adjustment would tell the browser that the server accepts these headers from your origin, thus complying with CORS policy and allowing your request to proceed.

Yes, in essence, the security headers like X-Csrf-Token and any other custom headers you're setting in your requests can contribute to CORS policy violations when you're trying to send data to third-party servers. Here's a breakdown of why this happens and what it means:

CORS Policy Enforcement

  • Browser-Level Security: CORS (Cross-Origin Resource Sharing) is enforced by web browsers to prevent malicious websites from making requests to another domain without that domain's permission. This is a security measure to protect user data.
  • Preflight Requests: When you make a request to a third-party server (a server different from your website's origin), and that request includes certain "non-simple" headers like X-Csrf-Token, the browser automatically sends a preflight request using the OPTIONS method. This preflight asks the third-party server if it's okay to send the actual request with those headers.
  • Server Response Requirements: For the actual request to be allowed by the browser, the third-party server must explicitly state in its preflight response (Access-Control-Allow-Headers) that it accepts the headers your request is trying to include.

Impact of Security Headers

  • Blocking Requests: If the third-party server does not recognize these headers as allowed in its CORS policy, the browser will block your request due to CORS policy violations. This is likely what's happening in your case with headers like X-Csrf-Token.
  • Data Transmission to Third Parties: While these headers are crucial for securing requests within your domain (especially to protect against CSRF attacks), when making cross-origin requests to third-party APIs that do not expect or allow these headers, they can indeed block your ability to transmit data.


  1. Coordinate with Third Parties: The best approach is to coordinate with the third-party server administrators. If the headers are necessary for your application's security, ask the third-party to update their CORS policy to allow these headers.

  2. Adjust Your Requests: If the third-party server cannot or will not adjust their CORS policy:

    • Review your application to determine if these headers are necessary for the specific third-party request.
    • Remove or adjust the headers for specific third-party requests if they are not required for the operation or security of that specific transaction.
  3. Server-Side Proxy: As a workaround, consider creating a server-side proxy within your domain that forwards requests to the third-party server. This server-side component would not be subject to CORS restrictions, allowing you to include any headers necessary for internal security without affecting cross-origin requests.

In summary, while security headers are crucial for protecting your web applications, they can indeed interfere with cross-origin requests due to the CORS policy. Adjusting your approach based on the interaction with the third-party server or modifying your request strategy can help mitigate these issues.



In your Axios request, you might see a variety of headers automatically included due to browser security policies, library defaults, or explicitly set configurations in your application. Some headers, like User-Agent, Accept, and Content-Type, are standard for HTTP requests and indicate the client's capabilities or the request's content type. Others, like Authorization, provide authentication credentials, which are necessary for accessing protected resources. Headers such as X-Csrf-Token and X-Ident appear to be custom, possibly related to security measures like CSRF protection or identifying specific client-side encryption or session details.

Disabling Non-Essential Headers

If you determine that certain headers like X-Csrf-Token or X-Ident are not necessary for a specific third-party request, you can attempt to omit them. However, note that some headers are controlled by the browser and cannot be altered by JavaScript due to security restrictions, such as User-Agent, Referer, and certain Sec-Ch-* headers.

For headers that are added by your application or libraries you use:

  1. Review and Adjust Global Axios Defaults: If you've configured Axios globally to include certain headers, you can adjust or remove these configurations for specific requests.

  2. Modify or Remove Custom Headers for Specific Requests:

    • Ensure your request configuration does not include these headers.
    • If using interceptors that add headers, conditionally bypass or adjust these headers based on the request URL or other criteria.

Example: Adjusting Axios Request

Here’s how you might adjust an Axios request to exclude certain headers, assuming they are not automatically added by the browser or are not essential for the request to succeed:'', formData, {
  headers: {
    'Authorization': `Bearer ${yourAuthToken}`,
    // Explicitly set Content-Type; omit if not necessary
    'Content-Type': 'application/x-www-form-urlencoded;charset=UTF-8',
    // Omit or explicitly set other headers to undefined if trying to exclude them
    // Note: Setting headers to undefined might not always prevent them from being sent
    'X-Csrf-Token': undefined, // Attempt to omit; effectiveness may vary
    'X-Ident': undefined, // Attempt to omit; effectiveness may vary
.then(response => {
  // Handle response
.catch(error => {
  // Handle error

Considerations and Additional Steps

  • Necessary Headers: Ensure that any headers you attempt to remove are not required for the security or functionality of your application or the third-party API. For instance, the Authorization header is often critical for accessing protected resources.
  • Server Expectations: Confirm with the third-party API documentation or support what headers are expected or required. Some APIs might require specific headers for proper request processing.
  • Browser-Set Headers: Understand that certain headers, particularly security headers prefixed with Sec-, are set by the browser and cannot be controlled by JavaScript. Attempting to modify these headers may not have any effect.
  • Testing: After making adjustments, thoroughly test your application to ensure that functionality remains intact and that third-party integrations continue to work as expected.

If after adjusting your request you still face issues, consider server-side handling of the request or contacting the third-party service for advice on required headers and CORS configurations.


Control Heaaders


Yes, you can control the headers sent in an Axios request, including removing or not including headers like X-Csrf-Token if they're not necessary for the specific cross-origin request you're making. If these headers are automatically added by your application framework or a middleware, and you determine that they are not required for your request to a third-party server, you can omit them from your Axios request configuration.

Here’s how you can explicitly set or omit headers in an Axios request:

Omitting Specific Headers

If you want to make sure that a specific header is not included, you can ensure it's not set in the headers object of your Axios request configuration. For headers like X-Csrf-Token that might be automatically added by other parts of your application, you can try setting them to undefined in your request config, although success may vary based on how Axios and the browser handle undefined headers.'', data, {
  headers: {
    // Explicitly not include `X-Csrf-Token` by not mentioning it here
    // If it's added by default somewhere else, trying to set it to undefined might not always work as expected
    'Content-Type': 'application/json',
    // Other headers you need
.then(response => {
  // Handle response
.catch(error => {
  // Handle error

Global Axios Defaults

If these headers are being added globally to all Axios requests, you might have to review where in your application these global settings are configured. For example, if a CSRF token is globally added to all requests for internal API calls, you might consider making exceptions for specific external requests.

// Removing a global Axios default header for a specific request might not be straightforward,
// as setting headers to `undefined` doesn't remove them from the request
// It's better to ensure they are not added globally if not needed for external requests
axios.defaults.headers.common['X-Csrf-Token'] = undefined; // This might not work as expected for removing headers

Using Axios Instances

A more structured approach could involve using Axios instances. You can create a separate Axios instance for your third-party requests that does not include these headers:

const externalApi = axios.create({
  baseURL: '',
  // Set headers specific to this instance, omitting `X-Csrf-Token`
  headers: {
    'Content-Type': 'application/json'
    // Add any headers required by the third-party server
});'/endpoint', data)
  .then(response => {
    // Handle response
  .catch(error => {
    // Handle error

This approach allows you to maintain different configurations for internal and external requests, ensuring that security headers are only included where appropriate.


It's crucial to understand why these headers are being added to your requests and whether they are necessary for the security of your application. Removing security headers like X-Csrf-Token should be done with caution and only when you're sure they're not required for the safety of the specific external interaction. If these headers are essential for your application's security, consider alternative solutions like server-side proxies for making requests to third-party APIs.


Scroll to Top