AppsAnywhere has the ability manage API keys and add a scope for the generated API key, In this section, we explain this process and how it works.

In this article

Also in this section

There are no sub-sections to this page



Overview

This article will go over Managing your API Keys in AppsAnywhere.

  1. Log into AppsAnywhere as an admin user
  2. Click on Return to Admin to access the AppsAnywhere admin portal
  3. On the navigation buttons at the top right of the page, select the Settings menu (the small cog icon) and then API Keys

Creating an API Key

You can add new API keys directly from this page. The form on the left will allow you to submit the information to add a new one, and the table on the right will display the ones that have already been added.

Enter the details of your API Key:

Form field nameExplanationExpected valueExample
Display nameThe name to be displayed in AppsAnywhere

You can call the API Key anything you want, this will only be displayed in AppsAnywhereAppsAnywhere Apps
Scopes

Allows access to certain APIs based on what is chosen

Currently there is only a single scope available:

  • Shared App Lists - Request Apps: provides access to the API for retrieving launch information for applications that are part of LMS associated App Lists
You can select the checkboxes for the APIs you want access toChecked

Once you have entered the information required you can click Save to add your new API key.

You won't be able to save your key without selecting at least one scope. However there will be more options added in the future.


A pop up message will show once you have saved the API key and it will display what your new key is, as can be seen below:

For example your new key in the above screenshot would be: zdul7iV76k.ozZd8NQWW0azOx81p6X2JA==

Warning

it is vital that you copy and paste the API key generated as it is shown once; you will have to create a new API key again to generate a new one.

Listing API Keys

As aforementioned the table on the right will display existing API keys added to the system, as can be seen below:


You may have noticed additional information related to the API Keys you have created, these will have been automatically generated for you to help you with administration of these keys. The following table will explain the different fields in more detail:

Field nameExplanationExample
Prefix

Created by the system so that you can more easily identify the API key when it is being used

A randomly generated value consisting of letters and numbers

zdul7iV76k
Created DateThe date when the API key was createdJun 22, 2020, 12:11:11 PM

New API keys will be added to the top of the table rather than at the bottom.

Revoking an API Key


If you want to remove access to an existing API Key then click Revoke next to the one you want to remove access for.

You will then be prompted to confirm the revocation. Check the name of the API Key in the message to ensure you are deleting the correct one.

Click the Revoke button in the dialog to remove the LTI application.

Make sure that the API Key you are revoking is no longer used. Revoking an API Key will immediately deny access to callers using the key. Revoking an API Key is not reversible.




Written By: