Last modified by Erik Bakker on 2024/09/09 12:47

Show last authors
1 {{container}}{{container layoutStyle="columns"}}(((
2 Within eMagiz, you can place headers on your message, and you can subsequently also remove these headers again. For example, when some form of authentication is placed in headers, you do not want to send this information to an external party connecting to another system. Removing headers has been a tedious process, but with some new functionality, it is easier and more evident to remove them.
3
4 Should you have any questions, please get in touch with academy@emagiz.com.
5
6 == 1. Prerequisites ==
7
8 * Basic knowledge of the eMagiz platform
9
10 == 2. Key concepts ==
11
12 * There is a specific component called "Header filter" that will remove the headers for you
13 * In this component, you can define all headers you want to filter out of your message
14
15 == 3. Removing headers from your message ==
16
17 Within eMagiz, you can place headers on your message, and you can subsequently also remove these headers again. For example, when some form of authentication is placed in headers, you do not want to send this information to an external party connecting to another system. Removing headers has been a tedious process, but with some new functionality, it is easier and more evident to remove them.
18
19 === 3.1 Legacy approach ===
20
21 In the old situation, you need to add a standard header enricher to your flow and set the header to null via a SPeL expression.
22
23 [[image:Main.Images.Migrationpath.WebHome@migration-path-removing-headers-from-your-message--old-solution-basic.png]]
24
25 [[image:Main.Images.Migrationpath.WebHome@migration-path-removing-headers-from-your-message--old-solution-advanced.png]]
26
27 === 3.2 New approach ===
28
29 In the new situation, you can more intuitively set up the removal of these headers. This can be done by using a unique and specific component that has the sole purpose of removing headers from your message. The part is called the header filter, and in it, you can define the names of all headers you want to remove. For example, a wildcard search using an asterisk (\*) is also possible. This way, you remove all custom set headers from your message. See below for an illustration.
30
31 [[image:Main.Images.Migrationpath.WebHome@migration-path-removing-headers-from-your-message--old-solution-configuration.png]]
32
33 === 3.3 How to get to the new approach ===
34
35 Migrating from the old way of removing headers from messages to the new way of eliminating them takes several steps to make it work correctly. Below you will find all these steps. Follow them carefully to achieve the desired result.
36
37 1. Identify a flow where you remove a header in the old way or don't remove the header at all where it would be wise to do so (in case of authentication, for example, or privacy-sensitive information)
38 2. Add the header filter component to the flow
39 3. Add the correct header names (or a wildcard) to the header names field
40 4. Press Save
41 5. Remove the old functionality where you set the value to null for a specific header.
42
43 Congratulations, you have successfully migrated to an excellent and easy way to remove headers from your message.
44
45 == 4. Key takeaways ==
46
47 * There is a specific component called "Header filter" that will remove the headers for you
48 * In this component, you can define all headers you want to filter out of your message
49
50 == 5. Suggested Additional Readings ==
51
52 * [[Remove Header (Search Result)>>url:https://docs.emagiz.com/bin/view/Main/Search?sort=score&sortOrder=desc&highlight=true&facet=true&r=1&f_space_facet=0%2FMain.&f_type=DOCUMENT&f_locale=en&f_locale=&f_locale=en&text=%22remove+header%22||target="blank"]]
53
54 )))((({{toc/}}))){{/container}}{{/container}}