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ã thông báo để sử dụng trong các yêu cầu gửi đến API Dịch trên đám mây.

<?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 truy xuất giá trị phản hồi từ chính sách ExtensionCallout ở trên 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ả về 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 nhằm truy xuất mã thông báo, hãy cân nhắc lưu mã thông báo 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 nhận mã thông báo mới. Khi mã thông báo đã 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 đó.

Mã sau đây từ 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 API Dịch của Google bằng chính sách ServiceCallout. Mỗi ví dụ về mã ở đây là dành cho một chính sách khác nhau trong luồng.

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

  <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 đó để proxy API sử dụng.

     <?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 lượt tra cứu bộ nhớ đệm không truy xuất mã thông báo được lưu vào bộ nhớ đệm, thì chính sách ExtensionCallout sau đây sẽ truy xuất mã thông báo OAuth mới, chỉ định API Dịch của Google Cloud 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ã thông báo để sử dụng trong các yêu cầu gửi đến API Dịch trên đám mây.

<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 Hàm trên đám mây

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

<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 Cloud IAP

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

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