This bundle contains functions to help generate OAuth access tokens for your application's users.
To use these Choreos:
Sign up for a Twitter account if you don't already have one.
You'll also need to register your application with Twitter.
Obtain your API Key and API Secret which can be found on the API Keys tab on your application page. Note that your API Key and API Secret correspond to the ConsumerKey and ConsumerSecret Choreo inputs.
You are required to specify a callback URL when registering your application with Twitter. However this can be any URL, as its value is overwritten during the OAuth process.
By default, new Twitter apps have Read only permission. If your application needs to post to Twitter or access direct messages, go to the Permissions tab on your application page and specify Read and Write or Read, Write and Access direct messages.
Wait a few minutes for these changes to be applied to your application.
Run the InitializeOAuth Choreo, specifying the Consumer Key and Consumer Secret from the app you registered at Twitter. The InitializeOAuth Choreo will return an authorization URL, a callback ID and OAuth token secret (required for the FinalizeOAuth step).
Open a new web browser, navigate to the authorization URL returned by the InitializeOAuth Choreo, and click "allow" to grant the app access to your Twitter account.
Run the FinalizeOAuth Choreo, specifying the callback ID and OAuth token secret returned earlier by the InitializeOAuth Choreo, to obtain an OAuth access token and access token secret that can be used to access the Twitter API.