=====Авторизация через социальные сети=====

В системе предусмотрена возможность авторизировать абонентов в личный кабинет через социальные сети.

Для включения авторизации нужно прописать в личном кабинете параметры социальной сети и настроить взаимодействие с ней. Регистрация доступа через социальную сеть производится в меню **Пароль** портала абонента.

При регистрации пользователя в системе также можно указать параметры социальной сети.

У администратора также появляется возможность получить публичную информацию из социальных сетей для зарегистрированных абонентов

Перед включением нужно завести дополнительные поля для социальных сетей с типом **SOCIAL NETWORK** и следующими названиями полей

  VK        - vk
  Facebook  - facebook
  Google    - google
  Instagram - instagram
  Twitter   - twitter
  
После добавления поля, система изменит название поля на _vk  _facebook и так далее.

Опции

^$conf{auth_debug}=1| Лог авторизации через социальные сети. Данные записываются в var/log/auth.log |


====VK====
Настройка

https://new.vk.com/dev

{{:abills:docs:manual:social_network:vk_reg.png?nolink|регистрация ВК}}

^$conf{AUTH_VK_ID}='51121121'; | ID приложения |
^$conf{AUTH_VK_SECRET}='KHJHKHKUIOqQ8764784'; | Пароль |
^$conf{AUTH_VK_URL}='%SELF_URL%?external_auth=Vk'; | Страница возврата |


====Facebook====

регистрация сервиса https://developers.facebook.com/

настройка Facebook

{{:abills:docs:manual:social_network:fb_reg.png?nolink|регистрация сервиса}}

Обязательно укажите Сalback URL, адрес, куда возращает пользователя после регистрации.

''https:/ /Ваш.сервер:9443/index.cgi?external_auth=Facebook''
{{ :abills:docs:manual:social_network:facebook.png?nolink |}}




^$conf{AUTH_FACEBOOK_ID}='XXXXXXXXXXXXXX'; | ID приложения |
^$conf{AUTH_FACEBOOK_SECRET}='secret'; | Пароль |
^$conf{AUTH_FACEBOOK_URL}='%SELF_URL%?external_auth=Facebook'; | Страница возврата |


=== Импорт данных ===
[[abills:docs:manual:admin:facebook_users_info|Импорт данных с Facebook]]

=== Автоматическая регистрация ===
[[abills:docs:manual:admin:facebook_registration|Регистрация через Facebook]]

==== Google ====
1. Войдите в консоль управления. [[https://console.developers.google.com/apis/credentials| Консоль API ]]

2. Отредактируйте вид окна запроса аутентификации.
{{ :abills:docs:manual:social_network:1.png?nolink |}}


3. Создайте OAuth Client ID для OAuth.\\
В поле **Разрешенные URI перенаправления** вставьте сылку на страницу входа в портал абонента c параметром ''?external_auth=Google''. Например: ''https://example.host.com/index.cgi?external_auth=Google''\\
{{ :abills:docs:manual:social_network:2.png?nolink |}}

5. Для получения информации абонента в интерфейсе администратора необходимо указать ключ API. Создать ключ можно в [[https://console.developers.google.com/apis/credentials| Консоли API ]]. 
Тип ключа (Сервер). Обязательно укажите IP адрес с которого будут идти запросы, для предотвращения кражи ключа.

4. Полученные даные сохраните в ''libexec/config.pl''
^$conf{AUTH_GOOGLE_ID}='923595536840-fr2us6nc9haf0tcg4runc9evopcrvemj.apps.googleusercontent.com'; | ID приложения |
^$conf{AUTH_GOOGLE_SECRET}='lJE8......-......-...KHKB'; | Пароль |
^$conf{AUTH_GOOGLE_URL}='%SELF_URL%?external_auth=Google'; | Страница возврата |
^$conf{GOOGLE_API_KEY}='AIzaSyD...........q2NYemE'; | Ключ авторизации запросов к Google API |
====Instagram====
1) Войдите в консоль управленя [[ https://www.instagram.com/developer/clients/manage/|Instagram API ]]

2) Нажмите кнопку ''Register new client''

{{:abills:docs:manual:social_network:register_new_client.png?600|}}

3) В нем мы задаем нужные нам параметры

{{:abills:docs:manual:social_network:client_info.png?600|}}

4) Нажимаем кнопку ''Register'' и видимо окошко с данными нашего приложения.

{{:abills:docs:manual:social_network:client_usefull_info.png?600|}}

Теперь идем в **config.pl** и прописываем нужные параметры:

^$conf{AUTH_INSTAGRAM_ID}='384775b167304d5e9da87a44352789c4'; | параметр Client ID|
^$conf{AUTH_INSTAGRAM_SECRET}='9f2313e7a5a34f199cd6ad4c33cc5906'; | параметр Client secret |
^$conf{AUTH_INSTAGRAM_URL}='%SELF_URL%?external_auth=Instagram'; | параметр Redirec URI |


==== Twitter ====
Создаем дополнение на https://apps.twitter.com/

{{:abills:docs:manual:social_network:twitter.png?600|}}

Заносим данные приложения в ''libexec/config.pl''
^$conf{AUTH_TWITTER_ID}='XXXXXXXXXXXXXXXXXXXXXXX'; | Consumer Key (API Key)|
^$conf{AUTH_TWITTER_SECRET}='XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'; | Consumer Secret (API Secret) |
^$conf{AUTH_TWITTER_URL}='%SELF_URL%?external_auth=Twitter'; | callback url |