bitrix-social-auth

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #typescript #android #rust #deep-learning #linux #docker #nodejs #windows #awesome #mcp

bitrix-social-auth

(★ 12)

Bitrix auth social network adapter

bitrix-social-auth Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## Bitrix Social Auth

init.php:
```php
use Dbogdanoff\Bitrix\Auth\Auth;
use Dbogdanoff\Bitrix\Auth\Adapter;

try {
    Auth::addAdapter(new Adapter\Vk([
        'client_id' => '123456',
        'client_secret' => 'xxxxxxxxxx'
    ]));
    Auth::addAdapter(new Adapter\Fb([
        'client_id' => '123456',
        'client_secret' => 'xxxxxxxxxx'
    ]));
    Auth::addAdapter(new Adapter\Google([
        'client_id' => '123456',
        'client_secret' => 'xxxxxxxxxx'
    ]));
    Auth::addAdapter(new Adapter\Github([
        'client_id' => '123456',
        'client_secret' => 'xxxxxxxxxx'
    ]));
    Auth::addAdapter(new Adapter\Telegram([
        'client_id' => 'yourbotname_bot',
        'client_secret' => 'API Token'
    ]));
    Auth::addAdapter(new Adapter\Ok([
        'client_id' => '123456',
        'client_secret' => 'xxxxxxxxxx',
        'client_pub_key' => 'yyyyyyyyyy'         
    ]));
}
catch (\Exception $e) {
    /*
     * Все мы прекрасно понимаем, что вывод в init.php – плохо, 
     * но это пример и вы можете вынести весь этот код куда вам удобно, например в компонент
     * Но я прамо так и использую :) 
     * Класс .adapter-error у меня position: fixed прилипает к верху экрана
     */
    echo '<div class="adapter-error">' . $e->getMessage() . '</div>';
}
```

Вариант публичной части:
```php
<ul class="auth__list">
  <?php
  /** @var \Dbogdanoff\Bitrix\Auth\Adapter\Adapter[] $adapters */
  $adapters = \Dbogdanoff\Bitrix\Auth\Auth::getAdapters();
  ?>
  <li class="auth__item">
    <a class="auth__link" href="<?=$adapters['Facebook']->getAuthUrl()?>">
      <svg class="auth__icon" width="20" height="20">
        <use xlink:href="#facebook"></use>
      </svg>
    </a>
  </li>
  <li class="auth__item">
    <a class="auth__link" href="<?=$adapters['VKontakte']->getAuthUrl()?>">
      <svg class="auth__icon" width="22" height="22">
        <use xlink:href="#vk"></use>
      </svg>
    </a>
  </li>
  ...
</ul>
```

### Телеграм особенности
Авторизация через телеграм реализована посредством виджета, поэтому его использование отличается от других и имеется ряд ограничений, например, нельзя стилизовать как нам хочется.\
Также не будет полноценно работать метод Telegram::getAuthUrl(), вместо него надо использовать\
`echo Telegram::getButton(string $selector, string $size = 'large', string $redirect = '/')`,\
который в качестве первого арумента принимает селектор в DOM куда на js будет вставлен виджет (кнопка) авторизации.\
Метод Telegram::getButton() возвращает строку подключения виджета и стоить иметь ввиду, что кнопка появится не в месте вызова метода, а в DOM, в указанном в первом аргументе селекторе.

## Requirements

Bitrix Social Auth requires the following:

- PHP 7.0.0+
- [1C-Bitrix 14.0.0+](https://www.1c-bitrix.ru/)

## Installation

Bitrix Social Auth is installed via [Composer](https://getcomposer.org/).
To [add a dependency](https://getcomposer.org/doc/04-schema.md#package-links>) to bitrix-social-auth in your project, either

Run the following to use the latest stable version
```sh
    composer require denx-b/bitrix-social-auth
```

You can of course also manually edit your composer.json file
```json
{
    "require": {
       "denx-b/bitrix-social-auth": "1.5.*"
    }
}
```

## Свои адаптеры

Для создания нового адаптера необходимо создать класс и наследовать его от абстрактного класса [\Dbogdanoff\Bitrix\Auth\Adapter\Adapter](https://github.com/denx-b/bitrix-social-auth/blob/master/src/Bitrix/Auth/Adapter/Adapter.php)

Класс имеет 5 абстрактных методов, которые необходимо реализовать и 3 вспомогательные константы:
```php
/**
 * Название соц. сети.
 * Чаще всего используется для вывода в публичной части
 *
 * @var string
 */
const NAME = '';

/**
 * ID соц. сети в системе Bitrix.
 * Используется в поле EXTERNAL_AUTH_ID таблицы b_socialservices_user
 *
 * @var string
 */
const ID = '';

/**
 * Префикс для генерации логина.
 *
 * @var string
 */
const LOGIN_PREFIX = '';

/**
 * Возвращает адрес куда надо отправить пользователя для разрешения запрошенных прав.
 *
 * @param array $state
 * @return mixed
 */
abstract public function getAuthUrl(array $state = []): string;

/**
 * Получение токена.
 *
 * @return array
 * @throws \Exception
 */
abstract protected function getToken(): array;

/**
 * Время жизни токена
 *
 * @return int
 */
abstract protected function getTokenExpires(): int;

/**
 * Запрос на получение информации о пользователе.
 *
 * @param $token
 * @return array
 */
abstract protected function getUserInfo($token): array;

/**
 * Принимает массив с метода getUserInfo
 * Должен вернуть массив с ключами для таблицы b_user
 *
 * @param array $userInfo
 * @return array
 */
abstract protected function getUserFields(array $userInfo): array;
```

Это собственно и всё, что потребуется для создания новых адаптеров. \
Для наглядности можно посмотреть [пример](https://github.com/denx-b/bitrix-social-auth/blob/master/src/Bitrix/Auth/Adapter/Google.php) уже созданного адаптера.\
Буду всеми рукам за, если вы предложите новые адаптеры для других соц. сетей.

bitrix-social-auth

bitrix-social-auth Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

bitrix-social-auth

bitrix-social-auth Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README