Certificate Management Service:Contoh API

Tinjau dokumentasi OpenAPI

Ikhtisar API menunjukkan bahwa operasi OpenAPI untuk mengkueri status aplikasi sertifikat DV adalah DescribeCertificateState. Tinjau dokumentasi tersebut untuk memahami data dan izin yang diperlukan guna memanggil API ini.

Buat RAM user dan berikan izin

Identitas

Anda dapat menggunakan akun Alibaba Cloud, pengguna Resource Access Management (RAM), atau peran RAM untuk memanggil API ini. Untuk informasi lebih lanjut mengenai perbedaan antara identitas tersebut, lihat Identitas, kredensial, dan otorisasi. Contoh ini menggunakan RAM user untuk memanggil API.

Login ke Konsol RAM, lalu buat RAM user dengan izin hanya untuk memanggil API tersebut. Catat informasi AccessKey-nya. Untuk informasi lebih lanjut, lihat Buat RAM user.

Otorisasi

1. Buka daftar RAM user. Pada kolom Actions, klik Attach Policy.

2. Pada bagian Policy, cari dan pilih kebijakan AliyunYundunCertFullAccess. Kebijakan ini memberikan akses penuh ke layanan Sertifikat Keamanan Alibaba Cloud. Klik OK untuk menyelesaikan operasi.

Kredensial

AccessKey secara otomatis dihasilkan saat Anda membuat RAM user dan dapat langsung digunakan. Alternatifnya, buka halaman detail RAM user, klik tab Authentication, lalu klik Create AccessKey untuk menghasilkan AccessKey baru. Untuk informasi lebih lanjut, lihat Buat AccessKey.

Panggil OpenAPI

Contoh ini menggunakan Java untuk menunjukkan cara memanggil OpenAPI.

Persiapkan lingkungan pengembangan Java

Persyaratan

• Unduh dan instal JDK 1.8 atau versi yang lebih baru. Unduh JDK 1.8

• Unduh dan instal IntelliJ IDEA. Unduh IntelliJ IDEA

Verifikasi versi

Buka terminal dan jalankan java -version untuk memeriksa versi Java (JDK) Anda.

Konfigurasikan variabel lingkungan

Untuk menghindari risiko keamanan akibat hardcoding AccessKey dalam kode bisnis, contoh ini menyimpan AccessKey dalam variabel lingkungan. Langkah konfigurasi bervariasi tergantung sistem operasi. Untuk informasi lebih lanjut, lihat Konfigurasikan variabel lingkungan pada Linux, macOS, dan Windows.

Instal dependensi

Dependensi SDK

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>cas20200407</artifactId>
  <version>1.0.13</version>
</dependency>

Dependensi autentikasi

Disarankan menggunakan versi terbaru dari pustaka Credentials Java.

<dependency>
   <groupId>com.aliyun</groupId>
   <artifactId>credentials-java</artifactId>
   <version>LATEST</version>
</dependency>

Unduh kode contoh

1. Di Konsol OpenAPI, buka halaman debugging API DescribeCertificateState.

2. Pada bagian pengaturan parameter, masukkan OrderId—ID pesanan aplikasi sertifikat yang ingin Anda kueri.

3. Klik Download full project, seperti yang ditunjukkan pada gambar berikut, untuk mengunduh paket kode contoh Java.

   

4. Ekstrak paket kode contoh tersebut di mesin lokal Anda, lalu buka IntelliJ IDEA dan impor proyek yang telah diekstrak.

Jalankan kode

Jalankan kode Java di IntelliJ IDEA. Anda akan memperoleh output berikut:

{
  "Type": "domain_verify",
  "Domain": "www.example.com",
  "RecordType": "TXT",
  "Certificate": "-----BEGIN CERTIFICATE----- …… -----END CERTIFICATE-----",
  "RequestId": "082FAB35-6AB9-4FD5-8750-D36673548E76",
  "RecordDomain": "_dnsauth",
  "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----…… -----END RSA PRIVATE KEY-----",
  "ValidateType": "FILE",
  "RecordValue": "20200420000000223erigacv46uhaubchcm0o7spxi7i2isvjq59mlx9lucnkqcy",
  "Content": "http://example.com/.well-known/pki-validation/fileauth.txt",
  "Uri": "/.well-known/pki-validation/fileauth.txt"
}