Checkbox Survey Software Checkbox Survey Software
  • Features
    • Survey Creation
      Survey question types, logic, merging, and action options.
    • Survey Look & Feel
      Survey customization, branding, and mobile responsiveness.
    • Survey Distribution
      Email invitations, reminders, embed options, and custom links.
    • Security & Permissions
      Survey permissions, sharing options, SSO, and data security.
    • Results & Reporting
      Data export formats, charts & graphs, report filtering and API.
    • Automation & Integration
      Automatic emails & URL redirects, API, and JavaScript.
    • On-Premises Features
      Overview of on-premises version features and architecture.
    • Full Feature List
      Compare all features and limits for hosted and on-premises plans.
  • Pricing
    • Hosted Plans
      Individual, team and enterprise cloud-hosted plans.
    • On-Premises Software
      Perpetual software licenses, installed on your own servers.
    • White Label & OEM
      Learn about integrating Checkbox into your software for resale.
    • Discounts Programs
      Discounts for academic, government and non-profits.
  • About
    • Clients
      View a sampling of our global customers by industry.
    • Blog
      Company news, announcements, and industry articles.
    • Case Studies
      Learn how some of our clients use Checkbox to streamline operations.
  • Contact Us
  • Support
    • Version 7 Help Guides
      Searchable knowledge base for Checkbox Version 7.
    • Version 6 Help Guides
      Searchable knowledge base for Checkbox Version 6.
    • Api Docs
      Documentation for working with the Checkbox Version 7 API.
    • Technical Requirements
      Technical requirements for installing Checkbox on-premises.
    • Support Login
      Login form for Checkbox on-premises support users.
  • 
  • 
    • Sales
      +1 (617) 231-8891
    • Support
      +1 (617) 231-8890
  • Sign In
  • Try it Free
Homepage / Doc / Single Sign On

Single Sign On

Single sign-on is a mechanism that allows you to authenticate users in your system and then tell another application, in this case, Checkbox, that the user has been authenticated and should be granted access to the application. The user is then allowed to access Checkbox without being prompted to present a username or password to Checkbox directly.

Checkbox relies on a technology called JWT (JSON Web Token) for securing the exchange of user authentication data. This technology allows you to tell Checkbox, in a secure way, that users are authenticated.

Single sign-on with JWT is currently available on all plans except for the Basic Checkbox Online plan.

Enabling JWT

To enable JWT with Checkbox you will want to navigate to the Checkbox System Settings -> UserSettings -> Users & Security. You will want to select the option to enable JWT, generate a secure token as well as supply the system with a return URL. The return URL will be where the user is redirected if the token fails for whatever reason. This prevents them from ever seeing the Checkbox login screen.

The Process

  1. User logs into your application or web site
  2. They click a link on your site to either create & manage surveys or to submit a survey response
  3. You write code in your system that generates a secure JWT token and then redirects them to
    the Checkbox application
  4. Checkbox parses the JWT token, verifies the secure key, and then logs the user into the system
    that matches the email address in the token

Additional information about JWT

JWT is an open standard that is being driven by the international standards body IETF and is backed by top-level organizations such as Microsoft, Facebook, and Google.

One thing to be aware of is that the JWT payload is merely encoded and signed, not encrypted, so don’t put any sensitive data in the hash table. JWT works by serializing the JSON that is being transmitted to a string. It then base64 encodes that string and then makes an HMAC of the base64 string which depends on the shared secret key. This produces a signature that the recipient side can use to validate the user.

This section is currently under construction. Any documents that appear blank will be populated as soon as possible. If you have any questions or need assistance with something that is not currently documented please feel free to submit a support ticket and we will be glad to assist you.
July 27, 2017

Software Development Kit

  • Getting Started
    • Requirements
    • Project Architecture
    • Database Model
  • Single Sign On

 

Checkbox develops affordable, feature-rich survey software for organizations, teams, and individuals. Available as a cloud-hosted subscription or installable software. API, source code and integration options available.

Checkbox Survey Inc.
44 Pleasant Street, Suite 110
Watertown, MA  02472  USA
(617) 231-8890
info@checkbox.com

  • Features
  • Pricing
  • On-Premises Software
  • Blog
  • Contact Us
  • Pay a Quote/Invoice
  • Support
  • Release Notes
  • Developer Center
  • Hosted SLA
  • Software License Agreement
  • Privacy Policy
©  2002 - Checkbox Survey, Inc.
LinkedinFacebookTwitter