User Tools

Site Tools


gateway:start

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
gateway:start [2022/08/26 07:00] dmitrygateway:start [2022/08/26 07:30] dmitry
Line 1: Line 1:
 ====== EasyMorph Gateway ====== ====== EasyMorph Gateway ======
  
-EasyMorph Gateway is an optional, complementary cloud service for receiving incoming HTTP webhooks from external and cloud applications. The Gateway enables real-time event-driven integration between cloud applications and systems outside of the corporate security perimeter with internal systems and applications via EasyMorph Server tasks.+EasyMorph Gateway is an optional, complementary cloud service for receiving incoming HTTP webhooks from external and cloud applications and processing them with EasyMorph Server tasks. The Gateway enables real-time event-driven integration between cloud applications and systems outside of the corporate security perimeter with internal systems and applications via EasyMorph Server tasks.
  
 Webhook URLs are created and managed from [[server:start|EasyMorph Server]]. Incoming webhook messages are processed by EasyMorph Server tasks in real-time. When a message arrives, the Gateway immediately triggers a designated Server task that imports the incoming message (HTTP request) from the Gateway using the [[transformations:incomingwebhooks|Incoming webhooks]] action and processes it. Alternatively, messages on the Gateway can be retrieved on schedule from an EasyMorph Server task. Webhook URLs are created and managed from [[server:start|EasyMorph Server]]. Incoming webhook messages are processed by EasyMorph Server tasks in real-time. When a message arrives, the Gateway immediately triggers a designated Server task that imports the incoming message (HTTP request) from the Gateway using the [[transformations:incomingwebhooks|Incoming webhooks]] action and processes it. Alternatively, messages on the Gateway can be retrieved on schedule from an EasyMorph Server task.
Line 16: Line 16:
 =====End-to-end encryption===== =====End-to-end encryption=====
 All incoming messages that are stored in EasyMorph Gateway are asymmetrically encrypted using a public/private key pair. The keys are managed on EasyMorph Server. The private keys are stored on EasyMorph Server in an encrypted vault. Webhook messages arrive at EasyMorph Server encrypted and are decrypted only in the Server when processed in a task. All incoming messages that are stored in EasyMorph Gateway are asymmetrically encrypted using a public/private key pair. The keys are managed on EasyMorph Server. The private keys are stored on EasyMorph Server in an encrypted vault. Webhook messages arrive at EasyMorph Server encrypted and are decrypted only in the Server when processed in a task.
 +
 +\\
 +=====Authentication=====
 +===Webhook endpoint (URL) authentication===
 +For any HTTP request sent to the public webhook URL, the Gateway always returns "OK" (200). Custom webhook authentication protocols that require returning a particular token or signature in response are not supported.
 +
 +=====Request authentication=====
 +Requests can be protected by adding authentication using a secret passed via a request header or query parameter. In this case, any request that doesn't have the specified secret will be rejected with the response code 401 "Unauthorized".
 +
  
 \\ \\
Line 26: Line 35:
 See this article for more details: [[https://community.easymorph.com/t/how-to-use-microsoft-power-automate-with-easymorph-gateway/3035| See this article for more details: [[https://community.easymorph.com/t/how-to-use-microsoft-power-automate-with-easymorph-gateway/3035|
 How to use Microsoft Power Automate with EasyMorph Gateway]]. How to use Microsoft Power Automate with EasyMorph Gateway]].
 +
 +\\
 +=====Pricing=====
 +The Gateway is an optional service that is priced separately from EasyMorph Server. See the full pricing here: [[https://easymorph.com/buy.html#gateway-pricing|Pricing: EasyMorh Gateway]]
  
 \\ \\
Line 38: Line 51:
 | Max messages in batch | 10 | The number of messages a Server task can retrieve and process in one run. | | Max messages in batch | 10 | The number of messages a Server task can retrieve and process in one run. |
  
- 
-===Webhook URL authentication=== 
-For any HTTP request sent to the public webhook URL, the Gateway always returns "OK" (200). Custom webhook authentication protocols that require returning a particular token or signature in response are not supported. 
  
 ===HEAD requests=== ===HEAD requests===
 For any request made with the HTTP HEAD method, the Gateway always returns "OK" (200) without storing the message in the queue. For any request made with the HTTP HEAD method, the Gateway always returns "OK" (200) without storing the message in the queue.
gateway/start.txt · Last modified: 2022/10/30 18:00 by dmitry

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki