guideEasy Image - quick start

The aim of this article is to get you up and running with the Easy Image service.

Follow the steps below:

  • Subscribe to Easy Image on the CKEditor website.
  • Generate your access credentials in the CKEditor Ecosystem customer dashboard.
  • Write a script that generates one-time tokens for authorizing end users of your application in CKEditor Cloud Services (using access credentials created earlier).
  • Configure CKEditor.

You can also sign up for the CKEditor Premium Features 30-day free trial if you want to test this feature first.
Please refer to the Premium Features trial guide for more details.

All steps are explained in details below.

# Subscribe to CKEditor Cloud Services

Create an account in CKEditor Cloud Services by signing up to Easy Image. After signing up, you will receive access to the customer dashboard (CKEditor Ecosystem dashboard).

# Log in to the CKEditor Ecosystem dashboard

Log in to the CKEditor Ecosystem dashboard and navigate to “Your products > Cloud Services”.

From the list of available subscriptions in the dashboard choose the Easy Image subscription that you want to manage and press the “Manage” link. After clicking the “Manage” link, you will see the subscription parameters overview together with the management area below.

Easy Image subsription view.

# Create token endpoint

You now need to create a security token endpoint in your application. The role of this endpoint is to securely authorize end users of your application to use CKEditor Cloud Services only if they should have access to the content or action they are requesting.

# Development token endpoint

If you are just starting, you may use the development token endpoint URL which is available out of the box and requires no coding on your side. The URL of the development token endpoint can be obtained easily in three simple steps:

  1. From the list the environments choose the one that you want to manage. To create a new environment, follow instructions.

Environments list.

  1. Press the “Generate” button in the “Development token URL” section of the “CKEditor configuration” tab:

The button to generate development token URL.

The development token URL will show up in the “Development token URL” section:

CKEditor Configuration with the development token URL.

The development token endpoint is a special endpoint to help you in getting started with CKEditor Cloud Services. It offers unrestricted, full access to the service and will expire 30 days after being used for the first time. You should not use it on production. Anyone knowing this URL will have full access to the associated environment.

# Writing your own token endpoint

Skip this step if you use the development token endpoint.

To write your own security token endpoint, you need to create access credentials for the selected environment by going to the “Access credentials” tab and clicking the “Create a new access key” button.

Read more in the Creating access credentials section of the Environments management guide.

# Configure the application

In order to configure your CKEditor installation to use Easy Image, you need to provide two values:

  • The security token endpoint (token URL) of your choice.
  • The upload URL.

Note: Every customer (organization in the CKEditor Ecosystem customer dashboard) has their own, unique URLs to communicate with CKEditor Cloud Services, so it is necessary to configure the upload URL. The value of upload URL can be found in the CKEditor Ecosystem dashboard (navigate to the “CKEditor 5 configuration” tab in the selected environment).

CKEditor Configuration with the development token URL.

# CKEditor 5 configuration options

The following configuration options need to be set in your CKEditor 5 configuration:

Refer to the Easy Image integration guide in the CKEditor 5 documentation for more information.

# CKEditor 4 configuration options

The following configuration options need to be set in your CKEditor 4 configuration:

Note: Apart form setting the configuration options above, make sure that your CKEditor 4 build has the Easy Image plugin enabled. See the Easy Image Integration guide for more details.