Applications

Applications is the main way to extend Space functionality. To ease the understanding, think of Applications as of the way to register an external application in Space. This could be a server-side or a client-side (JavaScript or mobile) application that works with various Space modules: manages users, tracks Git activity, sends messages to Chats, and so on.

Applications basics

Your app must be an OAuth 2.0 client.
To get authentication credentials, you must register the app in Space.
The app must use one of the OAuth 2.0 authorization workflows to access various Space endpoints.
To communicate with Space, your app must use Space HTTP API.
To receive notifications from Space, your app can use webhooks.

Register your application in Space

On the navigation bar, click your avatar then choose Administration → Applications
Click New application

Fill out the displayed form:

Choose the client type that best describes your application. More than one flow may be implemented in a client if it needs them to access different parts of Space.

Client type	Supported authorization flows
Server-side Web App	Authorization Code Flow Refresh Token Flow Client Credentials Flow
JavaScript Web App	Implicit Flow
Mobile or Desktop App	Authorization Code Flow Refresh Token Flow Resource Owner Password Credentials Flow
Service Account	Client Credentials Flow Refresh Token Flow Resource Owner Password Credentials Flow

Give your application a unique name.
Specify at least one redirect URI (unless your client type is Service Account). Redirect URI is a URI at your client application that will handle a response from Space.

Specify what rights your client needs to access specific Space resources.

Click Edit requested rights and select them from the list.

If you don't have the rights you've selected for your client, you will need to have them authorized by a Space user that has them. Until that, these rights will have the pending status and won't be available to your application.

To authorize requested rights, one should:
- Navigate to Administration → Applications
- Choose the client from the list.
- On the side bar, click Authorizations.
- The pending requested rights will be listed here. Click Authorize to grant a right to the app.
Project rights. If your app needs to access some project, you need to choose the requested project rights and add this project to the client entity. To do that, click Add project and select the project from the list. Requested project rights need to be authorized by the project administrator.
As soon as you register your app, Space will generate credentials for it (client secret, client ID) and display them on the form.
To edit the client configuration:
- Navigate to Administration → Applications
- Choose your app from the list and click Edit.
- Choose Requested Rights from the side bar to edit the rights.
- Choose Authorizations from the side bar to add or remove projects and see which of the requested rights are still pending and which have been authorized.

Last modified: 20 February 2020