Libraries of items

Emails

The Emails library item allows you to create email groups that can later be used in notification rules.

To add a new email group, follow these steps:

Name

Description

Шаг 1. Создать группу почтовых адресов.

In the Email groups pane, click Add and give a name to the new group.

Шаг 2. Добавить почтовые адреса в группу.

Highlight the group just created, click Add in the Emails pane, and add the desired email addresses.

The administrator can create custom email lists and distribute them centrally to all computers where UserGate is installed. To create such a list, follow these steps:

Name

Description

Шаг 1. Создать файл с необходимыми списком почтовых адресов.

Создать файл list.txt со списком почтовых адресов.

Step 2. Create an archive containing this file.

Поместить файл в архив zip с именем list.zip.

Step 3. Create a version file for the list.

Create a file named version.txt and specify the list version number inside it, such as 3. On each update of the list, the version number must be incremented.

Step 4. Upload the files to a web server.

Разместить у себя на сайте list.zip и version.txt, чтобы они были доступны для скачивания.

Шаг 5. Создать список почтовых адресов и указать URL для обновления.

On each UserGate server, create an email list. When creating the list, select Updatable as the list type and enter the address for downloading updates. UserGate will check for a new version on your website according to the set update download schedule. The schedule can be configured in the list properties. The available options are:

  • Disabled: update checking will not be performed for the selected item

  • Daily

  • Weekly

  • Monthly

  • Every ... hours

  • Every ... minutes

  • Advanced.

With the Advanced option, a crontab-like format is used where the date/time string consists of six space-separated fields. The fields specify the time as follows: (minutes: 0-59) (hours: 0-23) (days of the month: 1-31) (month: 1-12) (days of the week: 0-6, where 0 is Sunday). Each of the first five fields can be defined using:

  • An asterisk (*) denotes the entire range (from the first number to the last).

  • A dash (-) denotes a number range. For example, "5-7" means 5, 6, and 7.

  • Lists: comma-separated numbers or ranges. For example, "1,5,10,11" or "1-11,19-23".

An asterisk or range spacing: used for spacing out values in ranges. The increment is given after a slash. Examples: "2-10/2" means "2,4,6,8,10" while "*/2" in the "hours" field means "every two hours".

Phones

The Phones library items allows you to create phone groups that can later be used in SMPP notification rules.

To add a new phone group, follow these steps:

Name

Description

Шаг 1. Создать группу телефонных номеров.

In the Phone groups pane, click Add and give a name to the new group.

Шаг 2. Добавить номера телефонов в группу.

Highlight the group just created, click Add in the Phones pane, and add the desired phone numbers.

The administrator can create custom phone lists and distribute them centrally to all computers where UserGate is installed. To create such a list, follow these steps:

Name

Description

Шаг 1. Создать файл с необходимыми списком номеров.

Создать файл list.txt со списком номеров.

Step 2. Create an archive containing this file.

Поместить файл в архив zip с именем list.zip.

Step 3. Create a version file for the list.

Create a file named version.txt and specify the list version number inside it, such as 3. On each update of the list, the version number must be incremented.

Step 4. Upload the files to a web server.

Разместить у себя на сайте list.zip и version.txt, чтобы они были доступны для скачивания.

Шаг 5. Создать список телефонных номеров и указать URL для обновления.

On each UserGate server, create a phone list. When creating the list, select Updatable as the list type and enter the address for downloading updates. UserGate will check for a new version on your website according to the set update download schedule. The schedule can be configured in the list properties. The available options are:

  • Disabled: update checking will not be performed for the selected item

  • Daily

  • Weekly

  • Monthly

  • Every ... hours

  • Every ... minutes

  • Advanced.

With the Advanced option, a crontab-like format is used where the date/time string consists of six space-separated fields. The fields specify the time as follows: (minutes: 0-59) (hours: 0-23) (days of the month: 1-31) (month: 1-12) (days of the week: 0-6, where 0 is Sunday). Each of the first five fields can be defined using:

  • An asterisk (*) denotes the entire range (from the first number to the last).

  • A dash (-) denotes a number range. For example, "5-7" means 5, 6, and 7.

  • Lists: comma-separated numbers or ranges. For example, "1,5,10,11" or "1-11,19-23".

An asterisk or range spacing: used for spacing out values in ranges. The increment is given after a slash. Examples: "2-10/2" means "2,4,6,8,10" while "*/2" in the "hours" field means "every two hours".

Notification Profiles

A notification profile defines a transport that can be used to deliver notifications to the users. Two types of transport are supported:

  • SMTP for delivering messages by email

  • SMPP for message delivery by SMS via virtually any cellular provider or the numerous SMS distribution centres.

To create an SMTP notification profile, go to the Notification profiles section, click Add, select Add SMTP notification profile, and fill in the relevant fields:

Name

Description

Name

Profile name.

Description

Profile description.

Host

The IP address of the SMTP server that will be used for sending emails.

Port

The TCP port used by the SMTP server. Обычно для протокола SMTP используется порт 25, для SMTP с использованием SSL --- 465. Consult your email server administrator regarding this value.

Connection security

The following outgoing email security options are available: None, STARTTLS, and SSL.

Authentication

Turns on authentication for SMTP server connection.

Login name

The account name for connecting to the SMTP server.

Password

The account password for connecting to the SMTP server.

To create an SMPP notification profile, go to the Notification profiles section, click Add, select Add SMPP notification profile, and fill in the relevant fields:

Name

Description

Name

Profile name.

Description

Profile description.

Host

The IP address of the SMPP server that will be used for sending SMS messages.

Port

The TCP port used by the SMPP server. Usually, SMPP uses port 2775, and SMPP with SSL uses port 3550.

SSL

Specifies whether or not SSL encryption is used.

Login name

The account name for connecting to the SMPP server.

Password

The account password for connecting to the SMPP server.

Phone translation rules

In certain cases, the SMPP provider expects a phone number in a specific format, such as 0123456789. To meet the provider's requirements, you can configure the replacement of the leading phone number digits with others. For example, you can replace the leading +971 with 0.