WS-Addressing - eMagiz

{{container}}{{container layoutStyle="columns"}}(((

WS-Addressing is a standard that allows message routing data to be embedded within SOAP headers, ensuring consistent delivery and processing of messages. This section explains how to configure WS-Addressing within eMagiz, detailing the key components and settings required for successful integration with external SOAP web services.

3

4

Should you have any questions, please contact [[academy@emagiz.com>>mailto:academy@emagiz.com]].

5

6

== 1. Prerequisites ==

7

8

* Advanced knowledge of the eMagiz platform

9

10

== 2. Key concepts ==

11

12

WS-Addressing is a standardized way of including message routing data within SOAP headers.

13

For example, a WS-Addressing message may contain its dispatch metadata in a standardized SOAP header instead of relying on network-level transport to convey routing information.

14

15

To correctly configure WS-addressing on an outbound call, you need:

16

* Message destination URI

* Source endpoint

* Reply endpoint

* Fault endpoint

* Action

== 3. WS-Addressing ==

23

24

Within eMagiz, there are multiple ways of handling security concerning SOAP Webservices. One of these methods is WS-Addressing. In this microlearning, we will look at WS-Addressing from the following viewpoints:

25

26

* What is WS-Addressing

27

* Calling an external SOAP Webservice that requires WS-Addressing

28

29

=== 3.1 What is WS-Addressing ===

30

31

WS-Addressing is a standardized way of including message routing data within SOAP headers.

32

For example, a WS-Addressing message may contain its dispatch metadata in a standardized SOAP header instead of relying on network-level transport to convey routing information.

33

34

This can be achieved by sending (a set of) WS-Addressing SOAP Headers along with the SOAP body. Examples of these headers are:

35

36

Relationship to previous messages (A pair of URIs)

37

* Message destination URI

* Source endpoint

* Reply endpoint

* Fault endpoint

* Action

What an external system exactly requires in terms of WS-Addressing headers depends on the requirements made by that system.

44

45

=== 3.2 Calling an external SOAP Webservice that requires WS-Addressing ===

46

47

To ensure that eMagiz creates the required SOAP headers on top of your SOAP message, you must add one support object to the flow where you want to call the external web service (predominantly the exit).

48

This support object is:

49

50

- WS-Addressing action callback

51

52

Within this component, you can set the following headers as well as choose the version of WS-Addressing that is required:

- Action (required)

- To

- From

- Reply To

- Fault To

[[image:Main.Images.Microlearning.WebHome@expert-webservice-security-ws-addressing--ws-addressing-basic.png]]

61

62

[[image:Main.Images.Microlearning.WebHome@expert-webservice-security-ws-addressing--ws-addressing-advanced.png]]

63

64

When you are satisfied with your configuration, you can link this support object to the web service outbound gateway as follows:

65

66

[[image:Main.Images.Microlearning.WebHome@expert-webservice-security-ws-addressing--ws-addressing-callback.png]]

67

68

After doing all this, you can test the flow to verify that the WS-Addressing is correctly configured, allowing you to call the external web service.

69

70

== 4. Key takeaways ==

71

72

* WS-Addressing is a standardized way of including message routing data within SOAP headers

73

* These information elements can be added via a specific component in eMagiz

74

* Which information elements are needed is determined by the external party

75

76

== 5. Suggested Additional Readings ==

77

78

* [[Novice (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Novice.WebHome||target="blank"]]

79

** [[SOAP Web service Connectivity (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Novice.SOAP Web service Connectivity.WebHome||target="blank"]]

80

*** [[Securing your SOAP Webservice (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Novice.SOAP Web service Connectivity.novice-soap-webservice-connectivity-securing-your-soap-webservice||target="blank"]]

81

*** [[Authorization - Calling a SOAP Webservice (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Novice.SOAP Web service Connectivity.novice-soap-webservice-connectivity-authorization-calling-a-soap-webservice||target="blank"]]

82

** [[Securing Data Traffic (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Novice.Securing Data Traffic.WebHome||target="blank"]]

83

*** [[Sending certificates to a webservice (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Novice.Securing Data Traffic.novice-securing-your-data-traffic-sending-certificates-to-a-webservice.WebHome||target="blank"]]

84

* [[Intermediate (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.WebHome||target="blank"]]

85

** [[SOAP Web service Connectivity (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.SOAP Web service Connectivity.WebHome||target="blank"]]

86

*** [[Handling Webservice Timeouts (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.SOAP Web service Connectivity.intermediate-soap-webservice-connectivity-handling-webservice-timeouts.WebHome||target="blank"]]

87

* [[Expert (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Expert Level.WebHome||target="blank"]]

88

** [[Webservice Security (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Expert Level.Webservice Security.WebHome||target="blank"]]

89

*** [[WS-Security (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Expert Level.Webservice Security.expert-webservice-security-ws-security||target="blank"]]

90

* [[Webservice addressing (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=webservice+addressing||target="blank"]]

91

92

)))((({{toc/}}))){{/container}}{{/container}}

Wiki source code of WS-Addressing

Navigation