Cloud Phone:FAQ about the Cloud Phone API

Index

• How do I enable authorization-free logon for my cloud phone?

• Which SDK packages are required for the authentication API operations?

• What are the authentication-related API operations for Alibaba Cloud Workspace?

• Is there a runnable Java demo available?

How do I enable authorization-free logon for my cloud phone?

To enable authorization-free logon, submit a ticket and provide the UID of your Alibaba Cloud account.

Which SDK packages are required for the authentication API operations?

The following SDK packages are required for the authentication API operations:

• GetAuthCode - Obtains the authentication code

  The required SDK package is appstream_center20210218. If Cloud Phone SDK for Java is used, add the following dependencies to Project Object Model (POM):

  <dependency>
   <groupId>com.aliyun</groupId>
   <artifactId>appstream_center20210218</artifactId>
   <version>1.0.4</version>
  </dependency>

• GetStsToken - Obtains the temporary access credentials

  The required SDK package is appstream_center20210220. If Cloud Phone SDK for Java is used, add the following dependencies to POM:

  <dependency>
   <groupId>com.aliyun</groupId>
   <artifactId>appstream_center20210220</artifactId>
   <version>1.2.0</version>
  </dependency>

• GetConnectionTicket - Obtains a connection ticket

  The required SDK package is appstream_center20210903. If Cloud Phone SDK for Java is used, add the following dependencies to POM:

  <dependency>
   <groupId>com.aliyun</groupId>
   <artifactId>appstream_center20210903</artifactId>
   <version>1.0.4</version>
  </dependency>

What are the authentication-related API operations for Alibaba Cloud Workspace?

The following API operations are used for Alibaba Cloud Workspace authentication:

• GetAuthCode - Obtains the authentication code

  This operation is called on the server side by using AccessKeyID, AccessKeySecret, or other RAM authentication methods. Since AccessKeyID and AccessKeySecret should never be stored on the client side, ensure this operation is not called from the client side.

• GetStsToken - Obtains the temporary access credentials

  This operation is called on the client side.

• GetConnectionTicket - Obtains a connection ticket

  This operation is called on the client side.

Is there a runnable Java demo available?

We offer a straightforward server-side demo for your reference.

Download it here: demo1_authcode.zip.

Procedure:

1. Update the following fields in the application.properties configuration file:

• Replace service.sdk.accessKeyId with the AccessKey ID of your Alibaba Cloud account.

• Replace service.sdk.accessSecret with the AccessKey Secret of your Alibaba Cloud account.

• Replace service.deploy.region with the region where the server code is deployed.

spring.application.name=demo1

logging.config=classpath:log4j2-file.xml

service.sdk.accessKeyId=<YourAccessKeyId>
service.sdk.accessSecret=<YourAccessKeySecret>

# service.deploy.region
service.deploy.region=<YourRegion>

sdk.appstream.center.endpoint=appstream-center.aliyuncs.com

2. Run the main function to start the server locally.

3. Run the curl command to perform a test locally.

Replace <EndUserId> with the username of your convenience account.

curl -X POST http://localhost:8080/auth -H "Content-Type: application/json" -d '{"userId":"<EndUserId>", "requestId":12345678}'