Configuring integrations with .env variables

The open-source edition of Ylem enables you to configure some integrations by creating your accounts there first and then using credentials such as tokens, API keys, or secret keys in Ylem's environment variables to make it work.

Here on this page, we describe all of such integrations and the environment variables you need to configure to make it work. However, you can also find necessary information at the global .env.common file in the root folder or the .env files of every microservice.

User authentication with Google

If you want to enable user authentication in Ylem's UI through Google, you need to configure the following parameters in the ./backend/users/.env file:

USERS_GOOGLE_CLIENT_ID=
USERS_GOOGLE_CLIENT_SECRET=
USERS_GOOGLE_CALLBACK_URL=http://%%YOUR_DOMAIN_NAME_IS_HERE%%/auth/google/callback

Read the following guide from Google to configure user authentication and obtain client ID and secret first.

OpenAI ChatGPT in pipelines

To be able to use GPT task, you need to configure your API Secret Key and choose a model you want to use:

TASK_RUNNER_OPENAI_GPT_KEY=%%YOUR_KEY_IS_HERE%%
TASK_RUNNER_OPENAI_MODEL=gpt-4o-mini

The following two variables need to be placed in the file ./processor/taskrunner/.env.

Read more about API Keys and available models in the official OpenAI reference guide.

Using Twilio to send SMS from pipelines

If you want to send SMS from the pipeline Notification task, you need to create your own Twilio account and configure the following parameters:

YLEM_INTEGRATIONS_TWILIO_ACCOUNT_SID=
YLEM_INTEGRATIONS_TWILIO_AUTH_TOKEN=
YLEM_INTEGRATIONS_TWILIO_NUMBER_FROM=

The following variables need to be placed in the root folder file ./.env.common

Read more about setting up Twilio auth token and account side here.

Accounts and API tokens can be viewed in the Twilio dashboard here: https://console.twilio.com/us1/account/keys-credentials/api-keys

Using AWS KMS to encrypt/decrypt data

Ylem supports integration with AWS KMS for encrypting/decrypting information about users, organizations and integration credentials.

The following variables need to be placed in the root folder file ./.env.common

AWS_KMS_KEY_ID= 
AWS_REGION= 
AWS_ACCESS_KEY_ID= 
AWS_SECRET_ACCESS_KEY=

This integration is optional and if these variables are left empty, the information will be stored unencrypted.

Sending E-mails with Amazon SES

The same variables in the ./env.commonfile can be used to enable E-mail sending with Amazon SES:

AWS_REGION=
AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=

More infirmation about it can be found on the E-mail integration page.

OAuth 2.0 Integrations

Atlassian Jira

The following parameters need to be changed on the backend/integrations/.env file:

INTEGRATIONS_JIRA_OAUTH_CLIENT_ID=%%REPLACE_IT_WITH_THE_CLIENT_ID_OF_YOUR_APP%%
INTEGRATIONS_JIRA_OAUTH_CLIENT_SECRET=%%REPLACE_IT_WITH_THE_CLIENT_SECRET_OF_YOUR_APP%%
INTEGRATIONS_JIRA_AFTER_AUTHORIZATION_REDIRECT_URL=https://%%REPLACE_IT_WITH_THE_DOMAIN_NAME_OF_YOUR_YLEM_INSTANCE%%/jira-authorizations/{uuid}/?justConnected

The full information how to enable Atlassian Jira integration for the open-source edition is available on the integration page.

Hubspot

The following parameters need to be changed on the backend/integrations/.env file:

INTEGRATIONS_HUBSPOT_OAUTH_CLIENT_ID=%%REPLACE_IT_WITH_THE_CLIENT_ID_OF_YOUR_APP%%
INTEGRATIONS_HUBSPOT_OAUTH_CLIENT_SECRET=%%REPLACE_IT_WITH_THE_CLIENT_SECRET_OF_YOUR_APP%%
INTEGRATIONS_HUBSPOT_AFTER_AUTHORIZATION_REDIRECT_URL=https://%%REPLACE_IT_WITH_THE_DOMAIN_NAME_OF_YOUR_YLEM_INSTANCE%%/hubspot-authorizations/{uuid}/?justConnected

The full information how to enable Hubspot integration for the open-source edition is available on the integration page.

Salesforce

The following parameters need to be changed on the backend/integrations/.env file:

INTEGRATIONS_SALESFORCE_OAUTH_CLIENT_ID=%%REPLACE_IT_WITH_THE_CLIENT_ID_OF_YOUR_APP%%
INTEGRATIONS_SALESFORCE_OAUTH_CLIENT_SECRET=%%REPLACE_IT_WITH_THE_CLIENT_SECRET_OF_YOUR_APP%%
INTEGRATIONS_SALESFORCE_AFTER_AUTHORIZATION_REDIRECT_URL=https://%%REPLACE_IT_WITH_THE_DOMAIN_NAME_OF_YOUR_YLEM_INSTANCE%%/salesforce-authorizations/{uuid}/?justConnected

The full information how to enable Salesforce integration for the open-source edition is available on the integration page.

Slack

The following parameters need to be changed on the backend/integrations/.env file:

INTEGRATIONS_SLACK_OAUTH_CLIENT_ID=%%REPLACE_IT_WITH_THE_CLIENT_ID_OF_YOUR_APP%%
INTEGRATIONS_SLACK_OAUTH_CLIENT_SECRET=%%REPLACE_IT_WITH_THE_CLIENT_SECRET_OF_YOUR_APP%%
INTEGRATIONS_SLACK_AFTER_AUTHORIZATION_REDIRECT_URL=https://%%REPLACE_IT_WITH_THE_DOMAIN_NAME_OF_YOUR_YLEM_INSTANCE%%/salesforce-authorizations/{uuid}/?justConnected

The full information how to enable Slack integration for the open-source edition is available on the integration page.