Jira Cloud: Refresh an OAuth2 Access Token
See more Jira Examples
Refresh a previously authorized Atlassian OAuth2 token without opening a browser. Run initial authorization first. Atlassian rotates refresh tokens: save the newly returned refresh token together with the access token before another refresh. Serialize refreshes for the same grant so concurrent processes do not overwrite each other's tokens.
The example writes a recovery file before updating the existing token cache. Keep both files in a private working directory. If writing the main cache fails, recover from jira-token.new.json. A production token store should provide an atomic replacement or transaction. An HTTP refresh failure leaves the old cache untouched. If authorization is revoked or the refresh token expires, obtain user consent again; do not repeatedly retry an invalid grant. The confidential client secret belongs in private application configuration or a backend, not a publicly distributed executable.
Targets Jira Cloud. Jira Data Center has a separate REST API and may require different paths, authentication, or payloads.
Atlassian REST API documentation
Chilkat CkJava Downloads
import com.chilkatsoft.*;
public class ChilkatExample {
static {
try {
System.loadLibrary("chilkat");
} catch (UnsatisfiedLinkError e) {
System.err.println("Native code library failed to load.\n" + e);
System.exit(1);
}
}
public static void main(String argv[])
{
boolean success = false;
// Assumes Chilkat is unlocked. See Global Unlock Sample.
CkJsonObject token = new CkJsonObject();
success = token.LoadFile("jira-token.json");
if (success != true) {
System.out.println("Could not read the private token file.");
return;
}
if ((token.JsonTypeOf("refresh_token") != 1) || (token.StringOfEquals("refresh_token","",true) == true)) {
System.out.println("Missing value: refresh_token");
return;
}
CkJsonObject request = new CkJsonObject();
request.UpdateString("grant_type","refresh_token");
request.UpdateString("client_id","YOUR_CLIENT_ID");
request.UpdateString("client_secret","YOUR_CLIENT_SECRET");
request.UpdateString("refresh_token",token.stringOf("refresh_token"));
CkHttp http = new CkHttp();
http.put_RequireSslCertVerify(true);
CkHttpResponse resp = new CkHttpResponse();
CkJsonObject reply = new CkJsonObject();
success = http.HttpJson("POST","https://auth.atlassian.com/oauth/token",request,"application/json",resp);
if (resp.get_StatusCode() == 0) {
System.out.println("No HTTP response was received. Check connectivity and TLS settings.");
return;
}
if ((success != true) || (resp.get_StatusCode() < 200) || (resp.get_StatusCode() >= 300)) {
System.out.println("Request failed. HTTP " + resp.get_StatusCode());
if (resp.get_StatusCode() == 429) {
System.out.println("Rate limited. Retry-After: " + resp.getHeaderField("Retry-After"));
}
return;
}
success = reply.Load(resp.bodyStr());
if (success != true) {
System.out.println("Expected a JSON object in the response.");
return;
}
if ((reply.JsonTypeOf("access_token") != 1) || (reply.StringOfEquals("access_token","",true) == true)) {
System.out.println("Missing value: access_token");
return;
}
if ((reply.JsonTypeOf("refresh_token") != 1) || (reply.StringOfEquals("refresh_token","",true) == true)) {
System.out.println("Missing value: refresh_token");
return;
}
success = reply.WriteFile("jira-token.new.json");
if (success != true) {
System.out.println("Could not save the rotated token; do not discard the response from memory.");
return;
}
success = reply.WriteFile("jira-token.json");
if (success != true) {
System.out.println("Could not update the token cache. Recover from jira-token.new.json; it contains the rotated token.");
return;
}
CkFileAccess files = new CkFileAccess();
success = files.FileDelete("jira-token.new.json");
if (success != true) {
System.out.println("Token cache updated, but the recovery copy could not be removed from the private directory.");
return;
}
System.out.println("Access and refresh tokens updated. Expires in seconds: " + reply.IntOf("expires_in"));
}
}