IKuznetsov: Новая страница: «После определения области действия вашей конфигурации вам необходимо определить следу...»

2025-06-25T00:45:03Z

Новая страница: «После определения области действия вашей конфигурации вам необходимо определить следу...»

Новая страница

После определения области действия вашей конфигурации вам необходимо определить следующее:

* Базы данных, из которых можно собирать данные
* АктивныеШлюзы для выполнения расширения и подключения к вашим устройствам

== Пример полезной нагрузки ==
Пример полезной нагрузки для активации расширения '''Microsoft SQL''':
{| class="wikitable"
|{

"value": {

"enabled": true,

"description": "My Microsoft SQL extension",

"version": "1.0.1",

"sqlServerRemote": {

"endpoints": [

{

"host": "localhost",

"port": 1521,

"instanceName": "some-instanceName",

"databaseName": "some-databaseName",

"authentication": {

"scheme": "basic",

"username": "username",

"password": "password"

},

"ssl": false

}

]

}

},

"scope": "ag_group-default"

}
|}

== Параметры ==

=== Включение ===
Если установлено значение <code>true</code>, конфигурация активируется, и Ключ-АСТРОМ немедленно начинает мониторинг.

=== Описание ===
Понятное для человека описание особенностей данной конфигурации мониторинга.

=== Версия ===
Версия этой конфигурации мониторинга. Обратите внимание, что одно расширение может запускать несколько конфигураций мониторинга.

=== Конечные точки ===
В одной конфигурации мониторинга в разделе можно определить до '''20 000''' конечных точек <code>sqlServerRemote</code>.
{| class="wikitable"
|"sqlServerRemote": {

"endpoints": [

{

"host": "sqlserver.org",

"port": 1433,

"instanceName": "instance",

"databaseName": "database",

"authentication": {

"scheme": "basic",

"username": "admin",

"password": "password"

}

}

]

}
|}
Чтобы определить '''Microsoft SQL Server''', добавьте в раздел <code>endpoints</code> следующие данные:

* Хост
* Порт
* Имя экземпляра
* Имя базы данных
* Учетные данные аутентификации

=== Аутентификация ===
Данные аутентификации, передаваемые в '''API''' Ключ-АСТРОМ при активации конфигурации мониторинга, запутываются, и их невозможно получить.

==== Базовая ====
Для базовой аутентификации требуются только имя пользователя и пароль.
{| class="wikitable"
|"authentication": {

"scheme": "basic",

"username": "username",

"password": "password",

}
|}

==== Kerberos ====
Требует настройки домена '''Active Directory'''. Позволяет подключаться к базе данных, предоставляя имя пользователя домена, пароль, Key Distribution Center (KDC) и область.
{| class="wikitable"
|"authentication": {

"scheme": "kerberos",

"username": "username",

"password": "password",

"realm": "realm",

"kdc": "kdc"

}
|}

==== NTLM ====
'''Windows only'''

Требует настройки домена '''Active Directory'''. Позволяет подключаться к базе данных, предоставляя имя пользователя домена, пароль домена и, опционально, домен.
{| class="wikitable"
|"authentication": {

"scheme": "ntlm",

"username": "username",

"password": "password",

"domain": "some-domain-name"

}
|}

==== Хранилище учетных данных ====
Тип аутентификации хранилища учетных данных обеспечивает более безопасный подход к использованию расширений путем безопасного хранения и управления учетными данными пользователя. Чтобы использовать это, вы должны быть владельцем учетных данных и иметь хранилище учетных данных, которое соответствует следующим критериям:

* Тип учетных данных — Пользователь и пароль
* Область действия учетных данных — включены синтетические (в случае использования внешнего хранилища) и области аутентификации расширения.
* Доступ владельца разрешен только для владельцев учетных данных.

{| class="wikitable"
|"authentication": {

"scheme": "basic",

"useCredentialVault": true,

"credentialVaultId": "some-credential-vault-id"

}
|}

=== SSL ===
'''АктивныйШлюз версии 1.251+'''

Включите '''SSL''', чтобы источник данных проверял сертификат сервера и использовал шифрование '''SSL''' вместо собственного шифрования.
{| class="wikitable"
|"ssl": true
|}

==== Включить SSL без локального хранилища доверенных сертификатов ====
Когда '''SSL''' включен и цепочка сертификатов сервера публично проверяема (например, выпущена '''Azure''' или другими известными '''CA'''), нет необходимости вручную создавать '''truststore'''. Система автоматически будет доверять сертификату сервера на основе доверенных '''CA''' в среде.

Однако если вам необходимо использовать локальное хранилище доверенных сертификатов для сертификатов, не признанных во всем мире, или для дополнительных мер безопасности

# В директории АктивногоШлюза <code>userdata</code>, где запущен источник данных '''SQL''', вручную создайте доверенное хранилище '''PKCS12''' с именем <code>sqlds_truststore</code> и паролем <code>sqlds_truststore</code>. Команда для создания хранилища доверенных сертификатов с помощью keytool: <code>keytool -genkey -keystore sqlds_truststore -storepass sqlds_truststore -keyalg DSA</code>
#* Расположение директории <code>userdata</code>:
#** Windows : <code>%PROGRAMDATA%\astromkey\remotepluginmodule\agent\conf\userdata</code>
#** Unix : <code>/var/lib/astromkey/remotepluginmodule/agent/conf/userdata</code>
# Добавьте к нему сертификат сервера. Команда для импорта сертификата с помощью keytool: <code>keytool -import -keystore sqlds_truststore -file .\ora.crt -alias oracle</code>

==== Проверка SSL-сертификатов ====
'''АктивныйШлюз версии 1.269+'''

Сертификат дополнительно проверяется по имени хоста, что означает, что домен из сертификата должен совпадать с доменом из конечной точки, переданной в конфигурации мониторинга.

Включите эту опцию при подключении к базам данных с использованием пользовательских сертификатов.
{| class="wikitable"
|"validateCertificates": true
|}

=== Применение ===
Обратите внимание, что каждому хосту АктивногоШлюза, на котором запущено ваше расширение, необходим корневой сертификат для проверки подлинности вашего расширения.

Областью действия является группа АтивногоШлюза, которая будет выполнять расширение. Только один АктивныйШлюз из группы будет запускать эту конфигурацию мониторинга. Если вы планируете использовать один АктивныйШлюз, назначьте его выделенной группе. Вы можете назначить АктивныйШлюз группе во время или после установки.

При определении группы АктивногоШлюза используйте следующий формат:
{| class="wikitable"
|"scope": "ag_group-<ActiveGate-group-name>",
|}
Замените <code><ActiveGate-group-name></code> фактическим именем.

Конфигурация Microsoft SQL - История изменений

IKuznetsov: Новая страница: «После определения области действия вашей конфигурации вам необходимо определить следу...»