Create a Koji widget that allows users to authenticate with their Atlassian Jira credentials. Then, Learn how to add this widget to your portal.

Adding a widget to your portal

Key points

To enable the Koji widget on your portal, follow these steps:

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

2. Create the widget, set its appearance and behavior in Configuration > Widgets and generate the related JavaScript code;

3. Implement the code inside your portal’s HTML code.

Creating the application

You will first need to create an application with selected authentication constraints. To do so,

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

2. Set the authentication constraints by selecting one of the following options:

• Anonymous access (no user/password required)

• JSM authentication

• Anonymous access and optional JSM authentication

3. Click Refresh.

Open

Now that the application is ready, you can create the associated widget.

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 previous step.

4. Configure your widget.

5. Click Save.

Open

Adding the code to your portal

After the widget is created, you can find the generated JavaScript code on the right side of the window. Click Copy code to clipboard to copy the code and then paste it into the HTML code of your portal.

Open

Adding a widget to a Refined Portal

Key points

To enable the Koji widget on your Refined portal:

1. Go to Configuration > Widgets to create your widget. You must select "Refined portal" in the Application field.

2. Go to Configuration > Tenants > Deploy a Refined portal widget to get the code to include in your Refined portal

3. Copy and paste the code in your Refined admin console.

Creating the widget

You first need to create the widget by going to Configuration > Widgets.

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

2. In the Application field, select Refined portal.

3. Configure your widget.

4. Click Save.

Open

After creation:

Open

Deploying the widget

To deploy the Refined portal widget:

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

2. Select the widget you created previously.

3. Click Refresh to generate the JavaScript code to add to your Refined portal.

Open

Adding the code

Copy the JavaScript code obtained in the previous step and insert it in the configuration of your Refined portal.