Atlassian Connect is an app framework used to build Atlassian apps. The methods for implementing security (that is, authentication and authorization) are different, depending on whether you are building an Atlassian Connect app or another type of integration. For more information, see Security overview.
Security for a Connect app has two key parts:
Connect apps use JWT for authentication and either scopes or user impersonation for authorization.
Atlassian Connect apps use JWT (JSON Web Tokens) for authentication. This is already built into the supported Atlassian Connect libraries.
When an app is installed, a security context is exchanged with the application. The security context contains, among other things, a key identifying the app and a shared secret used to create and validate JWT tokens. Your app uses the security context to validate incoming requests and to sign outgoing requests. The use of JWT tokens guarantees that:
To learn more, read Authentication for Connect apps.
Atlassian Connect apps can use two types of authorization:
The set of actions that an app is allowed to perform is determined by the intersection of two authorization schemes:
A scope lets an app request permission to perform certain actions. The request is presented to the administrator during installation, and the app only has access to the permissions the administrator grants. Scopes are defined in the app descriptor and statically specify the maximum set of actions that an app may perform: read, write, etc. This security level is enforced by Atlassian Connect and cannot be bypassed by app implementations. To learn more, read our page on scopes.
Every app is assigned its own app user in a Cloud instance. In general, server-to-server requests
are made by the app user. In some situations, the configuration of permission or issue security schemes
in Jira Cloud by an administrator can cause an app user not to have permission to make a request. In
Jira Cloud, Atlassian Connect will automatically attempt to resolve these errors each time an app is
updated. Client-side requests are made as the current user in the browser session, and are supported
via the AP.request()
method, or the app needs to make a server-to-server request
using OAuth 2.0 user impersonation (see next section).
User impersonation allows your integration to access Jira APIs on a user's behalf. This is provided via the JWT Bearer token authorization grant type for OAuth 2.0, which is also known as two-legged OAuth with impersonation (2LOi). At a high level, this method works by the app exchanging a JWT for an OAuth 2.0 access token (provided by the application). The access token can be used to make server-to-server calls, on behalf of the user, to the application's API.
To learn more, read our page on User impersonation for Connect apps.