إضافة مصادقة 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 IAP الآمن

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

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