cancel
Showing results for 
Search instead for 
Did you mean: 

Arc Release Notes (2019-01-24)

Arc Release Notes (2019-01-24)

In this Arc release, the Public API OAuth allows developers to write integrations without requiring users to provide their own session tokens. Additionally, in standalone Arc sites, users can view approved integrations in the My Account page and the Admin Dashboard supports adding developer keys.

Arc is an online video platform that makes learning more impactful through active collaboration.  Learn more about Arc.

  New Features

   < BACK TO TABLE OF CONTENTS

Arc 

Public API OAuth

The Public API OAuth allows developers to write integrations without requiring users to provide their own session tokens. The Public API OAuth provides a seamless user experience for end-user authentication of integrations.

Users no longer have to log in to Arc manually and generate a session token to copy to an integration. The integration can send them to Arc within their own environment and user interface and have the user simply enter their Arc username and password to authenticate.

  Updated Features

   < BACK TO TABLE OF CONTENTS

Arc Site 

User Menu
In standalone Arc sites, users can view approved integrations in the My Account page. This page displays all the third-party applications that have been authorized to access the user’s Arc site on their behalf.

Open My Account

View Approved Integrations

 

Admin Dashboard
In standalone Arc sites, the Admin Dashboard supports adding developer keys. This feature allows Arc admins and/or developers to view and create developer keys for various integrations within their Arc account. The developer key displays the name of the app or company, the redirect URIs, a client ID, and a secret token for authentication.

Open Developer Keys

Add Key Settings

Comments

I generated a key in my dashboard but it is not working, I must be doing something wrong ... could it help me to understand better how I would use this key? I'm testing here: https://tw.instructuremedia.com/api/public/docs/

I am accustomed to doing the authentication in this API by placing in the Headers:
Authorization: Bearer user_id = "myId", token = "myToken"

When I go to "Authorize" should I just put the secret? such as this: [redacted]

Thanks for the help.

Hi fabiosousa@pucminas.br, please know that we have redacted your comment to remove the information that might compromise your Arc account's security.

Thanks, 

Alli

Okay, I had changed the key, it was not valid.

Hi fabiosousa@pucminas.br

Here are instructions regarding the API. Please let me know if this answers your question. Thanks!

0. Go to the Developer Keys tab in the Admin Dashboard and get the client id (YOUR_CLIENT_ID) and secret (YOUR_CLIENT_SECRET), creating them if necessary.
1. Make a request like
curl -v -XPOST "https://<YOUR_ARC_SUBDOMAIN>.instructuremedia.com/api/public/oauth/authorize?client_id=<YOUR_CLIENT_ID>&redirect_uri=<YOUR_URL_ENCODED_REDIRECT_URI>&response_type=code"

2. You will be redirected to an Arc login page like this:
https://<YOUR_ARC_SUBDOMAIN>.instructuremedia.com/login?client_id=<YOUR_CLIENT_ID>&redirect_uri=<YOUR_URL_ENCODED_REDIRECT_URI>
If using cURL, you should find this URL in the location header of the 302 response which you can then paste into your browser to get to the login page.

3. You will be redirected to <YOUR_URL_ENCODED_REDIRECT_URI>?code=<AUTHORIZATION_CODE>. Save AUTHORIZATION_CODE for the next step.

4. Make a request like
curl -XPOST "https://<YOUR_ARC_SUBDOMAIN>.instructuremedia.com/api/public/oauth/token?grant_type=authorization_code&client_id=<YOUR_CLIENT_ID>&client_secret=<YOUR_CLIENT_SECRET>&code=<AUTHORIZATION_CODE>&redirect_uri=<YOUR_URL_ENCODED_REDIRECT_URI>"

You will receive a response like the following:
{
"access_token": "SOME_ACCESS_TOKEN",
"created_at": 1551468094,
"expires_in": 7200,
"refresh_token": "SOME_REFRESH_TOKEN",
"token_type": "Bearer"
}

5. You use the access_token from above to try it out using cURL like this:
curl -H Authorization:"Bearer <YOUR_ACCESS_TOKEN>" https://<YOUR_ARC_SUBDOMAIN>.instructuremedia.com/api/public/v1/ping

If it was successful, you will receive the text "pong"

6. To use this token in the documentation at https://<YOUR_ARC_SUBDOMAIN>.instructuremedia.com/api/public, enter "Bearer <SOME_ACCESS_TOKEN>" into the Authorization dialog.

7. If this token expires, you may request a new one by refreshing it by making a POST to
curl -XPOST "https://<YOUR_ARC_SUBDOMAIN>.instructuremedia.com/api/public/oauth/token?grant_type=refresh_token&client_id=<YOUR_CLIENT_ID>&client_secret=<YOUR_CLIENT_SECRET>&refresh_token=<SOME_REFRESH_TOKEN>"

Hello allifoote! I am grateful for your help, i did all steps and it worked well! Thank you very much. 😃

Hi fabiosousa@pucminas.br, that is wonderful news! Our Arc product team is amazing and sent me those instructions.

Have a great day!

- Alli

Version history
Revision #:
1 of 1
Last update:
‎01-24-2019 07:35 AM
Updated by: