Skip to content
This repository has been archived by the owner on Jun 20, 2023. It is now read-only.

openedx-unsupported/tutor-contrib-superset

Repository files navigation

THIS REPOSITORY IS DEPRECATED

This functionality now lives in tutor-contrib-oars as we work to consolidate the Open edX analytics functionality into one place.

This repository was experimental as we worked on OARS and will be archived soon.

Apache Superset plugin for Tutor

Runs Apache Superset in the Tutor environment.

This plugin is speculative and being used to test new Open edX analytics features. It is not configured for production use at this time, use at your own risk!

See https://github.com/openedx/openedx-oars for more details.

Installation

pip install git+https://github.com/openedx/tutor-contrib-superset

Compatibility

This plugin is compatible with Tutor 15.0.0 and later.

Usage

# Enable this plugin
tutor plugins enable superset
tutor config save

# Set up SSO with Open edX
tutor [dev|local] do init --limit superset

Connect to Superset's UI on the configured port (default is :8088):

http://superset.local.overhang.io:8088

Access and Permissions

Superset is configured to use Open edX SSO for authentication, and the global Open edX user permissions and course access for authorization.

  • Users who are "superusers" in Open edX are made members of the built-in Superset Admin role, and the custom Open edX role.
  • Users who are global "staff" in Open edX are made members of the built-in Superset Alpha role, and the custom Open edX role.
  • Users who have staff access to any courses in Open edX are made members of the Superset custom Open edX role.
  • All other users, including anonymous users, are not made members of any roles, and so cannot see or change any data in Superset.

There is also an Admin user with a randomly-generated username and password which can access the Superset API, but cannot login to the GUI.

Open edX role

The custom Open edX role controls access to course data using Row Level Security Filters managed by the OARS plugin.

Admin and Alpha users can see data from any course, but Open edX users can only see data from courses they have staff access to.

License

This software is licensed under the terms of the AGPLv3.

About

Tutor plugin to install Apache Superset, integrated with Open edX

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published