Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

On this page:

Table of Contents
stylenone

When do users need to log in

Some content on a Refined site is only visible for users who are logged in:

On public sites, users can use the login button in the navigation menu to log in themselves, or they are prompted to log in when they try to access a restricted page.

...

Upon logging in on a Refined site, users are directed to Atlassian. Here they log in with their Atlassian account through either Confluence or Jira: see the table below. Once they’ve logged in, they’re directed back to the Refined site.

...

Your app(s)

...

Users log in to all of your sites through

...

Refined Sites for Confluence

...

Confluence

...

Refined Sites for Jira Service Management

...

Jira

...

Both Refined Sites for Confluence and Refined Sites for Jira Service Management

...

Users stay logged in for seven days, unless they log out themselves.

Info

Because Refined sites direct users to Atlassian to log in, we don’t support Single Sign On (SSO) integrations from providers such as Okta or Azure Active Directory. Authenticating against with Atlassian is necessary to get Atlassian data onto the sites.

Control over login route

...

Info

This setting is only visible to customers who use both Refined for Confluence and Refined for Jira Service Management.

Set up whether users log in to your site through either Confluence or Jira authentication. By default, the login route is set to Jira. The best route for users to log in depends on your site’s contents:

  • If your site contains content from both Atlassian products, we generally recommend choosing the product that most users have access to. For example, your organization may have guest users in Confluence, who don’t have access to Jira. Choosing the login route through Confluence makes sure these users won’t have to request Jira access to log in.

  • If your site contains only Confluence content, let users log in through Confluence. Otherwise, users who have access to Confluence but not Jira are prompted to request access to Jira.

  • In the same vein, choose Jira as the login route if your site contains only Jira or Jira Service Management content.

Choose the login route

  1. Go to the Refined Administration.

  2. Click Sites in the left-hand menu.

  3. Pick a site.

  4. Go to the Permissions tab.

  5. Scroll down to the Login route section.

  6. Select the login route.

"Log out from Atlassian" prompt

After logging out from the site, users are not automatically logged out of Atlassian. For organizations in which multiple employees use the same laptop, tablet, or other device, this may pose complications. To emphasize to users that they also need to log out of Atlassian, enable the Log out from Atlassian prompt.

The prompt differs depending on the type of user:

  • Licensed users can click a Log out from Atlassian button, which redirects them to the Atlassian log-out page.

  • JSM customer users are instructed how to log out from the JSM customer portal. Clicking the Continue button takes them to the customer portal in Atlassian. Here they have to log out by clicking their profile icon in the top-right of the screen.

...

Enable the prompt

  1. Go to the Refined Administration.

  2. Click Sites in the left-hand menu.

  3. Pick the site you want to work with.

  4. Go to the Configuration tab.

  5. Scroll down to the Security heading > turn on ”Log out from Atlassian” prompt.

Hide the login button

While the login button is part of the navigation menu header by default, you may want to hide it on some types of sites. For example on a public documentation site on which the majority of users will only read information and has no reason to log in.

To hide the login button:

  1. Go to the Refined Administration.

  2. Click Sites in the left-hand menu.

  3. Select a site.

  4. Go to the Configuration tab.

  5. Scroll down to the Navigation Menu heading Header section.

  6. Toggle Turn off Display login Login button.

Info

If you were using custom CSS to hide the login button before we released this feature, we recommend you to remove it and use the feature instead. We don’t offer support for issues that occur due to custom code.

...

  1. Hide the login button (see steps above).

  2. Create or go to the landing page that will serve as a login page.

  3. Open Edit the Page Builderlanding page.

  4. Add the login URL (subdomain).(domain.com)/login to a module: for example a Button module, Image module, or a link in a Text module.

  5. Use view permissions to make the page look different based on whether the user is logged in or not. For example, hide the section or row that contains the module with the login link for users who are already logged in.

...

"Log out from Atlassian" prompt

Users stay logged in for seven days, unless they log out themselves.

After logging out from the site, users are not automatically logged out of Atlassian. For organizations in which multiple employees use the same laptop, tablet, or other device, this may pose complications. To emphasize to users that they also need to log out of Atlassian, enable the Log out from Atlassian prompt.

The prompt differs depending on the type of user:

  • Licensed users can click a Log out from Atlassian button, which redirects them to the Atlassian log-out page.

  • JSM customer users are instructed how to log out from the JSM customer portal. Clicking the Continue button takes them to the customer portal in Atlassian. Here they have to log out by clicking their profile icon in the top-right of the screen.

...

Enable the prompt

  1. Go to the Refined Administration.

  2. Click Sites in the left-hand menu.

  3. Pick the site you want to work with.

  4. Go to the Configuration tab.

  5. Scroll down to the Security heading > toggle on Log out from Atlassian prompt.