You can use EDI studio to exchange EDI messages using the AS2 protocol. To do so, you must set up the AS2 web app.
The AS2 web app setup consists of these elements:
Name | Responsible | Description | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Register application with Azure Active Directory |
Administrator |
Register an application in Azure to manage the authentication and permissions for the AS2 web app. For more information, refer to Register an application with the Microsoft identity platform. Add a client secret to the registered application. For more information, refer to Add a client secret. Later in the AS2 setup, you need these values of the registered app:
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Set up Azure Storage account with file share |
Administrator |
If you run the AS2 web app in the AS2 inbound process, it stores the data in EDI message files in the general storage location. Usually, the general storage location is defined by an Azure Storage account. You can create an Azure Storage account or, if you already have an Azure Storage account, use that one. For more information, refer to Create an Azure storage account. In the storage account, create the file share where the EDI message files must be stored by the AS2 web app. For more information, refer to Create a file share. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Set up AS2 Key Vault |
Administrator |
When you use the AS2 web app, you need a key vault to set up the secrets and certificates that are required to run the AS2 web app. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Set up app configuration |
Administrator |
Set up an app configuration. Create the App Configuration and in the App Configuration set the required key values. Copy the connection string of the App Configuration from the Access keys page and save it somewhere. Usually, you use the connection string of the primary key. You need the connection string to connect the App Service to the App Configuration, in the configuration of the App Service. For more information, refer to About Azure App Configuration. Key valuesTo add the key values to the App Configuration, download the Default AS2 App Configuration and extract it. The default AS2 web app name prefix for the keys is 'AS2WEBAPP'. If you want to use another prefix, you can change it. To do so, before you import the key values, edit the 'DefaultAS2AppConfiguration.json' file in a text editor. Note:
When you have finished editing the JSON file, import the 'DefaultAS2AppConfiguration.json' file to your App Configuration. For more information, refer to Import data from a configuration file. In the App Configuration, you can edit the values of the imported keys with the Configuration explorer. To do so:
The key configuration that is required for the AS2 web app is:
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Set up app service |
Administrator |
Create and configure an App service in the Azure portal. The app service is the AS2 web app. On creation of the app service, in the:
Fill in the other fields as desired. For more information, refer to Create a Web app. To configure the web app, add and edit the required app settings. Do not remove the automatically generated app settings. For more information, refer to Configure app settings. Add and edit these app settings:
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Complete app registration |
Administrator |
To enable browsing the app service, add a redirect URI to the earlier registered app. To add the redirect URI:
For more information, refer to Add a redirect URI. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Deploy app |
Administrator |
To get the AS2 web app running in the cloud, deploy the created app service. Ask STAEDEAN for the AS2WebApp.zip file that contains the AS2 web app files that are required for deployment. Deploy the AS2 web app files with the Zip Push Deploy tool of the Kudu services portal. |