अनुमति देने वाले टोकन

Google, कॉलर की पुष्टि करने के लिए, बियरर टोकन (JWT: RFC 7519) जारी करता है. इससे यह पुष्टि होती है कि कॉलर के पास किसी संसाधन को एन्क्रिप्ट या डिक्रिप्ट करने की अनुमति है.

गलत इस्तेमाल को रोकने के लिए, Key Access Control List Service (KACLS) को यह पुष्टि करनी चाहिए कि कॉलर के पास किसी ऑब्जेक्ट (फ़ाइल या दस्तावेज़) को एन्क्रिप्ट करने की अनुमति है. यह पुष्टि, कुंजी को रैप करने से पहले की जानी चाहिए. साथ ही, DEK को अनरैप करने से पहले, उसे डिक्रिप्ट करने की पुष्टि भी की जानी चाहिए.

Google Docs और Google Drive, Google Calendar, और Google Meet की क्लाइंट-साइड एन्क्रिप्शन (सीएसई) सुविधा के लिए अनुमति देने वाला टोकन

JSON के काेड में दिखाना
{
  "aud": string,
  "delegated_to": string,
  "email": string,
  "email_type": string,
  "exp": string,
  "iat": string,
  "iss": string,
  "kacls_url": string,
  "perimeter_id": string,
  "resource_name": string,
  "role": string
}
फ़ील्ड
aud

string

ऑडियंस, जिसकी पहचान Google करता है. इसकी पुष्टि, लोकल कॉन्फ़िगरेशन के हिसाब से की जानी चाहिए.

delegated_to

string

(ज़रूरी नहीं) उस उपयोगकर्ता का ईमेल पता जिसके पास संसाधन को ऐक्सेस करने की अनुमति है.

email

string (UTF-8)

उपयोगकर्ता का ईमेल पता.

email_type

string

इसमें इनमें से कोई एक वैल्यू होती है:

  • google: यह ईमेल, Google खाते से जुड़ा है.
  • google-visitor: यह ईमेल, Google खाते से जुड़ा नहीं है. हालांकि, Google ने पिन कोड की मदद से इसकी पुष्टि की है.
  • customer-idp: यह ईमेल, Google खाते से जुड़ा नहीं है. हालांकि, उपयोगकर्ता का ईमेल, ग्राहक के कॉन्फ़िगर किए गए IdP का इस्तेमाल करके निकाला गया है.
  • दावे को अनसेट किया जा सकता है. ऐसा करने पर, डिफ़ॉल्ट वैल्यू `google` होती है.
exp

string

समाप्ति समय.

iat

string

जारी करने का समय.

iss

string

टोकन जारी करने वाला. इसकी पुष्टि, पुष्टि करने वाले भरोसेमंद लोगों के सेट के हिसाब से की जानी चाहिए.

kacls_url

string

कॉन्फ़िगर किया गया बेस KACLS यूआरएल. इसका इस्तेमाल, मैन-इन-द-मिडल (पीआईटीएम) हमलों को रोकने के लिए किया जाता है.

perimeter_id

string (UTF-8)

(ज़रूरी नहीं) दस्तावेज़ की जगह से जुड़ी एक वैल्यू. इसका इस्तेमाल, यह चुनने के लिए किया जा सकता है कि अनरैप करते समय, किस पेरिमीटर की जांच की जाएगी. ज़्यादा से ज़्यादा साइज़: 128 बाइट.

resource_name

string (UTF-8)

DEK से एन्क्रिप्ट किए गए ऑब्जेक्ट के लिए एक आइडेंटिफ़ायर. ज़्यादा से ज़्यादा साइज़: 128 बाइट.

role

string

इसमें इनमें से कोई एक वैल्यू होती है:

  • reader: सिर्फ़ unwrap को कॉल करने की अनुमति होती है.
  • writer: wrap और unwrap, दोनों को कॉल करने की अनुमति होती है

Gmail की सीएसई (क्लाइंट-साइड एन्क्रिप्शन) सुविधा के लिए अनुमति देने वाला टोकन

JSON के काेड में दिखाना
{
  "aud": string,
  "email": string,
  "exp": string,
  "iat": string,
  "message_id": string,
  "iss": string,
  "kacls_url": string,
  "perimeter_id": string,
  "resource_name": string,
  "role": string,
  "spki_hash": string,
  "spki_hash_algorithm": string
}
फ़ील्ड
aud

string

ऑडियंस, जिसकी पहचान Google करता है. इसकी पुष्टि, लोकल कॉन्फ़िगरेशन के हिसाब से की जानी चाहिए.

email

string (UTF-8)

उपयोगकर्ता का ईमेल पता.

exp

string

समाप्ति समय.

iat

string

जारी करने का समय.

message_id

string

उस मैसेज के लिए एक आइडेंटिफ़ायर जिस पर डिक्रिप्शन या साइनिंग की जाती है. इसका इस्तेमाल, ऑडिट के मकसद से क्लाइंट की वजह के तौर पर किया जाता है.

iss

string

टोकन जारी करने वाला. इसकी पुष्टि, पुष्टि करने वाले भरोसेमंद लोगों के सेट के हिसाब से की जानी चाहिए.

kacls_url

string

कॉन्फ़िगर किया गया बेस KACLS यूआरएल. इसका इस्तेमाल, मैन-इन-द-मिडल (पीआईटीएम) हमलों को रोकने के लिए किया जाता है.

perimeter_id

string (UTF-8)

(ज़रूरी नहीं) दस्तावेज़ की जगह से जुड़ी एक वैल्यू. इसका इस्तेमाल, यह चुनने के लिए किया जा सकता है कि अनरैप करते समय, किस पेरिमीटर की जांच की जाएगी. ज़्यादा से ज़्यादा साइज़: 128 बाइट.

resource_name

string (UTF-8)

DEK से एन्क्रिप्ट किए गए ऑब्जेक्ट के लिए एक आइडेंटिफ़ायर. ज़्यादा से ज़्यादा साइज़: 512 बाइट.

role

string

इसमें इनमें से कोई एक वैल्यू होती है:

  • decrypter: डिक्रिप्ट कर सकता है.
  • signer: साइन कर सकता है.
spki_hash

string

ऐक्सेस की जा रही निजी कुंजी के DER-एन्कोड किए गए SubjectPublicKeyInfo का स्टैंडर्ड base64-एन्कोड किया गया डाइजेस्ट.

spki_hash_algorithm

string

spki_hash बनाने के लिए इस्तेमाल किया गया एल्गोरिदम. यह हो सकता है SHA-256.

KACLS माइग्रेशन सेवा के लिए अनुमति देने वाला टोकन

JSON के काेड में दिखाना
{
  "aud": string,
  "email": string,
  "exp": string,
  "iat": string,
  "iss": string,
  "kacls_url": string,
  "resource_name": string,
  "role": string
}
फ़ील्ड
aud

string

ऑडियंस, जिसकी पहचान Google करता है. इसकी पुष्टि, लोकल कॉन्फ़िगरेशन के हिसाब से की जानी चाहिए.

email

string (UTF-8)

उपयोगकर्ता का ईमेल पता.

exp

string

समाप्ति समय.

iat

string

जारी करने का समय.

iss

string

टोकन जारी करने वाला. इसकी पुष्टि, पुष्टि करने वाले भरोसेमंद लोगों के सेट के हिसाब से की जानी चाहिए.

kacls_url

string

कॉन्फ़िगर किया गया बेस KACLS यूआरएल. इसका इस्तेमाल, मैन-इन-द-मिडल (पीआईटीएम) हमलों को रोकने के लिए किया जाता है.

role

string

इसमें इनमें से कोई एक वैल्यू होती है:

  • migrator: सिर्फ़ rewrap को कॉल करने की अनुमति होती है.
  • verifier: सिर्फ़ digest को कॉल करने की अनुमति होती है.