Реализация OAuth в Яндексе
Сервисы Яндекса авторизуют приложения по токенам по протоколу OAuth 2.0. Каждый токен — это цифро-буквенная последовательность, в которой зашифрована следующая информация:
-
идентификатор учетной записи, к которой разрешен доступ;
-
идентификатор приложения, которому разрешен доступ;
-
набор прав (действий, доступных приложению).
Ниже описаны общие правила использования OAuth-токенов Яндекса.
Процедура авторизации
Приложения запрашивают токены по следующей схеме:
-
Приложение направляет пользователя на OAuth-сервер. На открывшейся странице он может разрешить приложению доступ к запрошенным данным своей учетной записи. Приложение может запросить права доступа, указанные при регистрации приложения:
- Все права доступа, указанные при регистрации приложения. В этом случае пользователь может разрешить или запретить только все запрошенные доступы сразу.
- Только необходимые в данный момент права доступа из перечня, определенного при регистрации приложения. В этом случае пользователь также может разрешить или запретить только все запрошенные доступы сразу.
- Необходимые в данный момент права доступа из перечня, определенного при регистрации приложения, и опциональные права из того же перечня, без которых можно обойтись. Опциональным может являться, например, доступ к портрету. В этом случае пользователь может разрешить все запрошенные необходимые доступы сразу и выбрать, какие из запрошенных опциональных доступов разрешить.
-
Пользователь разрешает доступ к своим данным, и OAuth-сервер перенаправляет его на выбранный разработчиком адрес — Redirect URI.
Выданный токен или код для его получения включается в URL перенаправления. Если произошла ошибка, в URL включается описание ошибки.
-
Приложение включает полученный токен в запрос к сервису Яндекса, который поддерживает OAuth.
Полученный токен можно сохранить в приложении и использовать для запросов до истечения времени его жизни.
Время жизни токена
Время жизни токена — это срок, в течение которого токен можно использовать для авторизации. Максимальное время жизни зависит от прав, выбранных при регистрации приложения:
- Продлеваемый токен
-
Устаревает после нескольких месяцев, но продлевается при каждой авторизации с этим токеном.
При регистрации приложения отображается минимальное время жизни, например,
не менее, чем 1 год
. - Ограниченный токен
-
Устаревает по истечении времени, установленного для соответствующих прав доступа.
Если при регистрации приложения было выбрано несколько таких прав, для токена выбирается наименьшее ограничение времени жизни.
Отзыв токена
Пользователь может отзывать любые OAuth-токены, выданные для его аккаунта:
- Чтобы отозвать токены, когда-либо выданные для учетной записи, пользователь может сменить пароль или выйти на всех компьютерах.
- Чтобы отозвать токены, выданные определенному приложению, пользователь может запретить доступ для него на странице Управление доступом.
Приложение может отозвать собственный токен, если он был выдан для определенного устройства.
Все случаи отзыва токенов перечислены на странице Отзыв токенов.
Пользовательский интерфейс
Страница, на которой пользователь может разрешить доступ приложению (первый шаг авторизации), содержит название приложения и список запрашиваемых прав:
Когда пользователь подтверждает вход, OAuth-сервер перенаправляет его на адрес, указанный в качестве Redirect URI.