Versions Compared

Old Version 31

changes.mady.by.user Chitra Borker (Deactivated)

Saved on

compared with

New Version 32

changes.mady.by.user Chitra Borker (Deactivated)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This section describes the requirements for using your own custom UI for your Digital Person's conversational experiences.

InfoNote: A core assumption for this section is that you already have familiarity with building a UI and/or back-end Orchestration Server for your conversational experience. It also assumes that you have integrated our Web SDK into your website. If not, please refer to your technical kick-off documentation. 

Soul Machines uses an SSK to grant your UI access to our session servers. By signing a JSON Web Token with the SSK, our servers will grant you access.

What is a Shared Secret Key

A Shared Secret Key (SSK) is a cryptographic key or data that is only known to the parties involved in a secured communication. The shared secret can be anything from passwords or passphrases to a random number or an array of randomly chosen data.

Why would I use a Shared Secret Key

Soul Machines uses an SSK to grant your UI access to our session servers. By signing a JSON Web Token with the SSK, our servers will grant you access. By accessing these servers

?

By accessing our servers, you will effectively be able to host our Digital Person conversational experiences on your website and optionally connect the Digital Person to a custom backend. 

The DDNA Digital DNA Studio provides you with the three pieces of information that you need:

  1. privateKeyDigital Person Server domain name is also called the Token Server or Session Server.

  2. keyName; this is called the “issuer” within the JWT Session Server

  3. domain name is also called the Persona Server or Digital Person Server.privateKey

Image Added

The private key must be used to sign the JWT using the HMAC-SHA256 signing standard, as shown in the following architecture diagram.

Figure 11: Architecture Diagram

How would I use a Shared Secret Key

When deploying an experience through the Digital DNA Studio, be sure to: 

  1. Select the “I HAVE MY OWN” option under the Deployment Configuration settings. You will be provided with a privateKey and the keyName under the “Session Server” category. 

  2. Sign your JWT. Use these three values when you are signing your JSON Web Token (JWT) to authorize a connection to the Digital Person. 

Info

NOTE: This is a token sent along with the connection request from a UI you are hosting yourself (your website) and tells our server to grant you access.

Sample Code

You can use our sample code for local development testing and as the basis of a production deployment if you wish.

Express Token Server

The express-token-server sample code generates signed JWTs. To use the values provided by DDNA Studio, copy the .env.template file to .env, then within that copied file:

  1. Assign the SESSION_SERVER variable to the Session Server name provided by Studio.

  2. Assign the JWT_PUBLIC_KEY variable to the Key Name provided by Studio.

  3. Assign the JWT_PRIVATE_KEY variable to the Private Key provided by Studio.

React and Angular Templates

UI sample code in the form of React and Angular templates can be pointed at the express-token-server to use it for JWT generation, which in turn enables the UI to connect to the video and audio streams associated with the Digital Person running on Soul Machines' servers.


Connect to a Custom Back-end

If you wish to connect to a custom backend Orchestration Server to direct your Digital Person, then the address of this server must be included in your signed JWT using the sm-control field. 

Refer to the Soul Machines Web Development Kit Reference Guide for more information on configuring your JWT.

Contents

Table of Contents