ส่วนขยายการตรวจสอบสิทธิ์ของ Google

รับโทเค็นเพื่อการเข้าถึง

ในตัวอย่างต่อไปนี้ การดำเนินการ getOauth2AccessToken ของส่วนขยายจะดึงข้อมูลโทเค็นเพื่อใช้ในคำขอไปยัง Cloud Translation API

<?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
ConnectorCallout async="false" continueOnError=">;true<" enab>led="true&q<uot; name=&q>uot;G<et-Access>-Token"<;
    Disp>layNa<meGet >Access Token/Display<Name
  >  Con<necto><rgoogle-auth/Connector
    ActiongetOauth2AccessToken/Action
    Input![CDATA[{
      "scope">< : [
 >     <  "https://www.goog<leapis.>c<om/auth/cloud-tra>nslation"
      ]
    }]]/Input
    Outputgoogle.credentials/Output
/ConnectorCallout

ค่าการตอบกลับจะมีลักษณะดังนี้

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

นโยบาย AssignMessage ต่อไปนี้จะดึงค่าการตอบกลับจากนโยบาย ExtensionCallout ด้านบนและคัดลอกค่านั้นไว้ในเพย์โหลดการตอบกลับ ซึ่งจะเป็นประโยชน์ในการแก้ไขข้อบกพร่อง ในทางปฏิบัติ คุณอาจไม่ต้องการส่งคืนโทเค็นให้กับไคลเอ็นต์

<?xml version="1.0" encoding="UTF-8&quo>t<; standalone="yes"?
AssignMessage async="false" continueOnError="fal>se&qu<ot; enabled>="true" n<ame="Re>triev<e-Auth-Token"
    DisplayNameRetrieve >Auth <Tok>en/Displa<yName
    AssignTo type="response>" createNew="false"<;/
    S>et
  <    > < Payload conte>ntType="application/json"{google.credentials.access_token}/Payload
    /Set
/AssignMessage

แคชโทเค็นการเข้าถึง

พิจารณาแคชโทเค็นที่ได้รับเพื่อหลีกเลี่ยงการเรียกใช้ที่ไม่จําเป็นเพื่อดึงข้อมูลโทเค็น สําหรับการเรียกใช้ครั้งต่อๆ ไปซึ่งต้องใช้โทเค็น การดึงข้อมูลโทเค็นจากแคช Apigee Edge จะเร็วกว่าการรับโทเค็นใหม่ เมื่อโทเค็นที่แคชไว้หมดอายุ ให้ดึงข้อมูลโทเค็นใหม่และรีเฟรชแคชด้วยโทเค็นนั้น

โค้ดต่อไปนี้จากตัวอย่างพร็อกซี API แสดงวิธีตั้งค่าและใช้โทเค็นที่แคชไว้เพื่อเรียก 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
    <    >NameGoogle-Auth-Cal<lout/>Name
    <    Conditionlookupcache.Get-Cached-Auth-Token.cachehit is f<alse/Condi>tion
<    />Step
<    !-- Only execute the following PopulateCache policy if the call to the
      cache couldn't retrieve a cached t>oken.< --
>    Step
<    >    NameCache-Au<th-To>ken/Name
<        C>onditionlookupcache.Get-Cached-Auth-Token.cachehit <is false/C>ondit<ion
 >   /S<tep
    !-- Use the ServiceCallout policy to call the translate> API.< --
>    Step
<    >    NameTransl<ate-T>ext/N<ame
 > <  /Step
/Request

1. นโยบาย LookupCache ต่อไปนี้พยายามรับโทเค็นจากแคช หากได้รับและแคชโทเค็นไว้แล้ว นโยบายนี้จะรับโทเค็นดังกล่าวเพื่อใช้โดยพร็อกซี API

     <?xml version="1.0" encoding="UTF-8&quo>t; <standalone="yes"?
     LookupCache async="false" continueOnError="false>" <enabled=&qu>ot;true" name=&q<uot;Get-Cach>ed-Auth<-Token"
         DisplayNameGet Cached Auth Token/DisplayName
         !-- >Give ca<che key >and scope t<o speci>fy the entr<y for the c>ached token. --
       <  CacheKey
    >       <  >Prefix/
         <    <>/span>KeyFragmen<tgcp_t>ranslat<e_token_/KeyFragment
         /CacheKey
         ScopeExclusive/Scope
         !-- Assign the retrieved token (i>f any) <to a var>iable, where it
          can b<e retriev>ed <by policies.> --
         AssignTocloud.translation.auth.token/AssignTo
     /LookupCache
   

2. หากการค้นหาแคชไม่ดึงข้อมูลโทเค็นที่แคชไว้ นโยบาย ExtensionCallout ต่อไปนี้จะดึงข้อมูลโทเค็น OAuth ใหม่ โดยระบุ Google Cloud Translation API เป็นขอบเขตของโทเค็น Google Cloud จะแสดงโทเค็นที่ถูกต้องหากข้อมูลเข้าสู่ระบบบัญชีบริการที่ใช้เมื่อกำหนดค่าส่วนขยาย Google-Auth-Callout แสดงถึงสมาชิกโปรเจ็กต์ที่มีสิทธิ์เข้าถึง API

     <?xml version="1.0" encoding="UTF-8&quo>t; <standalone="yes"?
     ConnectorCallout async="false" continueOnError="tr>ue"<; enabled=&>quot;true" nam<e="Goog>le-Auth<-Callout&>quot;
         DisplayNam<eGoogle-Au>th-Call<out/Di>splayName
         Conn<ectorex>ample-a<uth-e><xtension/Connector
         ActiongetOauth2AccessToken/Action
         Input![CDATA[{
           &qu><ot;sco>pe"<; : ["https://ww>w.googleapis.com/auth/cloud-<transla>tio<n"]
         }]>]/Input
         Output parsed="false"cloud.translation.auth.token/Output
     /ConnectorCallout
   

3. หลังจากที่นโยบาย ExtensionCallout ดึงข้อมูลโทเค็นใหม่แล้ว นโยบาย PopulateCache จะแคชโทเค็นไว้เพื่อให้นโยบายในพร็อกซี API นำไปใช้ภายหลัง

     <?xml version="1.0" encoding="UTF-8&quo>t; <standalone="yes"?
     PopulateCache async="false" continueOnError=">false&q<uot; enable>d="true&quo<t; name=&quo>t;Cache<-Auth-Token>"
   <      DisplayNameCache Auth Token/DisplayName
         Properties/
         !->- Set c<ache key> informatio<n to sp>ecify a uni<que key for> this entry. --
       <  CacheKey
    >       <  >Prefix/
         <    <>/span>KeyFragmen<tgcp_t>ranslat<e_token_/KeyFr>agment
       <  /Ca>cheKey
    <     S>copeExclusive/<Scope
         Exp>irySett<ings
             TimeoutInSec5/TimeoutInSec
         /ExpirySettings
         !-- Get the >token t<o cach>e from the variable where th<e Exten>sio<nCallout put i>t. --
         Sourcecloud.translation.auth.token/Source
     /PopulateCache
   

ไวยากรณ์

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

ตัวอย่าง

ในตัวอย่างต่อไปนี้ การดำเนินการ getOauth2AccessToken ของส่วนขยายจะดึงข้อมูลโทเค็นเพื่อใช้ในคำขอไปยัง Cloud Translation API

<Action>getOauth2AccessToken</Action>
<Input><![CDATA[{
    "scope" : [
      "https://www.googleapis.com/auth/cloud-trans><lation>&quot;
  ]
}]]/Input

ไวยากรณ์

<Action>getJWTAccessToken</Action>
<Input><![CDATA[{
    "audience" : &quo><t;audi>ence"
}]]/Input

ตัวอย่าง: URL ของ Cloud Function

ในตัวอย่างต่อไปนี้ การดำเนินการ getOauth2AccessToken ของส่วนขยายจะดึงข้อมูลโทเค็นเพื่อใช้ในคำขอไปยัง Cloud Translation API

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

ตัวอย่าง: รหัสไคลเอ็นต์ที่ปลอดภัยของ Cloud IAP

ในตัวอย่างต่อไปนี้ การดำเนินการ getOauth2AccessToken ของส่วนขยายจะดึงข้อมูลโทเค็นเพื่อใช้ในคำขอไปยัง Cloud Translation API

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