Connect Embed Tenant with Application Website

When your IBM® webMethods Embed tenant is ready, perform the following steps to integrate it with your application website:

Navigate to IBM webMethods Embed Admin Portal

When IBM webMethods Embed is enabled for your tenant, you can view the IBM webMethods Embed option in the App Switcher panel.

When you click on it, you are redirected to the IBM webMethods Embed Admin Portal. From here, you can configure the settings to integrate IBM webMethods Embed with your application.

Create a default plan in Admin Portal

The Plans tab allows you to define the number of transactions and connectors available under a specific plan, which you can then assign to one or more users.

To get started with configuration settings, first create a default plan. To do so, navigate to Settings > Plans and click on Add Plan.

A new window appears, through which you can create the default plan for your tenant.

Name: Provide a name for the default plan.
Plan Code: Provide a unique ID for the plan.
Plan Type: Select the User option and set the value for Default Type field to true.
Transactions: Specify the transaction limit for this plan.
Connectors: Select the connectors you want to enable for this plan.

Download the embedded application code

You can download the code for the embedded application site developed by IBM webMethods Embed. You can further modify it as per your requirements or create your custom application site from scratch.

To download the embedded application code, navigate to Settings > Developer Tools and scroll down to the bottom of the page.

Copy the link given in the Download Code for embedded application Field, paste it in a new browser tab, and press Enter key. The embedded application code gets downloaded on your machine.

Connect Admin Portal with embedded application

Extract the zipped embedded application code file and open the index.js file in the editor of your choice.

Under the basicAuthCred object, specify the basic authentication credentials for your embedded application.

Now, switch to your IBM webMethods Embed Admin portal, navigate to Settings > Developer Tools and locate the following fields:

API Key
Domain
Identifier

Now, switch back to the Admin portal and set the Runflow URL and Custom OAuth URL.

The Runflow URL is used to execute the workflows which run on webhooks. To set up the Runflow URL, enter your tenant URL in the Runflow URL field and append '/runflow' after it. For example, if your tenant URL is https://demo.int-aws-us.webmethods.io then your Runflow URL is https://demo.int-aws-us.webmethods.io/runflow .

The Custom OAuth URL is used to display your users the custom OAuth screen based on your company branding while creating the authorization. To set up the Custom OAuth URL, enter your tenant in the Custom OAuth URL field and append '/auth' after it. For example, if your tenant URL is https://acme.int-aws-us.webmethods.io, then your Custom OAuth URL is https://acme.int-aws-us.webmethods.io/auth.

Tip: It is recommended that you proxy the runflow URL and Custom OAuth URL associated with your domain to our domain for a seamless user experience.

With this, your IBM webMethods Embed tenant is integrated with your application website.