---++ODS-Briefcase OAuth Ubiquity Authentication Example

The following example demonstrates OAuth authentication, getting the OAuth SID value for an existing ODS-Briefcase — 
instance <b>mybriefcase</b> with owner <b><code>demo</code></b> &mdash; on the [[http://demo.openlinksw.com/ods/][OpenLink Demo server]].

---+++ Prerequisites
To successfully execute the example, you must first Generate OAuth Keys for the <b>mybriefcase</b> instance of ODS-Briefcase 
on the [[http://demo.openlinksw.com/ods/][OpenLink Demo server]]. The four step process is documented [[VirtOAuthControllers][here]].

You must also be using the [[http://www.mozilla.com/firefox/][Firefox web browser]], with the [[https://wiki.mozilla.org/Labs/Ubiquity][Ubiquity extension]] installed therein.

Last, you will need to subscribe to the ODS Ubiquity commands by accessing [[http://demo.openlinksw.com/ods/ods_ubiquity.html][http://demo.openlinksw.com/ods/ods_ubiquity.html]]. 
Ubiquity is activated for command execution with the <code>ctrl-space</code> key combination.

---+++ Procedure
   1. Execute the Ubiquity command:
<verbatim>
ods-oauth-host http://demo.openlinksw.com/OAuth 
</verbatim>
<img src="%ATTACHURLPATH%/a1.png" style="wikiautogen"/>%BR%%BR%
   1. Execute the Ubiquity command:
<verbatim>
ods-set-mode oauth
</verbatim>
<img src="%ATTACHURLPATH%/a2.png" style="wikiautogen"/>%BR%%BR%
   1. Setup OAuth key for your ODS application instance. Detail information you can find [[VirtOAuthControllers][here]].
   1. Go to <code>[[http://demo.openlinksw.com/ods/oauth_sid.vsp][http://demo.openlinksw.com/ods/oauth_sid.vsp]]</code>
%BR%%BR%<img src="%ATTACHURLPATH%/a3.png" style="wikiautogen"/>%BR%%BR%
   1. In the form, enter username <b><code>demo</code></b>, choose the application <b>mybriefcase</b> from the menu, and 
click the <b>Execute</b> button.
%BR%%BR%<img src="%ATTACHURLPATH%/dbr1.png" style="wikiautogen"/>%BR%%BR%
   1. When prompted, enter the <code>demo</code> user's password (<b><code>demo</code></b>) and click the <b>Login</b> button.
   1. Click the <b>Authorize</b> button.
%BR%%BR%<img src="%ATTACHURLPATH%/dbr2.png" style="wikiautogen"/>%BR%%BR%
   1. Copy the OAuth SID value so obtained, e.g., <code>7b040714f8b0d52c65e9eb9f6b93a240</code>, for pasting in the next step.
%BR%%BR%<img src="%ATTACHURLPATH%/dbr3.png" style="wikiautogen"/>%BR%%BR%
   1. Execute the Ubiquity command:
<verbatim>
ods-set-briefcase-oauth 7b040714f8b0d52c65e9eb9f6b93a240
</verbatim>
<img src="%ATTACHURLPATH%/dbr4.png" style="wikiautogen"/>%BR%%BR%

CategoryODS CategoryBriefcase CategoryDocumentation CategoryOdsBriefcase