Create a Koji widget that allows users to authenticate with their Atlassian Jira credentials. It is possible to add such a widget to your portal — this page explains how to do it.

Key points

To enable the Koji widget on your portal:

1. Run the Configuration > Tenants > Deploy a portal widget report to set the authentication constraints;

2. Set your widget’s appearance and behavior in Configuration > Widgets and generate the widget’s JavaScript code;

3. Implement the code inside your portal HTML code.

Deploying the widget

To create and set up the widget:

1. Go to Configuration > Tenants > Deploy a portal widget.

2. Set the authentication constraints by selecting the required option from the drop-down list:

• Anonymous access (no user/password required)

• JSM authentication

• Anonymous access and optional JSM authentication

3. Click Refresh.

Thus, your application is created and ready for usage. The corresponding message is displayed on the page. Note that you must select this application when creating a widget in Configuration > Widgets.

Authentication constraints

When creating the widget in the Deploy a portal widget report, you must select the constraints. There are 3 of them:

• Anonymous access (no user/password required)

• JSM authentication

• Anonymous access and optional JSM authentication

These constraints define whether anonymous users can access the bot, and if they can log in.

Creating the widget

1. Go to Configuration > Widgets.

2. Click Add in the upper left of the window.

3. Select the application that was created in the Deploy a portal widget report.

4. Configure your widget. For more details on settings, view this /wiki/spaces/DOC/pages/3263234049.

5. Click Save. The generated code is displayed on the right side of the window.

Adding the code

Copy the JavaScript code and add it to your portal HTML code.