OAuth callback

Enterprise

This endpoint is part of Countly Enterprise. To get access, contact sales or compare versions. Existing customers can reach the support portal with questions.

Endpoint

/i/crashes-jira?method=callback

Overview

Completes OAuth flow by exchanging request token and verifier for an access token.

Authentication

• No dashboard authentication is validated in this callback handler.
• Route is expected to be invoked by JIRA OAuth callback.

Permissions

• No feature permission check is applied.

Request Parameters

Parameter	Type	Required	Description
method	String	Yes	Must be callback
oauth_verifier	String	Yes	OAuth verifier returned by JIRA
pretty_callback	String	No	If present, redirects to /crashes-jira/login_callback page

Examples

Example 1: OAuth callback from JIRA

/i/crashes-jira?method=callback&oauth_verifier=OAUTH_VERIFIER_VALUE

Example 2: OAuth callback with UI redirect

/i/crashes-jira?method=callback&oauth_verifier=OAUTH_VERIFIER_VALUE&pretty_callback=yes

Response

Success Response

Standard callback success:

{
  "result": "Success"
}

Pretty callback success:

{
  "result": "Redirect to /crashes-jira/login_callback"
}

Response Fields

Field	Type	Description
result	String	Callback result summary (actual response may be redirect)

Error Responses

HTTP Status	Response
302	Redirect to /i/crashes-jira/login when stored request token is older than 10 minutes
500	{ "result": "Failed to generate oauth object: ..." }
500	{ "result": "Failed to find oauth token: ..." }
500	{ "result": "Failed to retrieve access token: ..." }

Behavior

1. Loads temporary OAuth token from countly.crashes_jira (_id: "meta").
2. Checks token age (10-minute timeout).
3. Exchanges verifier for access token and stores oauth.access_token.
4. Returns success response or UI redirect when pretty_callback is used.

Related Endpoints

• JIRA for Crashes - Login
• JIRA for Crashes - Check Login

Implementation details

Configuration Impact

Setting	Default	Affects	User-visible impact
crashes-jira.*	Crashes Jira integration defaults	Jira integration logic and synchronization behavior.	Changes to Jira integration settings can alter authentication, sync behavior, and returned integration state.

Database Collections

Collection	Used for	Data touched by this endpoint
countly.crashes_jira	Endpoint data source	Stores endpoint-related records this endpoint reads or modifies.