<docbook><section><title>VirtuosoOdsUbiquityTutorialsBriefcaseOAuthD</title><bridgehead class="http://www.w3.org/1999/xhtml:h2">ODS-Briefcase OAuth Ubiquity Authentication Example</bridgehead>
<para>The following example demonstrates OAuth authentication, getting the OAuth SID value for an existing ODS-Briefcase — instance <emphasis>mybriefcase</emphasis> with owner <emphasis>demo</emphasis> — on the <ulink url="http://demo.openlinksw.com/ods/">OpenLink Demo server</ulink>.</para>
<bridgehead class="http://www.w3.org/1999/xhtml:h3"> Prerequisites</bridgehead>
 To successfully execute the example, you must first Generate OAuth Keys for the <emphasis>mybriefcase</emphasis> instance of ODS-Briefcase on the <ulink url="http://demo.openlinksw.com/ods/">OpenLink Demo server</ulink>.
 The four step process is documented <ulink url="VirtOAuthControllers">here</ulink>.<para>You must also be using the <ulink url="http://www.mozilla.com/firefox/">Firefox web browser</ulink>, with the <ulink url="https://wiki.mozilla.org/Labs/Ubiquity">Ubiquity extension</ulink> installed therein.</para>
<para>Last, you will need to subscribe to the ODS Ubiquity commands by accessing <ulink url="http://demo.openlinksw.com/ods/ods_ubiquity.html">http://demo.openlinksw.com/ods/ods_ubiquity.html</ulink>.
Ubiquity is activated for command execution with the ctrl-space key combination.</para>
<bridgehead class="http://www.w3.org/1999/xhtml:h3"> Procedure</bridgehead>
 <orderedlist spacing="compact"><listitem>Execute the Ubiquity command: <programlisting>ods-oauth-host http://demo.openlinksw.com/OAuth 
</programlisting><figure><graphic fileref="VirtuosoOdsUbiquityTutorialsBriefcaseOAuthD/a1.png" /></figure> </listitem>
<listitem>Execute the Ubiquity command: <programlisting>ods-set-mode oauth
</programlisting><figure><graphic fileref="VirtuosoOdsUbiquityTutorialsBriefcaseOAuthD/a2.png" /></figure> </listitem>
<listitem>Go to <ulink url="http://demo.openlinksw.com/ods/oauth_sid.vsp">http://demo.openlinksw.com/ods/oauth_sid.vsp</ulink> <figure><graphic fileref="VirtuosoOdsUbiquityTutorialsBriefcaseOAuthD/a3.png" /></figure> </listitem>
<listitem>In the form, enter username <emphasis>demo</emphasis>, choose the application <emphasis>mybriefcase</emphasis> from the menu, and click the <emphasis>Execute</emphasis> button.
<figure><graphic fileref="VirtuosoOdsUbiquityTutorialsBriefcaseOAuthD/dbr1.png" /></figure> </listitem>
<listitem>When prompted, enter the demo user&#39;s password (<emphasis>demo</emphasis>) and click the <emphasis>Login</emphasis> button.
</listitem>
<listitem>Click the <emphasis>Authorize</emphasis> button.
<figure><graphic fileref="VirtuosoOdsUbiquityTutorialsBriefcaseOAuthD/dbr2.png" /></figure> </listitem>
<listitem>Copy the OAuth SID value so obtained, e.g., 7b040714f8b0d52c65e9eb9f6b93a240, for pasting in the next step.
<figure><graphic fileref="VirtuosoOdsUbiquityTutorialsBriefcaseOAuthD/dbr3.png" /></figure> </listitem>
<listitem>Execute the Ubiquity command: <programlisting>ods-set-briefcase-oauth 7b040714f8b0d52c65e9eb9f6b93a240
</programlisting><figure><graphic fileref="VirtuosoOdsUbiquityTutorialsBriefcaseOAuthD/dbr4.png" /></figure></listitem>
</orderedlist><para><ulink url="CategoryODS">CategoryODS</ulink> <ulink url="CategoryBriefcase">CategoryBriefcase</ulink> <ulink url="CategoryDocumentation">CategoryDocumentation</ulink> <ulink url="CategoryUbiquity">CategoryUbiquity</ulink> <ulink url="CategoryOAuth">CategoryOAuth</ulink> <ulink url="CategoryOdsBriefcase">CategoryOdsBriefcase</ulink> </para>
</section></docbook>