إضافة مصادقة 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 Function

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

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

مثال: رقم تعريف العميل المحميّ باستخدام Cloud IAP

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

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