Lessonspace Authentication

Lessonspace offers an out-of-the-box authentication process through the user's Lessonspace account. This authentication process can ensure that all users who join your Spaces are the correct users by requiring them to log in on Lessonspace.

Restricting Spaces

When creating a Space (using an id unique to your Organisation), you must set the allow_guests key; which will allow/disallow guests from entering a Space.

When allow_guests is set to false, a participant will not be able to join a Space as guest via the invite_url: www.thelessonspace/space/space:uuid. Instead they will have to login to their Lessonspace account or join via email. If they are not a member of your organisation, they will not be able to join the Space either.

However, users can still join using the client_url. In order to authenticate all users you must send them the invite_url, which is a parameter included in the client_url.

{
  "request": {
    "method": "POST",
    "url": "https://api.thelessonspace.com/v2/spaces/launch/",
    "headers": [
      {
        "name": "Authorization",
        "value": "Organisation __API_KEY__"
      }
    ],
    "postData": {
      "mimeType": "application/json",
      "text" : "{
        \"id\": \"space 2\",
        \"allow_guests\": false
      }"
    }
  },
  "response": {
    "status": 200,
    "httpVersion": "HTTP/2",
    "headers": [
      {
        "name": "content-type",
        "value": "application/json"
      }
    ],
    "content": {
      "text": "{\"client_url\": \"https://go.room.sh/...\", \"api_base\": \"https://ew2-aa.room.sh/v1/room/\", \"room_id\": \"uuid\", \"secret\": \"uuid\", \"session_id\": \"uuid\"}",
      "mimeType": "application/json"
    }
  }
}