---+++OAuth Ubiquity Tutorial

In order to execute correctly the following tutorial, you need to have OAuth Generate Keys for ODS Controllers. More information and simple scenario you can find [[VirtOAuthControllers][here]].

   1. Execute the command:
<verbatim>
ods-oauth-host <host_url>
-- for ex.:
ods-oauth-host http://demo.openlinksw.com/OAuth
</verbatim>
      * <img src="%ATTACHURLPATH%/a1.png" style="wikiautogen"/>
   1. Execute the command:
<verbatim>
ods-set-mode oauth
</verbatim>
      * <img src="%ATTACHURLPATH%/a2.png" style="wikiautogen"/>
   1. Setup OAuth key for your ODS application instance. Detail information you can find [[VirtOAuthControllers][here]].
   1. Obtain the OAuth Generated Key:
      1. Go to http://cname:port/ods/oauth_sid.vsp . For ex. http://demo.openlinksw.com/ods/oauth_sid.vsp 
         * <img src="%ATTACHURLPATH%/a3.png" style="wikiautogen"/>
      1. In the shown form:
         1. Enter user, for ex. demo
         1. Choose the application you want to obtain the oauth generated key for.
         1. Click the "Execute" button.
         * <img src="%ATTACHURLPATH%/a4.png" style="wikiautogen"/>
      1. As result will be shown a form where you need to enter the user password.
      1. Click the "Login" button.
         * <img src="%ATTACHURLPATH%/a5.png" style="wikiautogen"/>
      1. Click the "Authorize" button.
         * <img src="%ATTACHURLPATH%/a6.png" style="wikiautogen"/>
      1. Copy the obtained oauth sid value.
         * <img src="%ATTACHURLPATH%/a7.png" style="wikiautogen"/>
      1. Execute the command
<verbatim>
ods-set-sid <the obtained oauth session-key>

or 

ods-set-addressbook-oauth <the obtained oauth session-key>
</verbatim>
      1. You can also execute the command(s) depending on the application type:
<verbatim>
ods-set-briefcase-oauth <the obtained oauth session-key>
-- or
ods-set-bookmark-oauth <the obtained oauth session-key>
-- or
ods-set-feeds-oauth <the obtained oauth session-key>
-- or
ods-set-calendar-oauth <the obtained oauth session-key>
-- or
ods-set-addressbook-oauth <the obtained oauth session-key>
-- or
ods-set-poll-oauth <the obtained oauth session-key>
-- or
ods-set-weblog-oauth <the obtained oauth session-key>
-- or
ods-set-discussion-oauth <the obtained oauth session-key>
</verbatim>

---+++References


   * [[ODSIndex][OpenLink Data Spaces (ODS)]]
   * [[ODSAppPublish][Publishing Data from  ODS  Applications]]
   * [[ODSAppShare][Sharing Data using ODS Application]]
   * [[http://virtuoso.openlinksw.com/wiki/main/Main/OAuth][OpenLink's explanation of OAuth]]
   * [[http://virtuoso.openlinksw.com/wiki/main/Main/VirtuosoOAuthServer][Virtuoso OAuth server]]
   * [[VirtOAuthControllers][Using OAuth with ODS]]
   * [[VirtuosoOdsUbiquity][ODS Ubiquity Commands]]
   * [[http://virtuoso.openlinksw.com/wiki/main/Main/VirtOAuth][Virtuoso OAuth Implementation]]
   * [[VirtuosoOdsControllers][ODS Controllers]]      
   * [[VirtODSOAuthQA][Testing Virtuoso OAuth with 3rd Party OAuth Clients]]
   * [[VirtOAuthTestTool][Virtuoso OAuth Test Tool for ODS Controllers]]
   * [[http://virtuoso.openlinksw.com/wiki/main/Main/VirtOAuthSPARQL][Virtuoso SPARQL OAuth Tutorial]]
   * [[VirtuosoOdsUbiquityTutorials][ODS Ubiquity Tutorials]]
   * [[VirtOAuthExamples][OAuth Applications Authentication examples]]
   * [[http://oauth.net/core/1.0/][OAuth API]]



CategoryODS CategoryOpenSource CategoryWebSite