Scroll Sites

Protect Site Access With Tokens

Easily and quickly protect access to your site with access tokens. Only users that receive a valid token from you will be able to log into your site.

Once you set up token protection for your site, all traffic to your Scroll site will be directed to a login page.

You can generate tokens for the users of your choice. The tokens will be your users' passwords that they will enter to log into your site and get access to all of your content.

You can also append any generated token as a query parameter to the URL of any of your site’s pages to provide instant access to the pages.

Set Up Token Protection

To set up protected access for a site:

  1. From the Confluence sidebar, click Apps > Scroll Sites.

  2. From the Scroll Sites sidebar on the left, click Domains & Security.

  3. In the Domains & Security screen, find the domain that is connected to your site.

    Domains and security.png


If you plan to connect your site to a custom domain, we recommend to set up that custom domain and connect it to your site before you proceed with the setup of token protection.

  1. From the domain’s card, click the arrow icon in the far right of the card next to Site access. This will expand all site access options.

  2. Select Protected: Token access.

  3. Click Manage Token. A dialog will open.

  4. From the Manage token dialog, click Add token. Another dialog will open.

  5. From the Add token dialog, optionally edit the suggested token and enter a description.

  6. Click Add. The dialog will close.

  7. From the Manage token dialog, click Close.

  8. From the Domains & Security screen, click Publish changes.

Your site’s access is now protected with a login page. Your users can use the tokens you created as a password to log into your site.

Manage Tokens

At any time after first setup, you can create more tokens, delete existing ones and edit the description of the existing tokens.

Once a token is deleted, it will no longer grant access to a site if entered on the login page.

Manage your tokens from the Manage Token dialog in the Domains & Security screen:

  1. From the Confluence sidebar, click Apps > Scroll Sites.

  2. From the Scroll Sites sidebar on the left, click Domains & Security.

  3. In the Domains & Security screen, find the domain that is connected to your site.

  4. From the domain’s card, click the arrow icon in the far right of the card next to Site access. This will expand all site access options.

  5. Click Manage Token.

The Manage Token screen will open with a list of existing tokens along with their descriptions and edit and delete options.

Create new token

To create a token, from the Manage Token screen:

  1. Click the button Add token on top of the table of tokens. The Add token dialog will open.

  2. Optional: Use the Token field to customize the value of your token. Your token must be at least five characters long and can’t contain spaces.

  3. Optional: Use the Description field to specify who uses the token, where the token is used or how it is used. You can add and edit descriptions later on. Example: "JSM portal link" or “Link sharing in support”.

  4. Click Add. The dialog will close.

  5. From the Manage token dialog, click Copy . Your token is now copied to your dashboard.

  6. Click Close.

You can manage and copy all of the tokens you’ve created from the list of tokens in the Manage Token screen.

Edit token

To edit the description of a token, from the Manage Token screen:

  1. Find your token in the token table.

  2. Click edit next to your token.

  3. In the Description field, add or change your description for the token.

To avoid accidentally invalidating a token you’ve already shared, you can only change the value of the token when it is first created. To customize the value of a token, delete your token and create a new one.

Delete token

You can delete any token you have created which will make it invalid.

Deleting a token can be especially helpful when you suspect abuse of a token or if you would like to revoke access to a group of users who are not authorized to access your site anymore.

To delete a token you have created, from the Manage Token screen:

  1. Find your token in the token table.

  2. Click delete next to your token.

  3. Click Delete Token in the confirmation dialog.

After deletion, your token will become invalid immediately. Users who attempt to use the token to login to your site will see the message ‘login failed’ and will not be granted access.

Access a Site with Tokens

Log in with tokens

After you set up a token-protected site, Scroll Sites directs all users to a login page and asks them to enter a valid token.

Once a user enters a token, Scroll Sites stores the login in a session cookie in the browser. The session cookie is deleted after 1 hour, or when the browser session ends or the browser closes. After that, the user enters the access token again to access the site.

The session cookie is the only place Scroll Sites stores the login. Scroll Sites never adds the token to the browser URL by itself. A token appears in the address bar only when someone explicitly appends it as a query parameter.

Accessing a protected site works exactly the same way when you use the in-app help parameter.

Users without a token can't access your site. They see a "login failed" message if they enter an incorrect token.

Share a token with any user or user group you want to grant site access to.

Skip the login page (instant access to the site)

You can append any of your generated tokens as a query parameter to your Scroll site URLs. When the token is part of the URL, Scroll Sites skips the login process and takes users directly to the content of the page.

To give instant access, append ?t=mytoken to the end of your site URL. Replace mytoken with a token from your token list.

A token you append for instant access stays visible in the browser address bar after the redirect. Scroll Sites has no supported way to remove it. Anyone who sees, copies, or shares that URL gains access to your site, and the token can persist in browser history and bookmarks. Use instant-access links only where this is acceptable, and share the login page URL instead when it isn't.

When you append the token to the URL, you can't direct users to a specific section or chapter on your page, only to the page as a whole.

Keep the token out of the address bar

If you don't want the token to appear in the URL, share the plain site URL and let users enter the token on the login page. Scroll Sites stores that login in a session cookie and doesn't write the token to the address bar.

If external users need to log in without handling a shared token at all, use SAML single sign-on instead of tokens. See Protect Site With SAML Single Sign-On.

Remove Token Protection

To remove token protection for a site:

  1. From the Confluence sidebar, click Apps > Scroll Sites.

  2. From the Scroll Sites sidebar on the left, click Domains & Security.

  3. In the Domains & Security screen, find the domain that is connected to your site.

  4. From the domain’s card, click the arrow icon in the far right of the card next to Site access. This will expand all site access options.

  5. Select any other access option, e.g. Public.

  6. From the Domains & Security screen, click Publish changes.

The login page is now removed from your site and your site is publicly accessible again (no token required).

Token Usage and Limits:

Access tokens aren't tied to users, and you have unlimited sessions per token. There is no token limit, so you can set up as many as you need.

Combining SAML and Token is not possible at the moment. We suggest creating two sites pointing to same Confluence source: one using SAML, one using token(s).

Last updated: