Configure web SSO

Configuring SSO in PaperCut is easy, but you must work through the preparation steps above, or you might not be able to log in to PaperCut!

Tip:

After enabling SSO on the Admin web interface, it is not easy to use the built in admin user as the login page is no longer shown. Before configuring SSO, you must ensure your domain or corporate login has admin rights and you need to use this login. As a protection, the built-in admin user does not have the rights to enable SSO. If you lock yourself out after enabling SSO, you can bypass SSO by adding /nosso to the Application ServerAn Application Server is the primary server program responsible for providing the PaperCut user interface, storing data, and providing services to users. PaperCut uses the Application Server to manage user and account information, manage printers, calculate print costs, provide a web browser interface to administrators and end users, and much more. URL. For example: http://[myserver]/admin/nosso.

  1. Select Options > Advanced.

    The Advanced page is displayed.

  2. In the Web Single Sign-on (SSO) area, select the Enable Single sign-on check box to enable SSO. Additional configuration items are displayed.

  3. Select the SSO method:

    • Integrated Windows Authentication
    • WebAuth
  4. If you select WebAuth, complete the following fields:

    • WebAuth HTTP header key—the WebAuth HTTP header name.
    • Allowed WebAuth IP addresses—a comma separated list of whitelisted IP addresses.
  5. Specify the SSO behavior you want for the user web interface and mobile client, Admin web interface, and other interfaces:

    1. Standard (username and password)—don't use SSO and show the PaperCut NG login screen.

    2. SSO with confirmation page—use SSO and present a confirmation page at login.

    3. SSO with direct access—use SSO and directly log in the user with no confirmation page.

  6. If you want to show a Switch User link on the confirmation page, select the Show "Switch User" link on confirmation page check box.

  7. In On logout, direct user to URL, enter a URL to go to on logout. A typical example would be the URL for your intranet portal.

Advanced configuration

You can set advanced config keys to fine tune SSO behavior. For more information, see Using the Config Editor.

  1. Some installations want to enable SSO for web users, but not for users of the mobile client and mobile release apps. To disable SSO for mobile users, set the advanced config keyA config key stores information about a specific advanced setting in PaperCut. Config keys are editable by an administrator in the Config Editor.: auth.web-login.sso-enable.mobile-user to N.

  2. By default, Windows SSO does not authenticate users belonging to the "Guest" group. You can change this behavior by setting the advanced config key auth.web-login.sso-allow-guest to Y.

Post installation testing

After enabling SSO, perform the following tests to ensure that users can successfully access the PaperCut interface.

  1. Verify that you can still log in to the Admin web interface.

  2. Verify that a user without admin rights can still access their user web pages.

  3. If in use, verify that a user with the appropriate admin rights can still access other interfaces, such as Release StationPrint Release Stations place a print job on hold and allow users to release it when required. Often a Release Station is a dedicated PC terminal located next to the printers, however, Release Stations can take other forms such as a web browser based interface. Some common examples where Release Stations can be used include secure printing, approved printing, and authentication. In a secure printing environment jobs are only printed when the user arrives at the print area and confirms his or her identity. This ensures the user is there to collect the job and other users can't "accidentally" collect the document. In some organizations it may be appropriate to hold jobs until they are approved by selected individuals. A good example would be a teacher approving printing on an expensive color printer. Hold/Release queues can be used as a form of authentication in an unauthenticated environment. Users must authenticate prior to releasing their jobs allowing PaperCut NG to confirm their identity. or Web CashierWeb Cashier is a basic Point of Sale (POS) system to charge items to PaperCut accounts and deposit funds into users' accounts..

  4. Try logging in from other computers in the domain.

  5. Try logging in from different browsers supported in your organization.

  6. If using IWA, try logging in from a non-windows client or a PC outside the domain. Verify you can still log in after providing your Windows credentials.


Comments

Share your findings and experience with other PaperCut users. Feel free to add comments and suggestions about this Knowledge Base article. Please don't use this for support requests.