Skip to content

Account Setup

Setting Up Your Account

With LTIAAS, setting up an LTI API for your company is easy. LTIAAS hosts a private API service that you can use to connect LTI tools with LMSs. Getting started is free and easy.

This guide will walk you through creating an account and activating your API in the LTIAAS Portal.

Step 1. Log In To The Portal

All LTIAAS services are managed via the customer portal. To access the portal, please log in using either your email address or Google account. If an account doesn't exist, it will be created for you.

Step 2. Create New Account

Before LTIAAS can create and activate the account, we need to know the account type. We have two types that we support today: An LTI Tool (a web application that is accessed from an LMS) or an LTI Platform (the LMS itself).

On this 'Create New Account' screen, you are asked to provide a name. This name is only use by you. Some customers have several accounts, so it is helpful to have easily identifiable names for each.

If you already have at least one account, you can add another account by clicking on the + Add Account button on the Portal home page.

Step 3. Create Your Plan

On the next screen, you get to choose the options for your plan. Options can be selected by clicking the Select button below each plan option.

Fore more information about our plans and pricing, please visit our pricing page.

Once you have selected your plan options, we ask that you enter in your credit card to activate the subscription. If a credit card is not an available option for payment, please reach out to us. We can accommodate most payment methods with manual intervention. If you are choosing our free tier, no credit card is required.

When the form is complete. Click the Subscribe button.

After subscribing, you can change your subscription and billing information at any time without an interruption in service. Just click on the Billing link in the portal for this account.

Step 4. Set Your API Settings

Once you have created your account, the next step is to set up your API. You should be guided to the API Settigns page. If not, please click on the API Settings link on the sidebar.

You will be asked to fill in the API settings.

All the API settings can be changed at any time. However, the subdomain and zone, once set, cannot be changed without contacting support.

In order for basic LTI launch to work, you need to set the Launch URL setting. This is the URL, hosted by you, that users will be directed to when they click the link to your activity in the LMS.

In order for Deep Linking to work (if you choose it as an option in step 4), you need to provide the URL. This URL, hosted by you, is the location that that users (probably teachers) will be directed to when they click the option to "choose an activity" when adding your tool into a course.

After filling on the API settings form (as shown below), click the submit button at the bottom of the form.

Note: The last two sections displayed in this guide: Deep Linking Settings and Dynamic Registration Settings will only appear if you selected those features in step 4.

Step 5. Deploy!

Any time you make a change to the API settings, you need to deploy those changes to the LTIAAS cloud. The LTIAAS Portal will detect when these settings change and will display a message (shown below) asking you to deploy the settings change.

Clicking on the Deploy Now button will trigger the settings to propagate to the LTIAAS cloud service. Typically, changes will be available in about 10 seconds. But in rare cases, it may take up to 5 minutes for the new settings to be deployed. In the process of deploying the changes, your private API may become unavailable for a few seconds.

Step 6. Get Your API Key

After your first deploy, you need to get an API key. Click the `Generate New API Key1 button.

Once the API key is generated, your private API key will become visible.

Click on the button to copy this key to your clipboard. This key should be used when making API requests to LTIAAS.

Step 7. Test The API

There are a couple quick tests you can do to make sure your API is live and your API key is working.

Access The Public /keys Endpoint

LTIAAS serves a list of public keys for all the platforms registered to your service. You can use the /keys endpoint to get this list. It is also a good first test to ensure the LTIAAS service is accessible (from behind a fire walled server, for example). You can access this endpoint with any web browser by navigating to https://your.ltiaas.com/keys to use the cURL tool:

curl https://your.ltiaas.com/keys

Where your is the subdomain you chose in step 5.

A new API with no registrations should return an empty array called 'keys':

{"keys":[]}

Access The Private /admin/platforms Endpoint

Once the /keys endpoint has been validated, the next step is to attempt to access a private endpoint that requires an API Key to access. The simplest API request to make is a GET request to the /admin/platforms endpoint. It is the endpoint used to get a lost of registered LMSs.

curl -H "Authorization: Bearer <API_KEY>" https://your.ltiaas.com/admin/platforms

Where your is the subdomain you chose in step 5, and <API_KEY> is the key found from step 7.

A new API with no registrations should return an empty array called 'platforms'.

{"platforms":[]}

If your API Key was incorrect, you will get a message stating you have an "Invalid API Key".