Last modified by Erik Bakker on 2024/08/26 12:57

Show last authors
1 {{container}}{{container layoutStyle="columns"}}(((
2 When talking to external parties via a SOAP web service they will most likely require some form of authorization. Within eMagiz, you have various options to send the correct authorization towards that external system. The one that is most used when communicating with external parties is a username/password combination (i.e. basic authentication). In this microlearning, we will focus on that scenario and discuss some of the other possibilities that eMagiz offers out of the box.
3
4 Should you have any questions, please contact academy@emagiz.com.
5
6 == 1. Prerequisites ==
7 * Basic knowledge of the eMagiz platform
8
9 == 2. Key concepts ==
10 This microlearning centers around the endpoint check.
11
12 By authorization, we mean: The act of proving to the external party that you are indeed who you claim to be
13
14 * Main form used is a username/password combination (i.e. basic authentication)
15 * Other standard eMagiz options are:
16 ** Mendix authentication
17 ** Metacom authentication
18 ** Zimbra authentication
19
20 == 3. Authorization - Calling a SOAP Webservice ==
21
22 * Main form used is a username/password combination (i.e. basic authentication)
23 * Other standard eMagiz options are:
24 ** Mendix authentication
25 ** Metacom authentication
26 ** Zimbra authentication
27
28 === 3.1 Username password credentials ===
29
30 To set up the authorization we need to navigate to the Create phase of eMagiz and open the flow in which we want to add the authorization. Here we can add a support object called HTTP Components message sender.
31
32 [[image:Main.Images.Microlearning.WebHome@novice-soap-webservice-connectivity-authorization-calling-a-soap-webservice--http-components-message-sender.png]]
33
34 When you open the component you can choose Username password credentials in the drop-down and fill in properties to represent the password and username.
35
36 [[image:Main.Images.Microlearning.WebHome@novice-soap-webservice-connectivity-authorization-calling-a-soap-webservice--http-components-message-sender-filled-in.png]]
37
38 After you have done so you can link the support object to the functional component by double-clicking on the functional component, navigate to the Advanced tab and select the correct message sender.
39
40 [[image:Main.Images.Microlearning.WebHome@novice-soap-webservice-connectivity-authorization-calling-a-soap-webservice--link-message-sender.png]]
41
42 === 3.2 Alternatives ===
43
44 Some alternatives that eMagiz offers for authentication in combination with calling a SOAP web service are:
45
46 * Mendix authentication
47 * Metacom authentication
48 * Zimbra authentication
49
50 To learn the specifics of each of these options please read the help text on these components to determine whether they can help you build a successful integration.
51
52 == 4. Key takeaways ==
53
54 * Main form used is a username/password combination (i.e. basic authentication)
55 * Other standard eMagiz options are:
56 ** Mendix authentication
57 ** Metacom authentication
58 ** Zimbra authentication
59 * Make sure to link the support object to the functional component
60
61 == 5. Suggested Additional Readings ==
62
63 * [[Crash Course (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.WebHome||target="blank"]]
64 ** [[Crash Course API Gateway (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course API Gateway.WebHome||target="blank"]]
65 *** [[Setting up Exit gate (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course API Gateway.crashcourse-api-gateway-setting-up-exit-gate||target="blank"]]
66 * [[Novice (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Novice.WebHome||target="blank"]]
67 ** [[SOAP Web service Connectivity (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Novice.SOAP Web service Connectivity.WebHome||target="blank"]]
68 *** [[Configure your SOAP web service (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Novice.SOAP Web service Connectivity.novice-soap-webservice-connectivity-configure-your-soap-webservice-gen3.WebHome||target="blank"]]
69 *** [[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"]]
70 *** [[Validate Incoming Messages (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Novice.SOAP Web service Connectivity.novice-soap-webservice-connectivity-validate-incoming-messages-gen3.WebHome||target="blank"]]
71 *** [[Endpoint Check (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Novice.SOAP Web service Connectivity.novice-soap-webservice-connectivity-endpoint-check-gen3.WebHome||target="blank"]]
72 *** [[SOAP Headers (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Novice.SOAP Web service Connectivity.novice-soap-webservice-connectivity-soap-headers||target="blank"]]
73 *** [[Calling a SOAP Web service (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Novice.SOAP Web service Connectivity.novice-soap-webservice-connectivity-calling-a-soap-webservice||target="blank"]]
74 * [[Intermediate (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.WebHome||target="blank"]]
75 ** [[SOAP Web service Connectivity (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.SOAP Web service Connectivity.WebHome||target="blank"]]
76 * [[Expert (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Expert Level.WebHome||target="blank"]]
77 ** [[Webservice Security (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Expert Level.Webservice Security.WebHome||target="blank"]]
78 * [[Authentication (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=%22authentication%22||target="blank"]]
79
80
81 )))((({{toc/}}))){{/container}}{{/container}}