6  /  36

Серверное локальное приложение без интерфейса в Битрикс24

Просмотров: 3251 (Статистика ведётся с 06.02.2017)

Установка

Пример состоит из одного PHP-файла, который вы должны разместить на своем веб-сервере до добавления приложения в свой Битрикс24. Приложение умеет получать авторизацию пользователя Битрикс24 и используя ее, находясь при этом вне Битрикс24, обращаться к REST API, получая ФИО текущего пользователя.

Скачать архив:

Для установки локального приложения нужно перейти по цепочке: Приложения 1 - Добавить приложение 2 - Добавить приложение 3:

Нажмите на рисунок, чтобы увеличить

В открывшейся форме заполнить базовые поля и указать необходимые для приложения права (для нашего примера нужны права на управление пользователями), указав URL приложения (это означает, что ваше приложение уже должно быть физически доступно по URL по протоколу HTTPS до того, как вы станете добавлять его в ваш Битрикс24)

Необходимо включить опцию Приложение использует только API - именно она указывает Битрикс24, что ваше приложение не будет показывать пользовательский интерфейс внутри Битрикс24. В этом случае, как вы увидите, в форме будут скрыты поля, в которых обычно указывается название пункта меню для вызова приложения из Битрикс24. Приложения, у которых включена опция "Приложение использует только API" либо предоставляют пользовательский интерфейс по какому-то своему URL, либо вообще не предоставляют пользовательский интерфейс:

Нажмите на рисунок, чтобы увеличить

После сохранения вы останетесь в форме добавления приложения, но Битрикс24 вам сразу покажет ключи авторизации для протокола OAuth 2.0, которые вам потребуются внутри кода приложения:

Поскольку приложение без интерфейса работает "вне" Битрикс24, то оно должно реализовывать полный протокол авторизации OAuth 2.0. Откройте код примера и замените константы с кодом приложения 1 и секретным ключом 2 полученными при сохранении формы. Не забудьте также указать точный URL, по которому вы будете размещать пример:

Нажмите на рисунок, чтобы увеличить

Загрузите измененный пример на свой сервер.

В Битрикс24 можно перейти в список "Мои приложения" и убедиться в появлении нового приложения в списке локальных приложений в вашем Битрикс24:

Нажмите на рисунок, чтобы увеличить

Использование

Откройте пример в браузере по вашему URL:

Приложение должно получить авторизацию пользователя Битрикс24, для этого введите адрес своего Битрикс24 и нажмите кнопку. Произойдет редирект на ваш Битрикс24. Если в этот момент вы уже авторизованы в нем, то автоматически произойдет обратный редирект на URL приложения. Если не авторизованы, то сначала Битрикс24 предложит вам ввести логин и пароль и только в случае правильной авторизации, перенаправит вас обратно на URL приложения.

Запущенное приложение выведет отладочную информацию о процессе получения авторизации , а также ФИО текущего пользователя, получая его по REST API с использованием этих авторизационных данных.


0
Курсы разработаны в компании «1С-Битрикс»

Если вы нашли неточность в тексте, непонятное объяснение, пожалуйста, сообщите нам об этом в комментариях.
Развернуть комментарии