biblio-docs/user-key.md

Как сгенерировать user_key?

Формирование user_key (примеры на php)

Ключ пользователя формируется из массива параметров, которые позволяют однозначно идентифицировать пользователя внутри системы Biblio.

Массив имеет следующий вид:

$ident_array = [
	'type' => 'email',
	'ident' => 'username@mail.ru'
];

В качестве type в ident массиве могут выступать следующие значения:

• email – электронная почта (предпочтительно)
• phone – номер телефона (в международном формате, без + в начале номера)
• google_id – идентификатор пользователя у google
• vk_id – идентификатор пользователя в Вконтакте
• apple_id – идентификатор пользователя в apple id (не email apple id, а именно идентификатор)
• tg_id – идентификатор пользователя в Telegram
• fb_id – идентификатор пользователя в Facebook

Необходимо указать свой ключ реферала:

$referal_key = 'YOUR_REFERAL_KEY';

Далее массив преобразовывается в base64 строку, которая используется в качестве user_key в виджете.

Алгоритм преобразования следующий:

$source_string = json_encode($ident_array);
$ivlen = openssl_cipher_iv_length($cipher = 'AES-256-CBC');
$iv = mb_substr($referal_key, 0, $ivlen);
$key = mb_substr($referal_key, 10, 35);
$raw = openssl_encrypt($source_string, $cipher, $key, OPENSSL_RAW_DATA, $iv);
$hmac = hash_hmac('sha25', $raw, $key, true);
$user_key = base64_encode($hmac.$raw);

Контрольные значения для проверки алгоритма

Вводные данные:

$ident_array = [
	'type' => 'email',
	'ident' => 'username@mail.ru'
];
$referal_key = 'YOUR_REFERAL_KEY';

Итоговый ключ:

o91Gup4bGZ11hjsBbIvimOiv5Lg+5kcgfsSoQ9YkPcPB5f/mkYJIo7Tp0TI6piG/lO3aQSeszOzgG05dl8PH3Cyc2J63vJ6slFL0LFV6jhs=