PureBasic
PureBasic
Trello OAuth1 Authorization
See more OAuth1 Examples
Demonstrates OAuth1 authentication for Trello.Chilkat PureBasic Downloads
IncludeFile "CkJsonObject.pb"
IncludeFile "CkOAuth2.pb"
IncludeFile "CkHttp.pb"
IncludeFile "CkFileAccess.pb"
IncludeFile "CkSocket.pb"
IncludeFile "CkHashtable.pb"
IncludeFile "CkHttpRequest.pb"
IncludeFile "CkHttpResponse.pb"
IncludeFile "CkTask.pb"
IncludeFile "CkStringBuilder.pb"
Procedure ChilkatExample()
success.i = 0
; This example requires the Chilkat API to have been previously unlocked.
; See Global Unlock Sample for sample code.
consumerKey.s = "TRELLO_CONSUMER_KEY"
consumerSecret.s = "TRELLO_CONSUMER_SECRET"
requestTokenUrl.s = "https://trello.com/1/OAuthGetRequestToken"
authorizeUrl.s = "https://trello.com/1/OAuthAuthorizeToken"
accessTokenUrl.s = "https://trello.com/1/OAuthGetAccessToken"
; The port number is picked at random. It's some unused port that won't likely conflict with anything else..
callbackUrl.s = "http://localhost:3017/"
callbackLocalPort.i = 3017
; The 1st step in 3-legged OAuth1.0a is to send a POST to the request token URL to obtain an OAuth Request Token
http.i = CkHttp::ckCreate()
If http.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
CkHttp::setCkOAuth1(http, 1)
CkHttp::setCkOAuthConsumerKey(http, consumerKey)
CkHttp::setCkOAuthConsumerSecret(http, consumerSecret)
CkHttp::setCkOAuthCallback(http, callbackUrl)
req.i = CkHttpRequest::ckCreate()
If req.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
CkHttpRequest::setCkHttpVerb(req, "POST")
CkHttpRequest::setCkContentType(req, "application/x-www-form-urlencoded")
resp.i = CkHttpResponse::ckCreate()
If resp.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
success = CkHttp::ckHttpReq(http,requestTokenUrl,req,resp)
If success = 0
Debug CkHttp::ckLastErrorText(http)
CkHttp::ckDispose(http)
CkHttpRequest::ckDispose(req)
CkHttpResponse::ckDispose(resp)
ProcedureReturn
EndIf
; If successful, the resp.BodyStr contains something like this:
; oauth_token=c173ff088a09a67389a42b1ee22366a4&oauth_token_secret=717e6015c6749fe050a923516e739dbb&oauth_callback_confirmed=true
Debug CkHttpResponse::ckBodyStr(resp)
hashTab.i = CkHashtable::ckCreate()
If hashTab.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
CkHashtable::ckAddQueryParams(hashTab,CkHttpResponse::ckBodyStr(resp))
requestToken.s = CkHashtable::ckLookupStr(hashTab,"oauth_token")
requestTokenSecret.s = CkHashtable::ckLookupStr(hashTab,"oauth_token_secret")
CkHttp::setCkOAuthTokenSecret(http, requestTokenSecret)
Debug "oauth_token = " + requestToken
Debug "oauth_token_secret = " + requestTokenSecret
; ---------------------------------------------------------------------------
; The next step is to form a URL to send to the authorizeUrl
; This is an HTTP GET that we load into a popup browser.
sbUrlForBrowser.i = CkStringBuilder::ckCreate()
If sbUrlForBrowser.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
CkStringBuilder::ckAppend(sbUrlForBrowser,authorizeUrl)
CkStringBuilder::ckAppend(sbUrlForBrowser,"?oauth_token=")
CkStringBuilder::ckAppend(sbUrlForBrowser,requestToken)
CkStringBuilder::ckAppend(sbUrlForBrowser,"&scope=read,write,account")
url.s = CkStringBuilder::ckGetAsString(sbUrlForBrowser)
Debug "url = " + url
; When the urlForBrowser is loaded into a browser, the response from Trello will redirect back to localhost:3017
; We'll need to start a socket that is listening on port 3017 for the callback from the browser.
listenSock.i = CkSocket::ckCreate()
If listenSock.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
backLog.i = 5
success = CkSocket::ckBindAndListen(listenSock,callbackLocalPort,backLog)
If success = 0
Debug CkSocket::ckLastErrorText(listenSock)
CkHttp::ckDispose(http)
CkHttpRequest::ckDispose(req)
CkHttpResponse::ckDispose(resp)
CkHashtable::ckDispose(hashTab)
CkStringBuilder::ckDispose(sbUrlForBrowser)
CkSocket::ckDispose(listenSock)
ProcedureReturn
EndIf
; Wait for the browser's connection in a background thread.
; (We'll send load the URL into the browser following this..)
; Wait a max of 60 seconds before giving up.
sock.i = CkSocket::ckCreate()
If sock.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
maxWaitMs.i = 60000
task.i = CkSocket::ckAcceptNextAsync(listenSock,maxWaitMs,sock)
CkTask::ckRun(task)
; Launch the system's default browser navigated to the URL.
oauth2.i = CkOAuth2::ckCreate()
If oauth2.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
success = CkOAuth2::ckLaunchBrowser(oauth2,url)
If success = 0
Debug CkOAuth2::ckLastErrorText(oauth2)
CkHttp::ckDispose(http)
CkHttpRequest::ckDispose(req)
CkHttpResponse::ckDispose(resp)
CkHashtable::ckDispose(hashTab)
CkStringBuilder::ckDispose(sbUrlForBrowser)
CkSocket::ckDispose(listenSock)
CkSocket::ckDispose(sock)
CkOAuth2::ckDispose(oauth2)
ProcedureReturn
EndIf
; Wait for the listenSock's task to complete.
success = CkTask::ckWait(task,maxWaitMs)
If Not success OR (CkTask::ckStatusInt(task) <> 7) OR (CkTask::ckTaskSuccess(task) <> 1)
If Not success
; The task.LastErrorText applies to the Wait method call.
Debug CkTask::ckLastErrorText(task)
Else
; The ResultErrorText applies to the underlying task method call (i.e. the AcceptNextConnection)
Debug CkTask::ckStatus(task)
Debug CkTask::ckResultErrorText(task)
EndIf
CkTask::ckDispose(task)
CkHttp::ckDispose(http)
CkHttpRequest::ckDispose(req)
CkHttpResponse::ckDispose(resp)
CkHashtable::ckDispose(hashTab)
CkStringBuilder::ckDispose(sbUrlForBrowser)
CkSocket::ckDispose(listenSock)
CkSocket::ckDispose(sock)
CkOAuth2::ckDispose(oauth2)
ProcedureReturn
EndIf
; If we get to this point, the connection from the browser arrived and was accepted.
; We no longer need the listen socket...
; Stop listening on port 3017.
CkSocket::ckClose(listenSock,10)
CkTask::ckDispose(task)
; Read the start line of the request..
startLine.s = CkSocket::ckReceiveUntilMatch(sock,Chr(13) + Chr(10))
If CkSocket::ckLastMethodSuccess(sock) = 0
Debug CkSocket::ckLastErrorText(sock)
CkHttp::ckDispose(http)
CkHttpRequest::ckDispose(req)
CkHttpResponse::ckDispose(resp)
CkHashtable::ckDispose(hashTab)
CkStringBuilder::ckDispose(sbUrlForBrowser)
CkSocket::ckDispose(listenSock)
CkSocket::ckDispose(sock)
CkOAuth2::ckDispose(oauth2)
ProcedureReturn
EndIf
; Read the request header.
requestHeader.s = CkSocket::ckReceiveUntilMatch(sock,Chr(13) + Chr(10) + Chr(13) + Chr(10))
If CkSocket::ckLastMethodSuccess(sock) = 0
Debug CkSocket::ckLastErrorText(sock)
CkHttp::ckDispose(http)
CkHttpRequest::ckDispose(req)
CkHttpResponse::ckDispose(resp)
CkHashtable::ckDispose(hashTab)
CkStringBuilder::ckDispose(sbUrlForBrowser)
CkSocket::ckDispose(listenSock)
CkSocket::ckDispose(sock)
CkOAuth2::ckDispose(oauth2)
ProcedureReturn
EndIf
; The browser SHOULD be sending us a GET request, and therefore there is no body to the request.
; Once the request header is received, we have all of it.
; We can now send our HTTP response.
sbResponseHtml.i = CkStringBuilder::ckCreate()
If sbResponseHtml.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
CkStringBuilder::ckAppend(sbResponseHtml,"<html><body><p>Chilkat thanks you!</b></body</html>")
sbResponse.i = CkStringBuilder::ckCreate()
If sbResponse.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
CkStringBuilder::ckAppend(sbResponse,"HTTP/1.1 200 OK" + Chr(13) + Chr(10))
CkStringBuilder::ckAppend(sbResponse,"Content-Length: ")
CkStringBuilder::ckAppendInt(sbResponse,CkStringBuilder::ckLength(sbResponseHtml))
CkStringBuilder::ckAppend(sbResponse,Chr(13) + Chr(10))
CkStringBuilder::ckAppend(sbResponse,"Content-Type: text/html" + Chr(13) + Chr(10))
CkStringBuilder::ckAppend(sbResponse,Chr(13) + Chr(10))
CkStringBuilder::ckAppendSb(sbResponse,sbResponseHtml)
CkSocket::ckSendString(sock,CkStringBuilder::ckGetAsString(sbResponse))
CkSocket::ckClose(sock,50)
; The information we need is in the startLine.
; For example, the startLine will look something like this:
; GET /?oauth_token=c173ff088a09a67389b42b1ee32366a4&oauth_verifier=c65bc8eed882e04bb94023bb12c0dbef HTTP/1.1
sbStartLine.i = CkStringBuilder::ckCreate()
If sbStartLine.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
CkStringBuilder::ckAppend(sbStartLine,startLine)
numReplacements.i = CkStringBuilder::ckReplace(sbStartLine,"GET /?","")
numReplacements = CkStringBuilder::ckReplace(sbStartLine," HTTP/1.1","")
CkStringBuilder::ckTrim(sbStartLine)
; oauth_token=c173ff088a09a67389b42b1ee32366a4&oauth_verifier=c65bc8eed882e04bb94023bb12c0dbef
Debug "startline: " + CkStringBuilder::ckGetAsString(sbStartLine)
CkHashtable::ckClear(hashTab)
CkHashtable::ckAddQueryParams(hashTab,CkStringBuilder::ckGetAsString(sbStartLine))
requestToken = CkHashtable::ckLookupStr(hashTab,"oauth_token")
authVerifier.s = CkHashtable::ckLookupStr(hashTab,"oauth_verifier")
; ------------------------------------------------------------------------------
; Finally , we must exchange the OAuth Request Token for an OAuth Access Token.
CkHttp::setCkOAuthToken(http, requestToken)
CkHttp::setCkOAuthVerifier(http, authVerifier) CkHttpRequest::setCkHttpVerb(req, "POST")
CkHttpRequest::setCkHttpVerb(req, "POST")
CkHttpRequest::setCkContentType(req, "application/x-www-form-urlencoded")
success = CkHttp::ckHttpReq(http,accessTokenUrl,req,resp)
If success = 0
Debug CkHttp::ckLastErrorText(http)
CkHttp::ckDispose(http)
CkHttpRequest::ckDispose(req)
CkHttpResponse::ckDispose(resp)
CkHashtable::ckDispose(hashTab)
CkStringBuilder::ckDispose(sbUrlForBrowser)
CkSocket::ckDispose(listenSock)
CkSocket::ckDispose(sock)
CkOAuth2::ckDispose(oauth2)
CkStringBuilder::ckDispose(sbResponseHtml)
CkStringBuilder::ckDispose(sbResponse)
CkStringBuilder::ckDispose(sbStartLine)
ProcedureReturn
EndIf
; Make sure a successful response was received.
If CkHttpResponse::ckStatusCode(resp) <> 200
Debug CkHttpResponse::ckStatusLine(resp)
Debug CkHttpResponse::ckHeader(resp)
Debug CkHttpResponse::ckBodyStr(resp)
CkHttp::ckDispose(http)
CkHttpRequest::ckDispose(req)
CkHttpResponse::ckDispose(resp)
CkHashtable::ckDispose(hashTab)
CkStringBuilder::ckDispose(sbUrlForBrowser)
CkSocket::ckDispose(listenSock)
CkSocket::ckDispose(sock)
CkOAuth2::ckDispose(oauth2)
CkStringBuilder::ckDispose(sbResponseHtml)
CkStringBuilder::ckDispose(sbResponse)
CkStringBuilder::ckDispose(sbStartLine)
ProcedureReturn
EndIf
; If successful, the resp.BodyStr contains something like this:
; oauth_token=4618e19f5101b7199f75aA9e678d1585576ad84fb89fa40c85c4da13589010d5&oauth_token_secret=64a997b26ea1f47105eca36ce1a5d22e
Debug "response BodyStr = " + CkHttpResponse::ckBodyStr(resp)
CkHashtable::ckClear(hashTab)
CkHashtable::ckAddQueryParams(hashTab,CkHttpResponse::ckBodyStr(resp))
accessToken.s = CkHashtable::ckLookupStr(hashTab,"oauth_token")
accessTokenSecret.s = CkHashtable::ckLookupStr(hashTab,"oauth_token_secret")
; The access token + secret is what should be saved and used for
; subsequent REST API calls.
Debug "Access Token = " + accessToken
Debug "Access Token Secret = " + accessTokenSecret
; Save the access token for subsequent REST API calls.
json.i = CkJsonObject::ckCreate()
If json.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
CkJsonObject::ckAppendString(json,"oauth_token",accessToken)
CkJsonObject::ckAppendString(json,"oauth_token_secret",accessTokenSecret)
fac.i = CkFileAccess::ckCreate()
If fac.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
CkFileAccess::ckWriteEntireTextFile(fac,"qa_data/tokens/trello.json",CkJsonObject::ckEmit(json),"utf-8",0)
Debug "Success."
CkHttp::ckDispose(http)
CkHttpRequest::ckDispose(req)
CkHttpResponse::ckDispose(resp)
CkHashtable::ckDispose(hashTab)
CkStringBuilder::ckDispose(sbUrlForBrowser)
CkSocket::ckDispose(listenSock)
CkSocket::ckDispose(sock)
CkOAuth2::ckDispose(oauth2)
CkStringBuilder::ckDispose(sbResponseHtml)
CkStringBuilder::ckDispose(sbResponse)
CkStringBuilder::ckDispose(sbStartLine)
CkJsonObject::ckDispose(json)
CkFileAccess::ckDispose(fac)
ProcedureReturn
EndProcedure