Generate Integration Token

This document explains how to generate tokens required for integration.

Token Information

The following information must be provided to Elice for integration:

• User Identifier (uid): This value is necessary to uniquely identify a specific user.

  • You can use a unique string (user ID, username, email, etc.) that is used for login in your LMS.

  • If you want Elice to handle course enrollment based on the course period in your LMS, you can include the period information with the uid. If the uid value remains unchanged, Elice will work in a way that modifies the existing course enrollment. Therefore, if you want a new course enrollment to take place based on the course period, you need to change the uid value. For example, if the username of a user in your LMS is test1, you can set different uid values such as test1_20200801 and test1_20200901 to have Elice treat them as separate integration accounts.

• User Full Name (fullname): This value is necessary for displaying a specific user's name in Elice.

• Email Address (email): This value is necessary to use various email-based services provided by Elice.

  • If an email address does not exist, you can use an empty string, but there may be restrictions on some services.

• Token Generation Time (ts): The time when the token is generated. It uses the millisecond unit epoch of the current time. If there is a time difference of more than 300 seconds between the generation time and the usage time of the token, the integration will be rejected to prevent reuse of the token if it is leaked.

You can also provide the following optional information:

• Course ID (courseId): The ID of the course that will be automatically enrolled in Elice. This ID is based on the course ID of Elice.

• If you want to use the course ID used in your LMS through separate customization, you need to go through a separate integration development process. Every time you create or connect a new course, you need to map the course ID of your LMS and the course ID of Elice through a prior consultation process.

Token Generation Methods

Tokens can be generated by using one of the following encryption and serialization methods for the JSON-serialized token information. In terms of the convenience of integration development, the JWT method, a web standard, is recommended. If you want additional security (confidentiality), you can use the AES-CBC method.

pageJWT Generate Tokens using a Tokenization MethodpageAES-CBC Generate Tokens using a Token Creation MethodpageSeparate self-encryption