Test Environment: Changes do not affect the production environment.

Switch to Test Environment

You are about to enter the test environment. Your changes in this environment will not affect data in the live environment. You can export your data from the test environment.

  • Acme Marketplace
  • Marketplace
  • MyApps
  • Developer
  • Manage
    • Account
    • Reseller
    • Marketplace
    • Corporate
    • Superuser
    • My Profile
    • My Company
    • My Settings
    • Help Center
    • Log out
  • Developer Center
  • Dashboard
  • Products
  • Billing
  • Customers
  • Integration
  • Settings
  • Documentation
  •  Manage Products
  • Sample Application

Edit Sample Application

Sample Application
Product Dashboard
Configure App
50%
Last updated 01/01/2013
Preview
Profile & Branding
Marketplace Listing
Product Profile
3 Features
  • Feature One
  • Feature Two
  • Feature Three
Customers & Media
Support
Resources
Pricing
3 Editions
  • Free
  • Basic
  • Professional
3 Add-on Offerings
  • Add-on Offering One
  • Add-on Offering Two
  • Add-on Offering Three
Shared Features & Footnotes
Integration
Edit Integration
Ping Tests
Events
Accounts
SAML Import
25% Integration Report
Other Settings
Product Settings
Marketplaces

Migrate to the Distributed API

1 Make sure your OpenID consumer reads the {openid} parameters

From now on, each AppDirect-powered marketplace will have its own OpenID provider instead of relying on www.appdirect.com. You will need to remove the hardcoded URL of AppDirect's OpenID provider in your consumer and replace it with the {openid} placeholder in your configuration to know which provider to query.

Your consumer should accept:

http://www.example.com/login?openid_identifier={openid}

2 Update your event listener URLs

The events can now be triggered on any AppDirect-powered marketplace. Instead of passing the event {token} , we're now passing the {eventUrl} , so you'll need to update the logic in your event listener accordingly. When receiving a call on one of your event listener URLs, you'll need to:

  • Verify the OAuth signature of the call to validate that it comes from an authorized AppDirect-powered marketplace
  • Read the {eventUrl} (instead of reading the event {token} )
  • Perform a GET to this URL signed with your OAuth credentials
  • Process the event as appropriate
  • Return a valid response to the event notification

Example URL before:

http://www.example.com/foo?token={token}

Example URL after:

http://www.example.com/foo?url={eventUrl}

3 Update the OpenID URLs for your existing users

OpenID data for your current marketplace users must be updated in your product's database.

Update OpenID data via SQL

If you use a SQL-based database, the form below will generate SQL script that will update the OpenID for your existing users. Input the name of the table that stores these OpenIDs and the name of the column in which they are stored, and then execute the SQL on your database.

Generate SQL to update OpenID URLs for existing users

Update OpenID data via manual export

Alternatively, you can export the user account information we have collected and manually update their OpenID values:

4 Update Integration Report

Let us know you have completed this step of the integration by checking off the "Migrate to the distributed API" item in your Integration Report.

  • Framework
  • Edit Integration
  • Powered by AppDirect © 2009–2014
  • Help Center
  • Terms & Conditions
  • Contact
  • Call us toll-free: (877) 404-APPS
    Hide
    4
    1366 × 768
    10.51%
    9
    1024 × 768
    4.02%
    3
    1280 × 800
    11.08%
    1
    1440 × 900
    16.09%
    7
    1600 × 900
    5.59%
    6
    1280 × 1024
    5.77%
    5
    1680 × 1050
    7.48%
    2
    1920 × 1080
    15.99%
    8
    1920 × 1200
    5.39%
    10
    2560 × 1440
    3.23%