Tiện ích xác thực của Google

Lấy mã truy cập

Trong ví dụ sau, thao tác getOauth2AccessToken của tiện ích sẽ truy xuất một mã thông báo để sử dụng trong các yêu cầu gửi đến 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>

Giá trị phản hồi sẽ có dạng như sau:

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

Chính sách AssignMessage sau đây sẽ truy xuất giá trị phản hồi từ chính sách ExtensionCallout và sao chép giá trị đó vào tải trọng phản hồi. Điều này có thể hữu ích khi gỡ lỗi. Trong thực tế, bạn có thể không muốn trả lại mã thông báo cho ứng dụng.

<?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>

Lưu mã truy cập vào bộ nhớ đệm

Để tránh thực hiện các lệnh gọi không cần thiết để truy xuất mã thông báo, hãy cân nhắc việc lưu mã thông báo mà bạn nhận được vào bộ nhớ đệm. Đối với các lệnh gọi tiếp theo yêu cầu mã thông báo, việc truy xuất mã thông báo từ bộ nhớ đệm Apigee Edge sẽ nhanh hơn so với việc lấy mã thông báo mới. Khi mã thông báo được lưu vào bộ nhớ đệm hết hạn, hãy truy xuất mã thông báo mới và làm mới bộ nhớ đệm bằng mã thông báo đó.

Đoạn mã sau đây trong một proxy API mẫu minh hoạ cách thiết lập và sử dụng mã thông báo được lưu vào bộ nhớ đệm để gọi Google Translation API bằng chính sách ServiceCallout. Mỗi ví dụ về mã ở đây là cho một chính sách khác nhau trong quy trình.

Các chính sách sau đây được thực thi theo trình tự được mô tả bằng XML luồng sau đây:

  <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. Chính sách LookupCache sau đây sẽ cố gắng lấy mã thông báo từ bộ nhớ đệm. Nếu mã thông báo đã được lấy và lưu vào bộ nhớ đệm, thì chính sách này sẽ lấy mã thông báo đó để sử dụng bằng proxy API.

     <?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. Nếu quá trình tra cứu bộ nhớ đệm không truy xuất được mã thông báo đã lưu vào bộ nhớ đệm, thì chính sách ExtensionCallout sau đây sẽ truy xuất một mã thông báo OAuth mới, chỉ định Google Cloud Translation API làm phạm vi cho mã thông báo. Google Cloud sẽ trả về một mã thông báo hợp lệ nếu thông tin xác thực tài khoản dịch vụ được dùng khi định cấu hình tiện ích Google-Auth-Callout đại diện cho một thành viên dự án có quyền truy cập vào API.

     <?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. Sau khi chính sách ExtensionCallout truy xuất một mã thông báo mới, chính sách PopulateCache sẽ lưu mã thông báo đó vào bộ nhớ đệm để các chính sách trong proxy API sử dụng sau này.

     <?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>
   

Cú pháp

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

Ví dụ:

Trong ví dụ sau, thao tác getOauth2AccessToken của tiện ích sẽ truy xuất một mã thông báo để sử dụng trong các yêu cầu gửi đến Cloud Translation API.

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

Cú pháp

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

Ví dụ: URL của Cloud Functions

Trong ví dụ sau, thao tác getOauth2AccessToken của tiện ích sẽ truy xuất một mã thông báo để sử dụng trong các yêu cầu gửi đến Cloud Translation API.

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

Ví dụ: Mã ứng dụng được bảo mật bằng IAP trên đám mây

Trong ví dụ sau, thao tác getOauth2AccessToken của tiện ích sẽ truy xuất một mã thông báo để sử dụng trong các yêu cầu gửi đến Cloud Translation API.

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