Quick-Start Guide for Federated Applications on the Intuit Partner Platform

Creating the Application

  • Log in to Workplace.Intuit.com
  • Choose 'Create New' to create a new application
  • Choose 'database style' for the type of application
  • Name your application.
  • If you're going to be using QuickBase functionality, choose 'Multi-table'
  • Click 'Done'
  • Choose 'Customize' > 'Application' from the menu
  • Choose 'Advanced Settings'
  • Click 'App uses Intuit Data Services'
  • Check 'Application is Hosted Externally'
  • Put the URL of your application (i.e. where you want to send the user after they've logged in) in the 'Application Destination URL' box
  • Click 'Save Changes'

Application Token Setup

  • Go back to the 'Advanced Settings' page
  • Click the 'Manage Application Tokens' link
  • Click the 'Assign Application Token' button
  • Choose 'Create a New Token'
  • Click 'Submit'

See also: https://idnforums.intuit.com/messageview.aspx?catid=69&threadid=14456&highlight_key=y&keyword1=token

SAML Gateway Setup

  • Go back to the 'Advanced Settings' page
  • Click the 'Get Federated Service Provider ID' link
  • Go generate a public/private key pair (quickest way: openssl req -x509 -nodes -days 365 -newkey rsa:1024 -keyout your.domain.com.key -out your.domain.com.crt with a CN of your.domain.com, or see the link below)
  • Paste the public key along with your SAML gateway URL into the form, and send it to Intuit, they will response via email

See also: https://ipp.developer.intuit.com/ipp/federated/Get_Set_Up/Get_a_Certificate

The Code

Tweaks

  • You probably want to pass your application the 'dbid' and 'realm' values. To do this, change your 'Application Destination URL' to append a query string like this: ”?dbid={dbid}&realm={realm}”
quickbooks_ipp_quickstart.txt · Last modified: 2013/01/21 12:44 (external edit)