Получить токены авторизации

Что такое токен?

Fleet Engine требует использования JSON Web Tokens (JWT) для вызовов методов API из сред с низким уровнем доверия : смартфонов и браузеров.

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 см. в разделе Клиентские библиотеки для служб запланированных задач .

Что дальше?

Инициализируйте SDK драйвера