UserSide API Key: различия между версиями

Материал из WiKi - UserSide
(Новая страница: «Для функционирования '''API''' ERP "UserSide" и взаимодействия внешних модулей требует…»)
 
Нет описания правки
 
(не показано 5 промежуточных версий 1 участника)
Строка 1: Строка 1:
[[UserSide_API_Key_EN|en]] | [[UserSide_API_Key|ru]]
Для функционирования '''[[API]]''' ERP "UserSide" и взаимодействия внешних [[Модули|модулей]] требуется API-ключ.
Для функционирования '''[[API]]''' ERP "UserSide" и взаимодействия внешних [[Модули|модулей]] требуется API-ключ.
Ключ - абсолютно произвольная текстовая строка, но она не может быть пустой.
Ниже указана настройка API-ключа.
== С версии 3.18 и выше ==
В основном файле конфигурации ''[USERSIDE_DIRECTORY]/userside3/main/config/config.php'' добавьте ''(или настройте)'' переменную $apiKeyArray, где можете настроить доступ по ключам и IP-адресам. Также можно указать конкретные наименования секций API, что разрешается использовать с этим ключом.
$apiKeyArray = [
    [
        'key' => 'mainKey',
        'ip' => '*'
    ],
    [
        'key' => 'key-local',
        'ip' => '127.0.0.1',
        'section' => [
            'customer',
            'node'
        ]
    ]
];
IP-адреса нужно указывать в текстовом виде. "*" - означает использование любого IP-адреса. Если требуется для одного ключа использовать несколько IP-адресов - то добавляйте новые элементы массива. Например:
$apiKeyArray = [
    [
        'key' => 'mainKey',
        'ip' => '*'
    ],
    [
        'key' => 'key-local',
        'ip' => '127.0.0.1'
    ],
    [
        'key' => 'key-local',
        'ip' => '192.168.0.1',
        'section' => [
            'customer',
            'node'
        ]
    ],
    [
        'key' => 'key-local',
        'ip' => '192.168.0.50',
        'section' => [
            'task',
            'node'
        ]
    ]
];
== Для версии 3.17 ==
В основном файле конфигурации ''[USERSIDE_DIRECTORY]/userside3/main/config/config.php'' добавьте ''(или настройте)'' переменную $apiKeyArray, где можете настроить доступ по ключам и IP-адресам.
$apiKeyArray = [
    [
        'key' => 'mainKey',
        'ip' => '*'
    ],
    [
        'key' => 'key-local',
        'ip' => '127.0.0.1'
    ]
];
IP-адреса нужно указывать в текстовом виде. "*" - означает использование любого IP-адреса. Если требуется для одного ключа использовать несколько IP-адресов - то добавляйте новые элементы массива. Например:
$apiKeyArray = [
    [
        'key' => 'mainKey',
        'ip' => '*'
    ],
    [
        'key' => 'key-local',
        'ip' => '127.0.0.1'
    ],
    [
        'key' => 'key-local',
        'ip' => '192.168.0.1'
    ],
    [
        'key' => 'key-local',
        'ip' => '192.168.0.50'
    ]
];
== Для версий до 3.17 ==
В основном файле конфигурации ''[USERSIDE_DIRECTORY]/userside3/main/config/config.php'' добавьте ''(или настройте)'' переменную $zapikey, где впишите свой ключ.
$zapikey = 'key';

Текущая версия от 15:14, 30 октября 2023

en | ru

Для функционирования API ERP "UserSide" и взаимодействия внешних модулей требуется API-ключ.

Ключ - абсолютно произвольная текстовая строка, но она не может быть пустой.

Ниже указана настройка API-ключа.

С версии 3.18 и выше

В основном файле конфигурации [USERSIDE_DIRECTORY]/userside3/main/config/config.php добавьте (или настройте) переменную $apiKeyArray, где можете настроить доступ по ключам и IP-адресам. Также можно указать конкретные наименования секций API, что разрешается использовать с этим ключом.

$apiKeyArray = [
   [
       'key' => 'mainKey',
       'ip' => '*'
   ],
   [
       'key' => 'key-local',
       'ip' => '127.0.0.1',
       'section' => [
           'customer',
           'node'
       ]
   ]
];

IP-адреса нужно указывать в текстовом виде. "*" - означает использование любого IP-адреса. Если требуется для одного ключа использовать несколько IP-адресов - то добавляйте новые элементы массива. Например:

$apiKeyArray = [
   [
       'key' => 'mainKey',
       'ip' => '*'
   ],
   [
       'key' => 'key-local',
       'ip' => '127.0.0.1'
   ],
   [
       'key' => 'key-local',
       'ip' => '192.168.0.1',
       'section' => [
           'customer',
           'node'
       ]
   ],
   [
       'key' => 'key-local',
       'ip' => '192.168.0.50',
       'section' => [
           'task',
           'node'
       ]
   ]
];

Для версии 3.17

В основном файле конфигурации [USERSIDE_DIRECTORY]/userside3/main/config/config.php добавьте (или настройте) переменную $apiKeyArray, где можете настроить доступ по ключам и IP-адресам.

$apiKeyArray = [
   [
       'key' => 'mainKey',
       'ip' => '*'
   ],
   [
       'key' => 'key-local',
       'ip' => '127.0.0.1'
   ]
];

IP-адреса нужно указывать в текстовом виде. "*" - означает использование любого IP-адреса. Если требуется для одного ключа использовать несколько IP-адресов - то добавляйте новые элементы массива. Например:

$apiKeyArray = [
   [
       'key' => 'mainKey',
       'ip' => '*'
   ],
   [
       'key' => 'key-local',
       'ip' => '127.0.0.1'
   ],
   [
       'key' => 'key-local',
       'ip' => '192.168.0.1'
   ],
   [
       'key' => 'key-local',
       'ip' => '192.168.0.50'
   ]
];

Для версий до 3.17

В основном файле конфигурации [USERSIDE_DIRECTORY]/userside3/main/config/config.php добавьте (или настройте) переменную $zapikey, где впишите свой ключ.

$zapikey = 'key';