إضافة مصادقة Google

الحصول على رمز الدخول

في المثال التالي، يستردّ الإجراء getOauth2AccessToken في الإضافة رمزًا مميّزًا لاستخدامه في الطلبات المرسَلة إلى Cloud Translation API.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Get-Access-Token">
    <DisplayName>Get Access Token</DisplayName>
    <Connector>google-auth</Connector>
    <Action>getOauth2AccessToken</Action>
    <Input><![CDATA[{
      "scope" : [
        "https://www.googleapis.com/auth/cloud-translation"
      ]
    }]]></Input>
    <Output>google.credentials</Output>
</ConnectorCallout>

تبدو قيمة الاستجابة على النحو التالي:

{
  "access_token":"ya29.c.ElpSB...BMgkALBJ0kou-8",
  "token_type":"Bearer",
  "expiresInSec": 3600
}

تسترجع سياسة AssignMessage التالية قيمة الاستجابة من سياسة ExtensionCallout أعلاه وتنسخها في الحمولة البرمجية للاستجابة. يمكن أن يكون ذلك مفيدًا لتصحيح الأخطاء. في الممارسة العملية، قد لا تريد إعادة الرمز المميّز إلى العميل.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Retrieve-Auth-Token">
    <DisplayName>Retrieve Auth Token</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <Set>
        <Payload contentType="application/json">{google.credentials.access_token}</Payload>
    </Set>
</AssignMessage>

تخزين رمز دخول في ذاكرة التخزين المؤقت

لتجنُّب إجراء مكالمات غير ضرورية لاسترداد رمز مميّز، ننصحك بتخزين الرمز المميّز الذي تتلقّاه في ذاكرة التخزين المؤقت. بالنسبة إلى الطلبات اللاحقة التي تتطلّب رمزًا مميّزًا، سيكون استرداد الرمز المميّز من ذاكرة التخزين المؤقت في Apigee Edge أسرع من الحصول على رمز مميّز جديد. عند انتهاء صلاحية الرمز المميّز المخزّن مؤقتًا، استرجع رمزًا مميّزًا جديدًا وأعِد تحميل ذاكرة التخزين المؤقت به.

يوضّح الرمز البرمجي التالي من مثال على وكيل واجهة برمجة التطبيقات كيفية ضبط رمز مميّز مخزّن مؤقتًا واستخدامه لاستدعاء Google Translation API باستخدام سياسة ServiceCallout. يُستخدَم كل مثال رمز هنا لسياسة مختلفة في العملية.

يتم تنفيذ السياسات التالية بالترتيب الموضّح في ملف XML التالي الخاص بالمسار:

  <Request>
    <!-- Attempt to get a token from the cache. -->
    <Step>
        <Name>Get-Cached-Auth-Token</Name>
    </Step>
    <!-- Only execute the following ExtensionCallout policy if the call to the
      cache couldn't retrieve a cached token. -->
    <Step>
        <Name>Google-Auth-Callout</Name>
        <Condition>lookupcache.Get-Cached-Auth-Token.cachehit is false</Condition>
    </Step>
    <!-- Only execute the following PopulateCache policy if the call to the
      cache couldn't retrieve a cached token. -->
    <Step>
        <Name>Cache-Auth-Token</Name>
        <Condition>lookupcache.Get-Cached-Auth-Token.cachehit is false</Condition>
    </Step>
    <!-- Use the ServiceCallout policy to call the translate API. -->
    <Step>
        <Name>Translate-Text</Name>
    </Step>
</Request>

1. تحاول سياسة LookupCache التالية الحصول على رمز مميّز من ذاكرة التخزين المؤقت. إذا سبق الحصول على الرمز المميّز وتخزينه مؤقتًا، ستحصل هذه السياسة عليه لاستخدامه من قِبل الوكيل لواجهة برمجة التطبيقات.

     <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
     <LookupCache async="false" continueOnError="false" enabled="true" name="Get-Cached-Auth-Token">
         <DisplayName>Get Cached Auth Token</DisplayName>
         <!-- Give cache key and scope to specify the entry for the cached token. -->
         <CacheKey>
             <Prefix/>
             <KeyFragment>gcp_translate_token_</KeyFragment>
         </CacheKey>
         <Scope>Exclusive</Scope>
         <!-- Assign the retrieved token (if any) to a variable, where it
          can be retrieved by policies. -->
         <AssignTo>cloud.translation.auth.token</AssignTo>
     </LookupCache>
   

2. إذا لم يُعِد البحث في ذاكرة التخزين المؤقت رمزًا مميّزًا محفوظًا في ذاكرة التخزين المؤقت، ستسترجع سياسة ExtensionCallout التالية رمزًا مميّزًا جديدًا لبروتوكول OAuth، مع تحديد Google Cloud Translation API كنطاق الرمز المميّز. تعرِض Google Cloud رمز ترويجي صالحًا إذا كانت بيانات اعتماد حساب الخدمة المستخدَمة عند ضبط إضافة Google-Auth-Callout تمثّل عضوًا في المشروع لديه إذن الوصول إلى واجهة برمجة التطبيقات.

     <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
     <ConnectorCallout async="false" continueOnError="true" enabled="true" name="Google-Auth-Callout">
         <DisplayName>Google-Auth-Callout</DisplayName>
         <Connector>example-auth-extension</Connector>
         <Action>getOauth2AccessToken</Action>
         <Input><![CDATA[{
           "scope" : ["https://www.googleapis.com/auth/cloud-translation"]
         }]]></Input>
         <Output parsed="false">cloud.translation.auth.token</Output>
     </ConnectorCallout>
   

3. بعد أن تستردّ سياسة ExtensionCallout رمزًا مميزًا جديدًا، تخزّنه سياسة PopulateCache لتتمكّن السياسات في الوكيل لواجهة برمجة التطبيقات من استخدامه لاحقًا.

     <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
     <PopulateCache async="false" continueOnError="false" enabled="true" name="Cache-Auth-Token">
         <DisplayName>Cache Auth Token</DisplayName>
         <Properties/>
         <!-- Set cache key information to specify a unique key for this entry. -->
         <CacheKey>
             <Prefix/>
             <KeyFragment>gcp_translate_token_</KeyFragment>
         </CacheKey>
         <Scope>Exclusive</Scope>
         <ExpirySettings>
             <TimeoutInSec>5</TimeoutInSec>
         </ExpirySettings>
         <!-- Get the token to cache from the variable where the ExtensionCallout put it. -->
         <Source>cloud.translation.auth.token</Source>
     </PopulateCache>
   

البنية

<Action>getOauth2AccessToken</Action>
<Input><![CDATA[{
  "scope" : [
    "scope1",
    "scope2"
  ]
}]]></Input>

مثال

في المثال التالي، يستردّ الإجراء getOauth2AccessToken في الإضافة رمزًا مميّزًا لاستخدامه في الطلبات المرسَلة إلى Cloud Translation API.

<Action>getOauth2AccessToken</Action>
<Input><![CDATA[{
    "scope" : [
      "https://www.googleapis.com/auth/cloud-translation"
  ]
}]]></Input>

البنية

<Action>getJWTAccessToken</Action>
<Input><![CDATA[{
    "audience" : "audience"
}]]></Input>

مثال: عنوان URL لدالة Cloud

في المثال التالي، يستردّ الإجراء getOauth2AccessToken في الإضافة رمزًا مميّزًا لاستخدامه في الطلبات المرسَلة إلى Cloud Translation API.

<Action>getJWTAccessToken</Action>
<Input><![CDATA[{
  "audience" : "https://YOUR_REGION-YOUR_PROJECT_ID.cloudfunctions.net/FUNCTION_NAME"
}]]></Input>

مثال: رقم تعريف العميل الذي تم تأمينه من خلال Cloud Identity Access Protocol

في المثال التالي، يستردّ الإجراء getOauth2AccessToken في الإضافة رمزًا مميّزًا لاستخدامه في الطلبات المرسَلة إلى Cloud Translation API.

<Action>getJWTAccessToken</Action>
<Input><![CDATA[{
  "audience" : "Cloud-IAP-secured-client-ID"
}]]></Input>