Views:

Access Brillium data using the Brillium RESTful Web API.

Enabling the Brillium Assessment Builder API

NOTE

By default, the Web API is disabled for a new or existing Brillium Assessment Builder application.
To enable API access, an API password must first be setup using the API Configuration screen.
Follow the steps below to configure the Brillium Assessment Builder API.
  1. Sign into Brillium. The API can only be enabled using a user account with Administrator privileges.
  2. Select the Settings (gear) icon.
  3. Select Workspaces from the menu The current workspace is shown in bold.
  4. The Brillium API must be configured from the Primary Workspace.  The Primary Workspace is indicated by a crown icon.
    Brillium Primary Workspace indicated by a crown
  5. If the Primary Workspace is not shown in bold lettering, right-click the Primary Workspace and select Enter from the menu, to enter the Primary Workspace and follow steps 1 through 3.
  6. Select API from the following menu.
  7. Select the Enable radio button.
  8. Enter an API Password in the Password field
  9. Re-enter an API password to confirm it is entered correctly.
  10. Select the Change button to generate an API Security Token. To view the Security Token, select the Show button.
  11. Record the API Password you entered, and the Security Token and store it in a safe place. You will need this information to access the API through your application.
  12. Click the Save button to save the configuration and enable API access to your Brillium data.

The API Password

It is important to note that the API Password is separate and distinct from the password you use to sign into Brillium. When one password is changed, it does not affect the other password.

How to Change the API Password

To change the API password, return to the API Configuration screen and enter a new password and confirm it. Select the Save button to save the changes.

How to Change the Security Token

To change the Security Token, return to the API Configuration screen and select the Change button beside the Security Token field. Select the Save button to save any changes.

CAUTION

Changing your API Password or Security Token will invalidate the previous tokens. If a change is made, any applications that access the Brillium API will need to be updated with the new authentication information.

Create an Authentication/Authorization HTTP Header

To authenticate with the Brillium WebAPI, you must create an authorization token and include it within the HTTP headers for each API request. To create an authorization token, you use the API Namespace, the API Password, and the Security Token. The API namespace is shown on the API Configuration screen, and the API password and security token are defined “Enabling the Brillium Assessment Builder API” section above.

For example, assume the following values:

API Namespace: ASSESSMENTS-API
API Password: password123
Security Token: b6e60bfb08994be79e17e35656e3246e

The token is created by placing all elements together in a single text string with no spaces. The form of the token is as follows:

ASSESSMENTS-API:API Password and Security Token.

EXAMPLE

ASSESSMENTS-API:password123b6e60bfb08994be79e17e35656e3246e

This authentication string needs to be Base-64 encoded. When completed, it should look similar to the following example:

U1VQRVJTVURTOnBhc3N3b3JkMTIzYjZlNjBiZmIwODk5NGJlNzllMTdlMzU2NTZlMzI0NmU=

This encoded authentication string must be included as an “Authorization” HTTP header within all API requests:

Authorization: Basic U1VQRVJTVURTOnBhc3N3b3JkMTIzYjZlNjBiZmIwODk5NGJlNzllMTdlMzU2NTZlMzI0NmU=