Pull to refresh
0

Cackle — единый вход

Reading time2 min
Views8.3K
В этой статье расскажем про единую аутентификацию, которая может быть полезна сайтам с уже имеющейся базой зарегистрированных пользователей.

Единый вход (Single Sign-On) позволяет существующим пользователям сайта оставлять комментарии через виджет Cackle от имени учетной записи пользователя на сайте без необходимости авторизации в виджете с помощью социальной сети (OAuth) или OpenID провайдера.


Как это происходит?


Для настройки единой авторизации в код виджета добавляется переменная mcSSOAuth, значение которой есть зашифрованные данные пользователя и секретный ключ виджета. В случае успешной верификации ключа данные сохраняются в системе, а сам пользователь авторизуется.
Значение переменной должно формироваться на сервере и быть равно:

<JSON данные пользователя в Base64><пробел><MD5 подпись запроса><пробел><текущее время в секундах>


JSON данные пользователя включают в себя следующие атрибуты:
  • id — уникальный идентификатор пользователя
  • name — имя пользователя
  • email (необязательное) — адрес электронной почты
  • avatar (необязательное) — ссылка на аватар
  • www (необязательное) — ссылка на веб сайт

MD5 подпись запроса формируется как:
md5(<JSON данные пользователя в Base64><текущее время в секундах>)


Site API Key - уникальный идентификатор виджета для работы с API. Его можно получить в панели администрирования на вкладке "Виджет", снизу выбрав WordPress плагин.

Выход

Для выхода пользователя, вместо JSON данных пользователя, нужно передавать пустую JSON строчку {}.

Пример использования


К примеру вы администратор ресурса www.example.org. На вашем сайте зарегистрирован пользователь Freeman. Вы хотите, чтобы Freeman мог оставлять комментарии через виджет Cackle под своим аккаунтом, без повторного входа. В этом случае нужно настроить единую аутентификацию, после чего Freeman и все остальные пользователи смогут комментировать от своих собственных учетных записей.

Все что нужно сделать - это сформировать массив с данными пользователя Freeman из нашей БД:
Допустим его id - 7, email - freeman@example.org, avatar - example.org/freeman.png, Site API Key виджета - 123456789, а функция is_user_logged_in() в нашей системе проверяет залогинен ли пользователь.

function cackle_auth(){ $timestamp = time(); $siteApiKey = 123456789; if (is_user_logged_in()){ $user = array( 'id' => '7', 'name' => 'Freeman', 'email' => 'freeman@example.org', 'avatar' => 'http://example.org/freeman.png' ); $user_data = base64_encode(json_encode($user)); } else{ $user = '{}'; $user_data = base64_encode($user); } $sign = md5($user_data . $siteApiKey . $timestamp); return "$user_data $sign $timestamp"; }

Функция cackle_auth возвращает строку, которую необходимо поместить в то место, где находится код виджета:
<script type="text/javascript">
    var mcSSOAuth = '<?php echo cackle_auth(); ?>';
    // код виджета
</script>


Кстати говоря, в новой версии плагина для WordPress, единая авторизация уже реализована. Вы можете включить её выставив галочку в настройках.
Tags:
Hubs:
Total votes 7: ↑5 and ↓2+3
Comments13

Articles

Information

Website
cackle.me
Registered
Founded
Employees
2–10 employees
Location
Россия