A sample Grails application that runs against the Alfresco Cloud. The primary purpose of this app is to demonstrate the OAuth2 flow end-to-end, using the spring-social-alfresco library.
Peter Monks (email@example.com)
Apache 2.0 - see COPYING for full details.
This is the first Grails app I've ever written, so it's probably a steaming pile from a Grails best practices perspective. This doesn't particularly concern me - my primary goal was to stand up a webapp quickly (which Grails succeeded at - yay!) - learning Grails was a secondary goal.
A sample Grails app that demonstrates the use of OAuth2 to connect to the Alfresco Cloud's Public APIs. It calls read-only APIs only (the "list networks" and "list sites" APIs, specifically), so is safe for use against your Alfresco Cloud account.
Note: it does not fully implement all of the OAuth2 flows - in particular the access token refresh flow isn't implemented yet. YMMV!
- A 1.6 (or better) JVM installed
- Groovy v2.0 (or better) installed - see http://groovy.codehaus.org/
- Grails v2.2 (or better) installed - see http://grails.org/
- A developer account setup on the Alfresco Developer Portal: https://developer.alfresco.com/
Note: there may be a Grails plugin or two required as well (I was mucking about with a few of those, and you'll see artifacts of that scattered through the source code / configuration files). I don't believe the current version of the code is actually using any of those plugins, but I may be wrong.
Registering a new app
In the Alfresco Developer Portal, register a new application with the following details:
- Application Information Tab: Application Name: alfresco-cloud-sample-grails Platform: Java Description: I <3 mullets!
- API Management Tab: Current APIs: Alfresco Public API
- Auth Tab: Callback URL: http://localhost:8080/alfresco-cloud-sample-grails/oauth/callback
In your favourite text editor, make the following edits:
- Copy ./alfresco-cloud-sample-grails-config.properties.sample to ./alfresco-cloud-sample-grails-config.properties
- In ./alfresco-cloud-sample-grails-config.properties: Set the value of the "alfresco.oauth.apikey" property to the API key of the new app in the developer portal Set the value of the "alfresco.oauth.secret" property to the secret of the new app in the developer portal
Starting the app
Change into the appropriate directory (direct or spring-social-alfresco)
bash-3.2$ grails [grails status messages removed for clarity] grails> clean [grails status messages removed for clarity] grails> run-app [grails status messages removed for clarity - note: you may receive one deprecation warning at this step] grails>
Using the app
- Navigate to http://localhost:8080/alfresco-cloud-sample-grails/oauth/ in your browser
- Click the "here" link
- In the popup window, login with your Alfresco Cloud credentials (note: not your Developer Portal credentials - this is an end user login, not a developer login)
- Click "allow"
- If the popup closes and you see a list of your Alfresco Cloud networks, the OAuth flow completed successfully
Stopping the app
grails> stop-app [grails status messages removed for clarity] grails>
grails> exit [grails status messages removed for clarity] bash-3.2$
Some code details
Despite all the stuff that Grails generated, the custom code in this app is pretty simple. There is a single controller containing all the logic:
And two views that define the main page and the callback (which is briefly shown in the popup window, after the user authorises the app):
Feel free to suggest improvements!
- Add support for the OAuth refresh flow - currently the access token will timeout after one hour, and you'll need to reset the access token and re-run the OAuth flow to continue.
- Properly support paging (currently only the first page is displayed).
- Continue linking to and displaying the site hierarchy, document library folder hierarchy, and files within the folders. Note: this will also demonstrate how to use the CMIS APIs within a client app.