在服務端通過 SDK 擷取 Token,可避免在移動端應用中儲存長期 AccessKey。SDK 封裝請求籤名,應用負責儲存 Token、檢查有效期間並在到期前重新擷取。
背景資訊
按專案使用的 SDK 選擇一種擷取方式,無需同時整合兩種 SDK。
擷取方式 | 適用情境 |
Intelligent Speech Interaction SDK | 已整合相應 SDK,使用封裝的 Token 請求類。 |
阿里雲公用 SDK | 使用公用 SDK 調用 |
配置訪問憑證
準備已開通Intelligent Speech Interaction服務的帳號及具有要求的權限的 AccessKey ID 和 AccessKey Secret。服務開通和憑證準備方法,請參見快速開始。
擷取 Token 使用的是 AccessKey,不是百鍊 API Key。將 AccessKey 配置到運行樣本的進程環境中:ALIYUN_AK_ID 對應 AccessKey ID,ALIYUN_AK_SECRET 對應 AccessKey Secret。
AccessKey 僅儲存在可信的服務端環境,不寫入原始碼或移動端應用。移動端調用Voice Messaging Service前,先向商務服務端請求 Token。樣本只輸出擷取結果和到期時間,不輸出 Token 本身;不要將 AccessKey、Token 或帶簽名的完整請求寫入日誌。
通過Intelligent Speech Interaction SDK 擷取 Token
Java
添加 Maven 依賴。樣本使用 nls-sdk-common 2.1.6;在 JDK 21 下運行時,還需添加 JAXB API 依賴。
<dependency>
<groupId>com.alibaba.nls</groupId>
<artifactId>nls-sdk-common</artifactId>
<version>2.1.6</version>
</dependency>
<dependency>
<groupId>javax.xml.bind</groupId>
<artifactId>jaxb-api</artifactId>
<version>2.3.1</version>
</dependency>調用 apply() 發起請求,再讀取 getToken() 和 getExpireTime()。此請求類不會自動定時重新整理 Token。
import com.alibaba.nls.client.AccessToken;
public class NlsTokenDemo {
public static void main(String[] args) throws Exception {
AccessToken request = new AccessToken(
System.getenv("ALIYUN_AK_ID"),
System.getenv("ALIYUN_AK_SECRET"),
"nlsmeta.ap-southeast-1.aliyuncs.com",
"ap-southeast-1", "2019-07-17");
request.apply();
String token = request.getToken();
long expireTime = request.getExpireTime();
System.out.println("Token acquired: " + (token != null && !token.isEmpty()));
System.out.println("ExpireTime (Unix seconds): " + expireTime);
}
}通過阿里雲公用 SDK 擷取 Token
公用 SDK 的 RPC 請求使用以下參數。網域名稱、地區和 API 版本需配套使用,不能只修改其中一項。
參數 | 配置值 | 說明 |
|
| 擷取 Token 的網域名稱。 |
|
| 請求地區。 |
|
| 介面名稱。 |
|
| RPC API 版本。 |
Java
添加 Maven 依賴。樣本使用 aliyun-java-sdk-core 3.7.1 和 fastjson 1.2.83;JDK 21 還需 JAXB API 2.3.1。
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-core</artifactId>
<version>3.7.1</version>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>1.2.83</version>
</dependency>
<dependency>
<groupId>javax.xml.bind</groupId>
<artifactId>jaxb-api</artifactId>
<version>2.3.1</version>
</dependency>import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
import com.aliyuncs.CommonRequest;
import com.aliyuncs.CommonResponse;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.http.MethodType;
import com.aliyuncs.http.ProtocolType;
import com.aliyuncs.profile.DefaultProfile;
public class CreateTokenDemo {
public static void main(String[] args) throws Exception {
DefaultProfile profile = DefaultProfile.getProfile(
"ap-southeast-1", System.getenv("ALIYUN_AK_ID"),
System.getenv("ALIYUN_AK_SECRET"));
DefaultAcsClient client = new DefaultAcsClient(profile);
CommonRequest request = new CommonRequest();
request.setDomain("nlsmeta.ap-southeast-1.aliyuncs.com");
request.setVersion("2019-07-17");
request.setAction("CreateToken");
request.setMethod(MethodType.POST);
request.setProtocol(ProtocolType.HTTPS);
CommonResponse response = client.getCommonResponse(request);
JSONObject result = JSON.parseObject(response.getData()).getJSONObject("Token");
String token = result.getString("Id");
long expireTime = result.getLongValue("ExpireTime");
System.out.println("Token acquired: " + (token != null && !token.isEmpty()));
System.out.println("ExpireTime (Unix seconds): " + expireTime);
}
}Python
安裝依賴。樣本使用 aliyun-python-sdk-core 2.15.1。
pip install aliyun-python-sdk-coreimport json
import os
from aliyunsdkcore.client import AcsClient
from aliyunsdkcore.request import CommonRequest
client = AcsClient(
os.environ["ALIYUN_AK_ID"],
os.environ["ALIYUN_AK_SECRET"],
"ap-southeast-1",
)
request = CommonRequest()
request.set_method("POST")
request.set_protocol_type("https")
request.set_domain("nlsmeta.ap-southeast-1.aliyuncs.com")
request.set_version("2019-07-17")
request.set_action_name("CreateToken")
result = json.loads(client.do_action_with_exception(request))
token = result["Token"]["Id"]
expire_time = result["Token"]["ExpireTime"]
print("Token acquired:", bool(token))
print("ExpireTime (Unix seconds):", expire_time)Go
在 Go 模組中安裝依賴。樣本使用 alibaba-cloud-sdk-go 1.63.107。
go get github.com/aliyun/alibaba-cloud-sdk-go/sdkpackage main
import (
"encoding/json"
"fmt"
"os"
"github.com/aliyun/alibaba-cloud-sdk-go/sdk"
"github.com/aliyun/alibaba-cloud-sdk-go/sdk/auth/credentials"
"github.com/aliyun/alibaba-cloud-sdk-go/sdk/requests"
)
func main() {
credential := credentials.NewAccessKeyCredential(
os.Getenv("ALIYUN_AK_ID"), os.Getenv("ALIYUN_AK_SECRET"))
client, err := sdk.NewClientWithOptions("ap-southeast-1", sdk.NewConfig(), credential)
if err != nil {
panic(err)
}
request := requests.NewCommonRequest()
request.Scheme = "HTTPS"
request.Method = "POST"
request.Domain = "nlsmeta.ap-southeast-1.aliyuncs.com"
request.ApiName = "CreateToken"
request.Version = "2019-07-17"
response, err := client.ProcessCommonRequest(request)
if err != nil {
panic(err)
}
var result struct {
Token struct {
Id string
ExpireTime int64
}
}
if err := json.Unmarshal(response.GetHttpContentBytes(), &result); err != nil {
panic(err)
}
token := result.Token.Id
fmt.Println("Token acquired:", token != "")
fmt.Println("ExpireTime (Unix seconds):", result.Token.ExpireTime)
}PHP
使用 PHP 7.2 及以上版本,並通過 Composer 安裝依賴。樣本使用 alibabacloud/sdk 1.8.2345 和 alibabacloud/client 1.5.32。
composer require alibabacloud/sdk此樣本使用公用 RPC 請求,顯式設定網域名稱、API 版本和要求方法。
<?php
require __DIR__ . '/vendor/autoload.php';
use AlibabaCloud\Client\AlibabaCloud;
AlibabaCloud::accessKeyClient(
getenv('ALIYUN_AK_ID'), getenv('ALIYUN_AK_SECRET'))
->regionId('ap-southeast-1')
->asDefaultClient();
$response = AlibabaCloud::rpc()
->product('nls-cloud-meta')
->version('2019-07-17')
->action('CreateToken')
->host('nlsmeta.ap-southeast-1.aliyuncs.com')
->scheme('https')
->method('POST')
->request();
$token = $response['Token']['Id'];
$expireTime = $response['Token']['ExpireTime'];
echo 'Token acquired: ' . (!empty($token) ? 'true' : 'false') . PHP_EOL;
echo 'ExpireTime (Unix seconds): ' . $expireTime . PHP_EOL;Node.js
安裝依賴。樣本使用 @alicloud/pop-core 1.8.0。
npm install @alicloud/pop-coreconst { RPCClient } = require('@alicloud/pop-core');
const client = new RPCClient({
accessKeyId: process.env.ALIYUN_AK_ID,
accessKeySecret: process.env.ALIYUN_AK_SECRET,
endpoint: 'https://nlsmeta.ap-southeast-1.aliyuncs.com',
apiVersion: '2019-07-17',
});
async function main() {
const result = await client.request('CreateToken', {}, { method: 'POST' });
const token = result.Token.Id;
const expireTime = result.Token.ExpireTime;
console.log('Token acquired:', Boolean(token));
console.log('ExpireTime (Unix seconds):', expireTime);
}
main().catch((error) => {
console.error('CreateToken failed:', error.code || error.name);
process.exitCode = 1;
});傳回值與使用建議
公用 SDK 請求成功後,從響應的 Token 對象讀取以下欄位;NLS Java 請求類通過對應方法返回這些值。
欄位 | 類型 | 說明 |
| String | Token 字串,用於後續Voice Messaging Service請求。NLS Java 對應 |
| Long | 到期時間的 Unix 時間戳記,單位為秒。NLS Java 對應 |
緩衝 Token 並在有效期間內複用,不必在每次Voice Messaging Service請求前重新擷取。根據返回的
ExpireTime判斷有效期間,在到期前重新擷取並更新緩衝,不使用固定時間長度代替傳回值。在可信環境中,同一個 Token 可以供多個進程或應用使用。使用本頁配置的端點擷取 Token,不要混用上海和新加坡端點簽發的 Token。
將
Id字串傳給Voice Messaging Service,不傳整個 JSON 響應、AccessKey 或其他欄位。具體傳遞位置遵循相應語音介面的鑒權要求。
常見問題
擷取 Token 失敗時如何排查?
根據 SDK 返回的錯誤碼區分原因,不將所有鑒權錯誤都歸為 AccessKey 配對問題。
錯誤碼 | 排查方法 |
| 檢查 AccessKey ID 是否正確、是否屬於預期身份,以及複製時是否包含空格。 |
| 檢查 AccessKey ID 與 AccessKey Secret 是否配對,以及參與簽名的參數是否被修改。使用公用 SDK 構造請求,避免自行拼裝簽名。 |
| 檢查發起請求的系統時間,確保與標準時間同步。此錯誤屬於請求時間戳記問題,不等同於已經擷取的 Token 到期。 |
| 核對請求網域名稱和 API 版本,並區分 RPC 與 ROA。PHP 樣本的請求形式需與其 API 版本配套。 |
擷取 Token 後,語音介面提示 Token 無效怎麼辦?
40000001 是Voice Messaging Service調用階段的鑒權錯誤。檢查是否傳入了實際 Token 字串、是否遺漏鑒權參數、Token 是否已到期,以及 Token 的簽發端點是否與所調用的Voice Messaging Service匹配。相同錯誤碼可能對應多種原因,應結合完整錯誤資訊判斷。
出現 Not supported proxy scheme 如何處理?
檢查 http_proxy、https_proxy 及程式中設定的代理。Proxy 位址需使用 SDK 支援的協議,並確保地址、連接埠和代理服務可用。如果當前網路不需要代理,移除相關配置後重試。
相關文檔
臨時調試時,通過控制台擷取 Token,請參見通過控制台擷取Token。
需要直接建構簽章請求時,請參見通過OpenAPI擷取Token。