LiveOak AngularJS TodoMVC Example

===================================

This example is based on the example http://todomvc.com/architecture-examples/angularjs/#/ . Our example is integrated with Keycloak and it's showing security possibilities of LiveOak (among other things).

Installing the application

There are two ways that this example may be installed.

Admin Console:

1. Click "Install Example Application" button, or "Try example applications" link from "Applications" page if you already have applications installed.
2. Click the "TodoMVC" example and then click "Install".

Manually:

Assumption is that:

• $LIVEOAK points to the directory with your LiveOak server
• $LIVEOAK_EXAMPLES points to the directory with LiveOak examples

So then copy the example into the apps directory of your LiveOak server and start the server

$ cp -r $LIVEOAK_EXAMPLES/todomvc $LIVEOAK/apps
$ sh $LIVEOAK/bin/standalone.sh -b 0.0.0.0

Setup the application

An Application Client was created upon installation of the application. Note that the redirect and web origin urls are set to 'http://localhost:8080'. If LiveOak is installed at something other than 'http://localhost:8080', then it will need to be edited within the Admin Console.

When installed on OpenShift, be sure to change 'http' to 'https' for the urls mentioned above.

• Create some default users for testing purposes (their names and default passwords are not important, feel free to use different names). This step is not mandatory as you can automatically register users later on the login screen of the application. But it's useful as self-registered users always have just default roles (in our case role "user"), so you can't test all the authorization possibilities when all users have just same role "user".

  • Go to http://localhost:8080/admin#/applications/todomvc/security/users
  • New User
    • username: "bob"
    • password: set an initial password
    • roles: select both "admin" and "user". This means that bob will be both "admin" and "user".
  • Repeat the steps and create another user "john", but assign him just to role "user"
  • Repeat the steps again and create last user "mary" and don't assign her to any role

• Create new collection in MongoDB (Manual step currently required)

  • Go to http://localhost:8080/admin#/applications/todomvc/storage/storage/browse or navigate to the "Storage" page of the application and then select the "storage" resource.
  • Click "New collection" > Fill collection name "todos" (name is important as it's used by the application) > Click "Add"
  • This step is not mandatory because in case that you first login as some admin user (in our case user "bob"), collection will be automatically created during first access to application. But in case that you're using just self-registered users, it will be needed.

Running the application

• Open your browser at http://localhost:8080/todomvc
• User 'bob' with password 'password' is admin and can do anything. He can create new todos, but he also automatically see todos of all users and he can update or delete them
• User 'mary' with password 'password' doesn't have any roles and she can't do anything. She can't create new todos and also she can't see any todos. Basically mary can't do anything. You will receive authorization error directly after login as mary.
• User 'john' with password 'password' is normal user. He can create new todos and he can view his own todos and update or delete them, but he can't read, update or delete todos that weren't created by himself.