Author: rgardler
Date: Tue Jan 31 00:23:05 2012
New Revision: 1238103

URL: http://svn.apache.org/viewvc?rev=1238103&view=rev
Log:
CMS commit to wookie by rgardler

Added:
    incubator/wookie/site/trunk/content/wookie/docs/developer/features/
    
incubator/wookie/site/trunk/content/wookie/docs/developer/features/oauth.mdtext 
  (with props)

Added: 
incubator/wookie/site/trunk/content/wookie/docs/developer/features/oauth.mdtext
URL: 
http://svn.apache.org/viewvc/incubator/wookie/site/trunk/content/wookie/docs/developer/features/oauth.mdtext?rev=1238103&view=auto
==============================================================================
--- 
incubator/wookie/site/trunk/content/wookie/docs/developer/features/oauth.mdtext 
(added)
+++ 
incubator/wookie/site/trunk/content/wookie/docs/developer/features/oauth.mdtext 
Tue Jan 31 00:23:05 2012
@@ -0,0 +1,42 @@
+Title:
+Notice:    Licensed to the Apache Software Foundation (ASF) under one
+           or more contributor license agreements.  See the NOTICE file
+           distributed with this work for additional information
+           regarding copyright ownership.  The ASF licenses this file
+           to you under the Apache License, Version 2.0 (the
+           "License"); you may not use this file except in compliance
+           with the License.  You may obtain a copy of the License at
+           .
+             http://www.apache.org/licenses/LICENSE-2.0
+           .
+           Unless required by applicable law or agreed to in writing,
+           software distributed under the License is distributed on an
+           "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+           KIND, either express or implied.  See the License for the
+           specific language governing permissions and limitations
+           under the License.
+
+The OAuth feature provides an OAuth library for use in your widgets.
+
+You can see an example of it in action in the fbfriend widget which 
+connects to [Facebook][1].
+
+Steps to create a widget connecting to oauthed services: 
+
+  * Create a widget (for example with "ant seed-widget")
+  * Add the oauth feature into widget config.xml ([example][2]) 
+    with the following parameters: 
+    * clientId: your client id issued by authorization endpoint from oauthed 
service side 
+    * authzServer: url of authorization endpoint 
+    * scope: scope of token issued 
+    * e.g. 
+  * To make call to oauthed service, 
+    1. We obtain an access token by calling to oauth.authenticate() 
+    2. Then using calling oauth.proxify(service_url) in which url 
+       is the url of the oauthed service, by calling this function, 
+       access token will be automatically added to the request. 
+  * To remove token from database, make call to oauth.invalidateToken()
+
+
+  [1]: 
http://svn.apache.org/repos/asf/incubator/wookie/trunk/scratchpad/widgets/fbfriend/
+  [2]: 
http://svn.apache.org/repos/asf/incubator/wookie/trunk/scratchpad/widgets/fbfriend/config.xml
\ No newline at end of file

Propchange: 
incubator/wookie/site/trunk/content/wookie/docs/developer/features/oauth.mdtext
------------------------------------------------------------------------------
    svn:eol-style = native


Reply via email to