Admin Functions

At present Umlaut only has one admin function, and it's kind of experimental at that: Report on Service errors.

It's been an idea to also add some simple statistics, may happen in the future.

Activating admin functions

The admin functions are not accessible by default. This is in part because of unclear issues with protecting admin functions from unauthorized users. We have a bit of protection, but it's not entirely thought through and you need to turn it on manually.

To turn on admin functions, edit your local ./config/routes.rb file, and edit the Umlaut::Routes line to enable routing to admin functions:

  Umlaut::Routes.new(self, :admin => true).draw

By default, admin functions will require https access in production environment (but not others), but not require any login. You can change https-require and add a single login/password (via http basic auth) for admin functions in your umlaut config in local ./app/controllers/umlaut_controller.rb:

umlaut_config.configure do
  #....

  admin do
    force_ssl false # no ssl even in production
    auth do
      username 'admin'
      password 'some_password'
    end
  end

  # ....
end

As an alternative to Umlaut configured admin username/password, you could protect at the apache level using any of apache's access control mechanisms, perhaps a local institutional single-sign on limited to certain accounts.

Service Error Reports

Once you've enabled admin functions (see above), a report is available of