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
Administration and choose 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 JavaScript Web App Mobile or Desktop App Service Account 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:
On the navigation bar, click
Administration and choose Applications.Choose the client from the list.
On the sidebar, 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:
On the navigation bar, click
Administration and choose Applications.Choose your app from the list and click Edit.
Choose Requested Rights from the sidebar to edit the rights.
Choose Authorizations from the sidebar to add or remove projects and see which of the requested rights are still pending and which have been authorized.