รับโทเค็นการให้สิทธิ์

โทเค็นคืออะไร

สําหรับการเรียกใช้เมธอด API จากสภาพแวดล้อมที่มีระดับความน่าเชื่อถือต่ำ Fleet Engine จะกำหนดให้ใช้ JSON Web Token (JWT) ที่ลงนามโดยบัญชีบริการที่เหมาะสม สภาพแวดล้อมที่มีระดับความน่าเชื่อถือต่ำ ได้แก่ สมาร์ทโฟนและเบราว์เซอร์ JWT สร้างขึ้นจากเซิร์ฟเวอร์ของคุณ ซึ่งเป็นสภาพแวดล้อมที่เชื่อถือได้ทั้งหมด JWT จะได้รับการลงนาม เข้ารหัส และส่งไปยังไคลเอ็นต์สำหรับการโต้ตอบของเซิร์ฟเวอร์ในครั้งต่อๆ ไปจนกว่าไฟล์จะหมดอายุหรือใช้งานไม่ได้อีกต่อไป

แบ็กเอนด์ของคุณควรตรวจสอบสิทธิ์และให้สิทธิ์กับ Fleet Engine โดยใช้กลไกข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันมาตรฐาน อย่าลืมใช้ JWT ที่ลงนามโดยบัญชีบริการที่เหมาะสม ดูรายการบทบาทบัญชีบริการได้ที่บทบาทบัญชีบริการ Fleet Engine ในข้อมูลพื้นฐานของ Fleet Engine

ในทางกลับกัน แบ็กเอนด์ควรตรวจสอบสิทธิ์และให้สิทธิ์กับ Fleet Engine โดยใช้กลไกข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันมาตรฐาน

ดูข้อมูลเพิ่มเติมเกี่ยวกับโทเค็นเว็บ JSON ได้ที่โทเค็นเว็บ JSON ใน Fleet Engine Essentials

ลูกค้าจะได้รับโทเค็นได้อย่างไร

เมื่อคนขับหรือผู้บริโภคเข้าสู่ระบบแอปของคุณโดยใช้ข้อมูลเข้าสู่ระบบการให้สิทธิ์ที่เหมาะสม การอัปเดตใดๆ ที่ออกจากอุปกรณ์นั้นต้องใช้โทเค็นการให้สิทธิ์ที่เหมาะสม ซึ่งจะสื่อสารกับ Fleet Engine เกี่ยวกับสิทธิ์สำหรับแอป

ในฐานะนักพัฒนาซอฟต์แวร์ การใช้งานของลูกค้าควรช่วยให้ทำสิ่งต่อไปนี้ได้

• เรียก JSON Web Token จากเซิร์ฟเวอร์ของคุณ
• ใช้โทเค็นซ้ำจนกว่าจะหมดอายุเพื่อลดการรีเฟรชโทเค็น
• โปรดรีเฟรชโทเค็นเมื่อหมดอายุ

คลาส AuthTokenFactory จะสร้างโทเค็นการให้สิทธิ์เมื่อถึงเวลาอัปเดตตำแหน่ง SDK ต้องสร้างแพ็กเกจโทเค็นที่มีข้อมูลอัปเดตเพื่อส่งไปยัง Fleet Engine โปรดตรวจสอบว่าการใช้งานฝั่งเซิร์ฟเวอร์สามารถออกโทเค็นก่อนที่จะเริ่มต้น SDK

โปรดดูรายละเอียดโทเค็นที่บริการ Fleet Engine คาดไว้ที่หัวข้อออกโทเค็นเว็บ JSON สำหรับ 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 ได้ที่หัวข้อไลบรารีของไคลเอ็นต์สำหรับบริการงานที่กำหนดเวลาไว้

ขั้นตอนถัดไป

เริ่มต้น Driver SDK