Skip to main content

Alexa Skills Kit Integration

Alexa Skills Kit (ASK) is the official collection of tools, documentation and APIs for development on Amazon's Alexa voice service. This document goes over the process of using LoginRadius along with the Alexa Skills Kit to enable account linking within your Alexa Skills.

Configuration​

  1. This Integration makes use of the LoginRadius OAuth 2 Single Sign On feature. We recommend reading the documentation on this feature before proceeding.

  2. Go to your desired Alexa Skill and on the left sidepanel click "Account Linking". Go to Account Linking

  3. On the "Account Linking" page you can enable the service by clicking the toggle. enter image description here

    Fill out each field as per the instructions provided below:

    • Select an authorization grant type: Choose "Auth Code Grant".

    • Authorization URI: https://cloud-api.loginradius.com/sso/oauth/redirect

    • Access Token URI: https://cloud-api.loginradius.com/sso/oauth/access_token

    • Client Id: Your_LoginRadius_API Key

    • Client Secret: Your_LoginRadius_API_Secret

    • Client Authentication Scheme: From the dropdown choose "Credentials in request body".

    • Scope: You must provide the desired scopes as per our LoginRadius OAuth 2 Single Sign On Documentation. e.g. r_basicprofile

    • Domain List:

      • Provide the LoginRadius Cloud API Address:

        cloud-api.loginradius.com

      • Your LoginRadius sitename address:

        your-loginradius-sitename.hub.loginradius.com

    • Default Access Token Expiration Time: To ensure that the token is not stored and usable indefinitely, Amazon allows you to set an expiration time.

    • Redirect URLs: Amazon will provide you with a list of addresses to be used for redirecting the user as part of authorization process, make sure you add them in your LoginRadius Admin Console under:

      Deployment ➔ Configuration ➔ App

    Note: If you're building a Smart Home Skill, On the left sidepanel click "PERMISSIONS" and make sure that you do not have "Send Alexa Events" enabled as this will enable an alternative workflow requiring to go through Login With Amazon (LWA) for authentication.

  4. Once you have filled out all of the configurations, Account Linking will happen when the user enables the Alexa App or if you're building a Custom Skill you can send a Link Account card via your Alexa Skill. This can be done via the linkAccountCard function if you're using the alexa-skills-kit-sdk-for-nodejs.

  5. Account Unlinking happens automatically via the Alexa App when a user disables your skill.