Manage Partners and Profiles in Azure BizTalk Services
Important
Microsoft Azure BizTalk Services (MABS) is being retired, and replaced with Azure Logic Apps. If you currently use MABS, then Move from BizTalk Services to Logic Appsprovides some guidance on moving your integration solutions to Logic Apps.
If you're brand new to Logic Apps, then we suggest getting started here:
-
Create your first logic app, or quickly get started using a pre-built template
-
View all the available connectors you can use in your logic apps
The Partners page displays the list of partners with their name, email, phone, and description. Using this page, you can add or delete partners and their profiles.
It is important to understand the concept of a Service Provider and a Partner. The Service Provider is you or your company. A Partner is whomever you receive or send EDI files, which can include another company, another department within your company, and so on. Pipelines are deployed for the Hosted Partner when the agreement is deployed. Receive and Send settings are oriented to the context of the Hosted Partner. For example, the receive settings in an agreement determine how the Hosted Partner receives messages sent from a Guest Partner. Likewise, the send settings on the agreement indicate how the Hosted Partner sends messages to the Guest Partner.
In this topic:
Add a new partner
Add or Edit a profile for a partner
Add a certificate
Add a new partner
After you register yourself as the service provider, you can add or delete trading partners in the BizTalk Services Portal.
In the BizTalk Services Portal home page, click Partners.
In Partners, click Add.
In New Partner, enter the following:
Partner name
Required. Enter the name of the partner. The name must be unique.
Description
Enter a note or description for the partner.
First name
Enter the first name of the primary contact in the partner organization.
Last name
Enter the last name of the primary contact in the partner organization.
Email ID
Enter the email ID of the primary contact in the partner organization.
Phone
Enter the phone number of the primary contact in the partner organization.
Website URL
Enter the website of the partner organization.
Country
Enter the country/region of the partner organization.
Address (Line1)
Enter the address of the partner organization.
Address (Line2)
Enter any additional address information of the partner organization.
City
Enter the city of the partner organization.
State
Enter the state of the partner organization.
Postal Code
Enter the postal zip code of the partner organization.
Click Save to add the partner.
When the partners are added, profiles are created automatically.
Important
When you add you or your company as a Service Provider, you are not automatically added as a Partner. This feature allows you to add multiple partners as the Hosted Partner or Guest Partner, including creating agreements between multiple partners.
To Delete a Partner:
Select the row listing the partner that you want to delete and then select Delete.
Important
You cannot delete a partner unless all the profiles and all the agreements for that partner are deleted.
Add or Edit a profile for a partner
Profiles are organization-specific settings that can correspond to organizational divisions. For example, a partner retail organization named Contoso has an “Electronics” division that accepts orders for electronics inventory. This Electronics division submits requests for electronics supplies to a partner. Contoso also has an “Apparel” division that accepts orders for clothing and then submits requests for clothing supplies to a partner. In this scenario, two profiles for the Contoso partner organization are created: “Contoso Electronics” and “Contoso Apparel”.
A default profile is always created when a partner is added. Profiles can be changed.
On the BizTalk Services Portal home page, click Partners.
Click on the partner name to open the Profiles page for the partner.
Note
To return to the BizTalk Services Portal home page, click the back button in the upper left corner.
Click Add to create a new profile, or click the existing profile.
In the new profile page, enter the follow information:
Profile Name
Required. Enter a unique name for the profile.
Description
Optional. Enter information that describes this particular profile, like “Contoso Electronics”.
Identities
Add any identity qualifier values to be used with this profile by clicking +. Choose a qualifier code from the drop down list and enter the value.
Certificates
A certificate can be added after a profile is created and saved. Certificates in the profile can be used for digital signatures with AS2.
Click Save.
When the Partner and Profile are complete, an Agreement can be created. See Create Agreements in Azure BizTalk Services.
To Delete a Profile:
Select the partner that has the profile you want to delete. Then select the row listing the profile, and then select Delete.
Add a certificate
Once a profile is saved, you can add a certificate to that profile. Certificates in a partner’s profile are used for message signing and encryption/decryption.
In the BizTalk Services Portal home page, click Partners, click the Partner name, and then click the profile.
In the Certificates section, click Add.
Browse to the location of the certificate file. A trading partner’s public certificate (CertificateName.cer) or your own private certificate (CertificateName.pfx) can be used.
Private certificates (.pfx) are password protected. If you are adding a private certificate (.pfx), enter the Password.
Click Save.
Tip
To see the added certificates, select Resources on the BizTalk Services Portal home page, and then select Certificates. The BizTalk Services Portal also provides notifications for expired certificates.
For information on importing certificates on the computer, see APPENDIX: BizTalk Services Certificates Overview.
Next
Create Agreements in Azure BizTalk Services
See Also
Configuring EDI, AS2, and EDIFACT on BizTalk Services Portal