Что такое токен?
Для вызова методов API из сред с низким уровнем доверия (смартфонов и браузеров) Fleet Engine требует использования JSON Web Tokens (JWT).
JWT-токен создается на вашем сервере, подписывается, шифруется и передается клиенту для последующих взаимодействий с сервером до тех пор, пока не истечет срок его действия или он не перестанет быть действительным.
Ключевые детали
- Используйте учетные данные приложения по умолчанию для аутентификации и авторизации в Fleet Engine.
- Для подписи JWT используйте соответствующую учетную запись службы. См. раздел «Роли учетных записей служб Fleet Engine» в руководстве «Основы работы с Fleet Engine» .
Для получения дополнительной информации о JSON Web Tokens см. раздел «JSON Web Tokens» в руководстве Fleet Engine Essentials .
Как клиенты получают токены?
После того как водитель или пользователь войдет в ваше приложение, используя соответствующие учетные данные авторизации, любые обновления, выпущенные с этого устройства, должны использовать соответствующие токены авторизации, которые передают Fleet Engine информацию о разрешениях для приложения.
Как разработчик, вы должны обеспечить возможность выполнения следующих действий в клиентской части:
- Получите JSON Web Token с вашего сервера.
- Используйте токен повторно до истечения срока его действия, чтобы свести к минимуму количество обновлений токена.
- Обновите токен по истечении срока его действия.
Класс AuthTokenFactory генерирует токены авторизации во время обновления местоположения. SDK должен упаковать токены вместе с информацией об обновлении для отправки в Fleet Engine. Убедитесь, что ваша серверная реализация может выдавать токены, прежде чем инициализировать SDK.
Подробную информацию об ожидаемых сервисом Fleet Engine токенах см. в разделе «Выдача JSON Web Tokens для Fleet Engine».
Пример программы для получения авторизационного токена.
Вот примерная реализация AuthTokenFactory :
class JsonAuthTokenFactory implements AuthTokenFactory {
private String vehicleServiceToken; // initially null
private long expiryTimeMs = 0;
private String vehicleId;
// This method is called on a thread whose only responsibility is to send
// location updates. Blocking is OK, but just know that no location updates
// can occur until this method returns.
@Override
public String getToken(AuthTokenContext authTokenContext) {
String vehicleId = requireNonNull(context.getVehicleId());
if (System.currentTimeMillis() > expiryTimeMs || !vehicleId.equals(this.vehicleId)) {
// The token has expired, go get a new one.
fetchNewToken(vehicleId);
}
return vehicleServiceToken;
}
private void fetchNewToken(String vehicleId) {
String url = "https://yourauthserver.example/token/" + vehicleId;
try (Reader r = new InputStreamReader(new URL(url).openStream())) {
com.google.gson.JsonObject obj
= com.google.gson.JsonParser.parseReader(r).getAsJsonObject();
vehicleServiceToken = obj.get("VehicleServiceToken").getAsString();
expiryTimeMs = obj.get("TokenExpiryMs").getAsLong();
// The expiry time could be an hour from now, but just to try and avoid
// passing expired tokens, we subtract 10 minutes from that time.
expiryTimeMs -= 10 * 60 * 1000;
this.vehicleId = vehicleId;
} catch (IOException e) {
// It's OK to throw exceptions here. The StatusListener you passed to
// create the DriverContext class will be notified and passed along the failed
// update warning.
throw new RuntimeException("Could not get auth token", e);
}
}
}
В данной конкретной реализации используется встроенный в Java HTTP-клиент для получения токена в формате JSON от сервера авторизации. Клиент сохраняет токен для повторного использования и повторно получает его, если до истечения срока действия старого токена остается менее 10 минут.
В вашей реализации могут использоваться другие методы, например, фоновый поток для обновления токенов.
Список доступных клиентских библиотек для Fleet Engine см. в разделе «Клиентские библиотеки для служб запланированных задач» .