إضافة مصادقة 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 رمزًا مميزًا جديدًا، تخزّنه سياسة تعبئة ذاكرة التخزين المؤقت مؤقتًا لاستخدامها لاحقًا من خلال السياسات في الخادم الوكيل لواجهة برمجة التطبيقات.

     <?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 لدالة السحابة الإلكترونية

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

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

مثال: معرّف العميل الآمن للشراء داخل التطبيق في السحابة الإلكترونية

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

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