अनुमति वाले टोकन पाएं

टोकन क्या होता है?

Fleet Engine को JSON Web Token (JWT) इस्तेमाल करने की ज़रूरत होती है. ऐसा इसलिए, ताकि कम भरोसेमंद एनवायरमेंट (जैसे कि स्मार्टफ़ोन और ब्राउज़र) से एपीआई के तरीके को कॉल किया जा सके.

JWT आपके सर्वर पर बनता है. इस पर हस्ताक्षर किया जाता है, इसे एन्क्रिप्ट (सुरक्षित) किया जाता है, और क्लाइंट को भेजा जाता है. ऐसा तब तक होता है, जब तक यह खत्म नहीं हो जाता या मान्य नहीं रहता.

मुख्य जानकारी

JSON वेब टोकन के बारे में ज़्यादा जानने के लिए, Fleet Engine Essentials में JSON वेब टोकन देखें.

क्लाइंट को टोकन कैसे मिलते हैं?

जब कोई ड्राइवर या खरीदार, अनुमति से जुड़े सही क्रेडेंशियल का इस्तेमाल करके आपके ऐप्लिकेशन में लॉग इन करता है, तो उस डिवाइस से जारी किए गए किसी भी अपडेट के लिए, अनुमति से जुड़े सही टोकन का इस्तेमाल करना ज़रूरी है. इससे Fleet Engine को ऐप्लिकेशन की अनुमतियों के बारे में पता चलता है.

डेवलपर के तौर पर, आपके क्लाइंट के लागू किए गए कोड में ये काम करने की सुविधा होनी चाहिए:

  • अपने सर्वर से JSON वेब टोकन फ़ेच करें.
  • टोकन को तब तक फिर से इस्तेमाल करें, जब तक उसकी समयसीमा खत्म नहीं हो जाती. इससे टोकन रीफ़्रेश करने की ज़रूरत कम हो जाती है.
  • टोकन की समयसीमा खत्म होने पर, उसे रीफ़्रेश करें.

AuthTokenFactory क्लास, जगह की जानकारी अपडेट करने के समय अनुमति देने वाले टोकन जनरेट करती है. एसडीके को टोकन को अपडेट की जानकारी के साथ पैकेज करना होगा, ताकि उन्हें Fleet Engine को भेजा जा सके. पक्का करें कि सर्वर-साइड पर लागू किया गया आपका कोड, एसडीके शुरू करने से पहले टोकन जारी कर सकता हो.

Fleet Engine सेवा के लिए ज़रूरी टोकन के बारे में जानने के लिए, Fleet Engine के लिए JSON Web Token जारी करना लेख पढ़ें.

ऑथराइज़ेशन टोकन फ़ेचर का उदाहरण

यहां 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 एचटीटीपी क्लाइंट का इस्तेमाल किया जाता है. इससे ऑथराइज़ेशन सर्वर से JSON फ़ॉर्मैट में टोकन फ़ेच किया जाता है. क्लाइंट, टोकन को फिर से इस्तेमाल करने के लिए सेव करता है. साथ ही, अगर पुराना टोकन 10 मिनट के अंदर खत्म होने वाला है, तो क्लाइंट टोकन को फिर से फ़ेच करता है.

आपका लागू किया गया तरीका, कुछ काम अलग तरीके से कर सकता है. जैसे, टोकन को रीफ़्रेश करने के लिए बैकग्राउंड थ्रेड का इस्तेमाल करना.

Fleet Engine के लिए उपलब्ध क्लाइंट लाइब्रेरी के बारे में जानने के लिए, मांग पर यात्रा की सेवाएं देने वाली कंपनियों के लिए क्लाइंट लाइब्रेरी देखें.

आगे क्या करना है

Driver SDK को शुरू करना