Sample code for 30+ languages & platforms
CkPython Requires Chilkat v11.0.0+

Jira Cloud: Obtain an OAuth2 Access Token

See more Jira Examples

Authorize an integration, save the access and refresh tokens, and list the sites available to the token. Register an OAuth2 (3LO) app in the Atlassian developer console, enable the Jira API scopes, and register the exact callback http://127.0.0.1:3017/. Run this interactive example on the same computer as the browser.

This demonstrates Atlassian's documented confidential-client flow for a privately operated integration. The client secret must remain confidential; do not embed it in an application distributed to users. A distributed client should use an application backend to perform the confidential token exchange. This example does not implement a public-client PKCE flow.

The core scopes shown cover the platform examples. Jira Software and Service Management have additional endpoint-specific scopes: add the needed scopes in the developer console and the authorization request, then obtain consent again. offline_access requests a rotating refresh token. Store the token file in a private directory, never print its contents, and select the intended site explicitly rather than assuming the first returned site is correct.

Targets Jira Cloud. Jira Data Center has a separate REST API and may require different paths, authentication, or payloads.

Atlassian REST API documentation

Chilkat CkPython Downloads

CkPython
import sys
import chilkat

success = False

#  Assumes Chilkat is unlocked. See Global Unlock Sample.

oauth = chilkat.CkOAuth2()
oauth.put_AuthorizationEndpoint("https://auth.atlassian.com/authorize")
oauth.put_TokenEndpoint("https://auth.atlassian.com/oauth/token")
oauth.put_ClientId("YOUR_CLIENT_ID")
oauth.put_ClientSecret("YOUR_CLIENT_SECRET")
oauth.put_LocalHost("127.0.0.1")
oauth.put_ListenPort(3017)
#  Register exactly http://127.0.0.1:3017/ in the developer console.
#  Keep scope on the authorization request, not the authorization-code exchange.
oauth.put_UncommonOptions("NO_OAUTH2_SCOPE")
oauth.put_UseBasicAuth(False)
oauth.put_CodeChallenge(False)
oauth.put_Scope("read:jira-work write:jira-work read:jira-user offline_access")
success = oauth.AddAuthQueryParam("audience","api.atlassian.com")
if (success != True):
    print("Operation failed.")
    sys.exit()

success = oauth.AddAuthQueryParam("prompt","consent")
if (success != True):
    print("Operation failed.")
    sys.exit()

#  Chilkat generates state and validates it when the browser redirects back.
authUrl = oauth.startAuth()
if (oauth.get_LastMethodSuccess() != True):
    print("Could not start the local authorization listener.")
    sys.exit()

success = oauth.LaunchBrowser(authUrl)
if (success != True):
    oauth.Cancel()
    print("Could not open the system browser.")
    sys.exit()

waited = 0
while ((oauth.get_AuthFlowState() < 3) and (waited < 180000)) :
    oauth.SleepMs(200)
    waited = waited + 200

if (oauth.get_AuthFlowState() < 3):
    oauth.Cancel()
    print("Authorization timed out.")
    sys.exit()

if (oauth.get_AuthFlowState() != 3):
    print("Authorization did not complete. Flow state: " + str(oauth.get_AuthFlowState()))
    sys.exit()

token = chilkat.CkJsonObject()
success = token.Load(oauth.accessTokenResponse())
if (success != True):
    print("Could not parse the token response.")
    sys.exit()

if ((token.JsonTypeOf("access_token") != 1) or (token.StringOfEquals("access_token","",True) == True)):
    print("Missing value: access_token")
    sys.exit()

if ((token.JsonTypeOf("refresh_token") != 1) or (token.StringOfEquals("refresh_token","",True) == True)):
    print("Missing value: refresh_token")
    sys.exit()

#  Use a private working directory accessible only to this application/user.
success = token.WriteFile("jira-token.json")
if (success != True):
    print("Could not save the token file.")
    sys.exit()

http = chilkat.CkHttp()
http.put_RequireSslCertVerify(True)
http.put_AuthToken(token.stringOf("access_token"))
http.put_Accept("application/json")
resp = chilkat.CkHttpResponse()
success = http.HttpNoBody("GET","https://api.atlassian.com/oauth/token/accessible-resources",resp)
if (resp.get_StatusCode() == 0):
    print("No HTTP response was received. Check connectivity and TLS settings.")
    sys.exit()

if ((success != True) or (resp.get_StatusCode() < 200) or (resp.get_StatusCode() >= 300)):
    print("Request failed. HTTP " + str(resp.get_StatusCode()))
    if (resp.get_StatusCode() == 429):
        print("Rate limited. Retry-After: " + resp.getHeaderField("Retry-After"))

    sys.exit()

sites = chilkat.CkJsonArray()
success = sites.Load(resp.bodyStr())
if (success != True):
    print("Expected an array of accessible sites.")
    sys.exit()

i = 0
site = chilkat.CkJsonObject()
while (i < sites.get_Size()) :
    # site is a CkJsonObject
    site = sites.ObjectAt(i)
    if (sites.get_LastMethodSuccess() != True):
        print("Invalid site entry.")
        sys.exit()

    print(site.stringOf("name") + "  " + site.stringOf("url") + "  Cloud ID: " + site.stringOf("id"))

    i = i + 1

print("Tokens saved. Select the intended site's Cloud ID for subsequent API requests.")