Obtain a token using an SDK

Java

Add the Maven dependencies. The example uses nls-sdk-common 2.1.6. JAXB API is also required to run the example on JDK 21.

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

Call apply() to send the request. Then call getToken() and getExpireTime() to retrieve the token and expiration time. This request class does not automatically refresh tokens on a schedule.

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"),
                "nls-meta.cn-shanghai.aliyuncs.com",
                "cn-shanghai", "2019-02-28");

        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);
    }
}

C++

Download the C++ Token SDK and extract the package. It contains headers, examples, and libraries for Linux and Windows. Environment requirements:

• Linux: Glibc 2.5 or later and GCC 4 or GCC 5.

• Windows: Visual Studio 2013 or Visual Studio 2015. Create a project and configure the library references.

Add the extracted include directory to the header search path and configure the SDK libraries and dependencies for the target platform. Extract the Linux libraries from lib/linux.tar.gz. The Linux example links against alibabacloud-idst-common, jsoncpp, ssl, crypto, curl, and uuid. For example, compile with the following command and replace path/to/NlsCommonSdk with the actual extraction path:

g++ -D_GLIBCXX_USE_CXX11_ABI=0 tokenDemo.cpp \
  -I path/to/NlsCommonSdk/include \
  -L path/to/NlsCommonSdk/lib/linux \
  -lalibabacloud-idst-common -ljsoncpp -lssl -lcrypto -lcurl -luuid \
  -o tokenDemo

At runtime, add path/to/NlsCommonSdk/lib/linux to LD_LIBRARY_PATH so that the shared libraries can be loaded.

The code reads AccessKey credentials from environment variables. No credentials are required as command-line arguments.

#include <cstdlib>
#include <iostream>
#include "Token.h"

int main() {
    const char* accessKeyId = std::getenv("ALIYUN_AK_ID");
    const char* accessKeySecret = std::getenv("ALIYUN_AK_SECRET");
    if (!accessKeyId || !accessKeySecret) {
        std::cerr << "Set ALIYUN_AK_ID and ALIYUN_AK_SECRET." << std::endl;
        return 1;
    }

    AlibabaNlsCommon::NlsToken request;
    request.setAccessKeyId(accessKeyId);
    request.setKeySecret(accessKeySecret);
    if (request.applyNlsToken() == -1) {
        std::cerr << request.getErrorMsg() << std::endl;
        return 1;
    }

    const char* token = request.getToken();
    unsigned int expireTime = request.getExpireTime();

    std::cout << "Token acquired: " << (token != NULL && token[0] != '\0') << std::endl;
    std::cout << "ExpireTime (Unix seconds): " << expireTime << std::endl;
    return 0;
}

Java

Add the Maven dependencies. The example uses aliyun-java-sdk-core 3.7.1 and fastjson 1.2.83. JDK 21 also requires 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(
                "cn-shanghai", System.getenv("ALIYUN_AK_ID"),
                System.getenv("ALIYUN_AK_SECRET"));
        DefaultAcsClient client = new DefaultAcsClient(profile);

        CommonRequest request = new CommonRequest();
        request.setDomain("nls-meta.cn-shanghai.aliyuncs.com");
        request.setVersion("2019-02-28");
        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

Install the dependency. The example uses aliyun-python-sdk-core 2.15.1.

pip install aliyun-python-sdk-core

import 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"],
    "cn-shanghai",
)

request = CommonRequest()
request.set_method("POST")
request.set_protocol_type("https")
request.set_domain("nls-meta.cn-shanghai.aliyuncs.com")
request.set_version("2019-02-28")
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

Install the dependency in a Go module. The example uses alibaba-cloud-sdk-go 1.63.107.

go get github.com/aliyun/alibaba-cloud-sdk-go/sdk

package 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("cn-shanghai", sdk.NewConfig(), credential)
    if err != nil {
        panic(err)
    }

    request := requests.NewCommonRequest()
    request.Scheme = "HTTPS"
    request.Method = "POST"
    request.Domain = "nls-meta.cn-shanghai.aliyuncs.com"
    request.ApiName = "CreateToken"
    request.Version = "2019-02-28"
    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

Use PHP 7.2 or later and install the dependency with Composer. The example uses alibabacloud/sdk 1.8.2345 and alibabacloud/client 1.5.32.

composer require alibabacloud/sdk

This example uses the SDK's ROA request wrapper with API version 2018-05-18 and request path /pop/2018-05-18/tokens. This version differs from the RPC API version. Do not mix parameters from the two request styles.

<?php
require __DIR__ . '/vendor/autoload.php';

use AlibabaCloud\Client\AlibabaCloud;

AlibabaCloud::accessKeyClient(
    getenv('ALIYUN_AK_ID'), getenv('ALIYUN_AK_SECRET'))
    ->regionId('cn-shanghai')
    ->asDefaultClient();

$response = AlibabaCloud::nlsCloudMeta()
    ->v20180518()
    ->createToken()
    ->scheme('https')
    ->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

Install the dependency. The example uses @alicloud/pop-core 1.8.0.

npm install @alicloud/pop-core

const { RPCClient } = require('@alicloud/pop-core');

const client = new RPCClient({
  accessKeyId: process.env.ALIYUN_AK_ID,
  accessKeySecret: process.env.ALIYUN_AK_SECRET,
  endpoint: 'https://nls-meta.cn-shanghai.aliyuncs.com',
  apiVersion: '2019-02-28',
});

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;
});