DocumentationWorkfrontWorkfront Guide

Configure Single Sign-On for Workfront Proof users

Last update: Tue Feb 28 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • User
IMPORTANT
This article refers to functionality in the standalone product Workfront Proof. For information on proofing inside Adobe Workfront, see Proofing.

If you have the Select or Premium plan, you can provide Single Sign-On (SSO) capability that allows you to use your existing organization’s username and password to access your Workfront Proof account.

This means that you will authenticate against your own log in system, not against the Workfront Proof login page.

NOTE
You must have a custom sub-domain or domain set up on your Workfront Proof account to enable SAML. Custom sub-domains are free to set up. See Branding for more information.You can read more about fully customized domains on our Brand the Workfront Proof site - advanced.

Enabling SSO Within Workfront Proof

The Single Sign-On functionality can be enabled on the Single sign-on tab of your Account settings, and it will apply to all the users on your Workfront Proof account. See Account Settings for more information.

Entity ID

As a Service Provider we have published our Entity ID here:

https://yoursubdomain.proofhq.com/saml/module.php/saml/sp/metadata.php/phq (where “yoursubdomain” is your account’s sub domain)

Workfront Proof requires the user’s email address as their unique identifier, which can be passed as one of the following attributes:

  • urn:mace:dir:attribute-def:emailAddress
  • http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
  • http://schemas.xmlsoap.org/claims/EmailAddress
  • urn:oid:0.9.2342.19200300.100.1.3
  • http://axschema.org/contact/email
  • openid.sreg.email
  • mail
  • email
  • emailAddress

To configure SSO:

  1. Open the Single Sign-On tab (1).

  2. Enter the SSO URL (2).
    This is the link to your SSO server (for example, https://sso.mycompany.com/opensso).

  3. Enter the Login URL (3).
    This is the URL that will be invoked to redirect the users to your Identity Provider.

  4. This is not an actual URL you enter in the browser, but rather an endpoint which will process the information we send it in order to present the Login screen.

Enter the Logout URL (4).
This is the URL you will be returned to after you log out, for example

https://www.yourcompany.com/services/logout.asp

  1. Enter the Certificate fingerprint (5).

  2. The SHA1 fingerprint of the SAML certificate provided by your SAML Identity Provider.

  3. Make sure to include the Key Info by setting this on your Identity Provider.

  4. Switch SSO to Enabled (6).
    Once SSO is enabled, you and other users on your account will log in using your own authentication mechanism. What this means is that when the users accesses your Workfront Proof account login screen (for example, yourcompany.proofhq.com/login), they will be prompted with the transfer window to your own authentication login page.

  5. (Optional) Enable Automatically provision users (7).
    Once this option is enabled the user accounts will be automatically created for people who do not have their own Workfront Proof profiles, but will access your Workfront Proof account using their Single Sign-On credentials. This will be actioned only when the user limit is not yet reached on your account.

  6. New provisioned users will have the Manager profile permissions assigned by default. If you need more information, see Proof Permissions Profiles in Workfront Proof.

Enable_SSO_SAML_2.0.png

Enabling SSO for Satellite Accounts

When you have satellite accounts connected to your hub account, you can administer them from the hub account level.

Single Sign-On is a Select and Premium feature so Single Sign-On can only be enabled on satellites that are on Select and Premium plans.

  1. Click Settings > Account settings (1).

  2. Click the satellite account in the drop down menu (2).

  3. Open the Single Sign-On tab (3).

  4. Start editing the SSO configuration (4).

  5. Enabling_SSO_-_Satellite_Account.png
    Here you will have two methods (5) of configuration:

  6. Inherited: SSO with the configuration taken from your hub account.
    If a user accesses Workfront Proof through the default login page (https://www.proofhq.com/login) there will be two levels of authorization: First a user is asked to log in using Workfront Proof access data (email and password); then the user is transferred through an SSO window to the SSO login page.
    Therefore, with SSO service enabled, we recommend to log in through your own Workfront Proof sub-domain/domain.

    note note
    NOTE
    At this time, when Single Sign-On is enabled on your Workfront Proof account, you will not be able to log in to the iPhone app with those credentials.

    1. Manual (default): SSO with a different configuration (for example, pointing to another Identity Provider).

      note note
      NOTE
      If the satellite account is inheriting the SSO configuration from the hub account, the login screen will be that of the hub account. When the satellite account user enters their SSO login details on this page, they will be re-directed back to the satellite account.

      Enabling_SSO_-_Satellite_Account_2.png

    2. Click Save (6).

SSO Settings Inherited from a Hub Account

When you choose to inherit the settings from your hub account you’ll notice that all the fields are now populated with the data from your hub account (7) and that Single Sign-On is automatically Enabled/Disabled(8) as on your main account. There are also no edit links in the fields anymore, as the whole SSO configuration for the Satellite Account is now set and managed from your hub account.

Satellite_Account_-_Inherited_SSO.png

In your hub account (9) the SSO Usage field shows that this configuration is in use by satellite accounts (10).
Hub_Account_-_Inherited_SSO.png

SSO Configured Manually

If Manual SSO configuration has been chosen for a satellite account (1), you need to manually enter the data for the Single Sign-On.

  1. Click Settings > Account settings (1).

  2. Open the Single sign-on tab.

  3. Click Edit, populate the field and then click Save (2).

  4. On the SSO row, click Enabled (3).

Satellite_Account_-_Manual_SSO.png

SSO Log In

  1. Click Settings > Account settings (1).

  2. Open the Single sign-on tab.

  3. Make sure that your Workfront Proof domain/sub-domain (1) is set up and that your users access your Workfront Proof account through this customized domain/sub-domain.
    SAML_Subdomain.png
    With your Single Sign-On enabled, your sub-domain login URL (e.g. yourcompany.proofhq.com/login) displays a transfer screen (2) that takes you directly to your SSO login page.
    SSO_login_page.png

  4. If a user accesses Workfront Proof through the default log in page (https://www.proofhq.com/login) there will be two levels of authorization. First a user is asked to log in using Workfront Proof access data (email and password). Then, the user is transferred through an SSO window (2) to the SSO login page.
    Therefore, with SSO service enabled, we recommend to log in through your own Workfront Proof sub-domain/domain.

  5. At this time, when Single Sign-On is enabled on your Workfront Proof account, you will not be able to log in to the iPhone app with those credentials.

About Adding a New User

When the Single Sign-On functionality is enabled on your Workfront Proof account, new users will not receive any confirmation emails as their accounts will be automatically activated and ready to use.

From your Workfront Proof log in page, after clicking the Login button, users are taken to your SSO login page and asked to enter your Single Sign-On login credentials.

IMPORTANT
Users are identified through an email address during the authentication process, which means the email account used for your SSO login must be the email address of the user registered within your account.

Active Directory Federation Services (AD FS)

The Active Directory Federation Services (AD FS) is a Microsoft software component that can be installed on Windows Server operating systems to provide users with Single Sign-On access to systems and applications located across organizational boundaries. For more information, see “Active Directory Federation Services” on the Microsoft Developer Network website.

The Workfront Proof system supports SAML 2.0 and is only compatible with AD FS version 2.0 or greater.

See Single Sign-On in Workfront Proof: AD FS configuration for detailed instructions.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43