Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Get User Credentials

...

  1. Go to https://launchpad.37signals.com/integrations.

  2. Click on Register Application

  3. Give proper values for

    • Name of Your Application
    • Your company’s name 
    • Your website URL
    • Check the products that your application integrate with.
    • Redirect URL -  Enter the Callback URL
  4. Click on Register this App and get client Id, client Secret. Store them for future use

  5. Get the Authorization code from Azure Access Control Service Construct the authorization url as: https://launchpad.37signals.com/authorization/new?type=web_server&client_id=your-client-id&redirect_uri=your-redirect-uri
  6. It ask whether it's ok to give access to your app. Click on Yes,I'll allow access.

  7. Basecamp site redirects the browser back to the redirect URI that was specified when the app was registered in step 3. It also includes the authorization code as a query string. The redirect URL is structured like: https://redirect_url?code=<authorization_code>. Extract query string value code from the url and it will be used in next step.

  8. Get the access token and refresh token from code, construct the post request URL: https://launchpad.37signals.com/authorization/token?type=web_server&client_id=your-client-id&redirect_uri=your-redirect-uri&client_secret=your-client-secret&code=verification-code

...

Code Block
languagexml
titleinit
<basecamp.init>
	<accessToken>{$ctx:accessToken}</accessToken>
    <apiUrl>{$ctx:apiUrl}</apiUrl>
	<accountId>{$ctx:accountId}</accountId>
	<userAgent>{$ctx:userAgent}</userAgent>
	<eTag>{$ctx:eTag}</eTag>
	<lastModifiedDate>{$ctx:lastModifiedDate}</lastModifiedDate>
</basecamp.init>
Properties
  • accessToken: The access token to authenticate Basecamp using OAuth 2.0.
  • apiUrl: The URL of the Basecamp API. 
  • accountId: The unique identifier of the account(You can find the accountId in basecamp URL. The URL is structured like : https://3.basecamp.com/<accountId>/projects).
  • userAgent: This is used by the API to store developer information.
  • eTag: Optional - The e-tag of a previously given response.
  • lastModifiedDate: Optional - The last modified date of the resource.

...

Code Block
languagexml
titlemessageBuilders
<messageBuilder contentType="text/html" class="org.wso2.carbon.relay.BinaryRelayBuilder"/>

Follow the below-mentioned steps to add a valid certificate to access basecamp API over https.

...

Navigate to "<EI_HOME>/repository/resources/security/" using the command prompt and execute the following command.

Code Block
keytool -importcert -file CERT_FILE_NAME -keystore client-truststore.jks -alias "CERT_NAME"

This command will import Basecamp certificate into keystore.To import the certificate give "wso2carbon" as password. Press "Y" to complete certificate import process.

...

>

...

Navigate to "<BASECAMP_CONNECTOR_HOME>/src/test/resources/keystores/products" using the command prompt and execute the following command.

Code Block
keytool -importcert -file CERT_FILE_NAME -keystore wso2carbon.jks -alias "CERT_NAME"

This command will import Basecamp certificate into keystore.To import the certificate give "wso2carbon" as password. Press "Y" to complete certificate import process.

Info
titleNote
  • CERT_FILE_NAME - Replace CERT_FILE_NAME with the file name that was extracted from basecamp with the extension (e.g. basecampcom.crt).
  • CERT_NAME - Replace CERT_NAME with name for the certificate (e.g. basecamp)

    Now that you have connected to Basecamp, use the information in the following topics to perform various operations with the connector.

    ...