Display

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

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

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

<section class="adb-step_section">
  <h3>
    <span class="adb-step_section--number">1</span>
    Make sure your OpenID consumer reads the
    <code>{openid}</code>
    parameters
  </h3>
  <p>
    From now on, each AppDirect-powered marketplace will have its own OpenID provider instead of relying on
    <a>www.appdirect.com.</a>
    You will need to remove the hardcoded URL of AppDirect's OpenID provider in your consumer and replace it with the
    <code>{openid}</code>
    placeholder in your configuration to know which provider to query.
  </p>
  <p>Your consumer should accept:</p>
  <pre>http://www.example.com/login?openid_identifier={openid}</pre>
</section>
<section class="adb-step_section">
  <h3>
    <span class="adb-step_section--number">2</span>
    Update your event listener URLs
  </h3>
  <p>
    The events can now be triggered on any AppDirect-powered marketplace. Instead of passing the event
    <code>{token}</code>
    , we're now passing the
    <code>{eventUrl}</code>
    , 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:
  </p>
  <ul>
    <li>Verify the OAuth signature of the call to validate that it comes from an authorized AppDirect-powered marketplace</li>
    <li>
      Read the
      <code>{eventUrl}</code>
      (instead of reading the event
      <code>{token}</code>
      )
    </li>
    <li>Perform a GET to this URL signed with your OAuth credentials</li>
    <li>Process the event as appropriate</li>
    <li>Return a valid response to the event notification</li>
  </ul>
  <p>Example URL before:</p>
  <pre>http://www.example.com/foo?token={token}</pre>
  <p>Example URL after:</p>
  <pre>http://www.example.com/foo?url={eventUrl}</pre>
</section>
<section class="adb-step_section">
  <h3>
    <span class="adb-step_section--number">3</span>
    Update the OpenID URLs for your existing users
  </h3>
  <p>OpenID data for your current marketplace users must be updated in your product's database.</p>
  <h4>Update OpenID data via SQL</h4>
  <p>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.</p>
  <form class="adb-form">
    <fieldset class="adb-container">
      <div class="adb-container_header">
        <h3 class="adb-container_header--title adb-container_header--item">
          <legend>Generate SQL to update OpenID URLs for existing users</legend>
        </h3>
      </div>
      <div class="adb-container_content">
        <div class="adb-form--field">
          <label for="table_name">
            SQL Table Name
          </label>
          <input id="table_name" type="text">
        </div>
        <div class="adb-form--field">
          <label for="column_name">
            SQL Column Name
          </label>
          <input id="column_name" type="text">
        </div>
        <div class="adb-form--field">
          <label class="adb-selector adb-js-checkbox" for="interactive-endpoint">
            <span class="adb-selector--input">
              <input checked id="interactive-endpoint" type="checkbox">
            </span>
            <span class="adb-selector--value">
              Show Comments
            </span>
          </label>
        </div>
      </div>
      <div class="adb-container_footer adb-container_footer__actionable">
        <button class="adb-button__inset" type="button">
          Generate SQL
        </button>
      </div>
    </fieldset>
  </form>
  <h4>Update OpenID data via manual export</h4>
  <p>Alternatively, you can export the user account information we have collected and manually update their OpenID values:</p>
  <menu class="adb-toolbar">
    <button class="adb-toolbar--item" type="button">
      Export Development (Test) Users
    </button>
    <button class="adb-toolbar--item" type="button">
      Export Production Users
    </button>
  </menu>
</section>
<section class="adb-step_section">
  <h3>
    <span class="adb-step_section--number">4</span>
    Update Integration Report
  </h3>
  <p>
    Let us know you have completed this step of the integration by checking off the "Migrate to the distributed API" item in your
    <a href="../../prototype/developer/editor/integration_report.html">Integration Report.</a>
  </p>
  <menu class="adb-toolbar">
    <button class="adb-button__primary adb-toolbar--item" type="button">
      Update Integration Report
    </button>
    <button class="adb-toolbar--item" type="button">
      Edit Integration
    </button>
  </menu>
</section>