YOUR TURN

YOUR TURN is the frontend for the STUPS infrastructure. It enables you to

  • register your application in Kio
  • discover APIs of other applications (TWINTIP)
  • define your resources and scopes in Essentials
  • add your application into the OAuth security system (mint)
  • search for Docker images in Pier One

At the moment YOUR TURN expects you to provide all of the STUPS infrastructure, but this will change in the future. Then you will be able to configure it so that it only needs the services of your choice (as far as service interdependencies permit, e.g. mint checking back with Kio if an application exists in the first place).

The UI consists of three modules:

  • The search
  • Applications (using Kio, TWINTIP, mint)
  • Resource Types (using essentials)

They can be accessed via the sidebar, which also hosts information about the current user (via the provided OAuth token).

../_images/yourturn-sidebar.png

Application

At first you will see applications from Kio divided into

  1. applications owned by your team and
  2. applications owned by other teams
../_images/yourturn-application-list.png

You can create a new application:

../_images/yourturn-application-form.png

The ID of the application has to be unique, ie. YOUR TURN will check in Kio if it exists already.

You can get an overview of an application’s data:

../_images/yourturn-application-detail.png

Under “OAuth Client” you define the redirect URL of your application and which scopes it can ask for:

../_images/yourturn-oauth-form.png

Under “Access Control” you configure what scopes your application “just gets” and where berry should pull the credentials from:

../_images/yourturn-access-form.png

Resource Types

At first you will see all existing resource types.

../_images/yourturn-resource-list.png

You can create a new one:

../_images/yourturn-resource-form.png

Of course the ID has to be unique again.

You can view details of a resource type:

../_images/yourturn-resource-detail.png

You can create new scopes:

../_images/yourturn-scope-form.png

If the resource has an owner, you can select a scope to be a Resource Owner Scope (it has to be requested by the resource owner). If it’s not, the scope can only be an Application Scope. Those you can assign to an application in its “Access Control” panel.

And of course you can view details of a scope, along with the applications that use it:

../_images/yourturn-scope-detail.png