Application Real-Time Monitoring Service:Menyematkan halaman konsol Managed Service for OpenTelemetry di aplikasi web yang dikelola sendiri

Cara kerja

Alur penyematan memanfaatkan login federasi berbasis STS untuk memberikan akses sementara dan terbatas ke halaman konsol:

Prasyarat

Sebelum memulai, pastikan Anda telah memiliki:

• Akun Alibaba Cloud dengan hak istimewa administratif RAM (atau kebijakan AliyunRAMFullAccess)

• Aplikasi web yang dikelola sendiri dengan backend yang mampu melakukan permintaan HTTP

Langkah 1: Buat RAM user dan berikan izin STS AssumeRole

Buat RAM user yang digunakan oleh backend aplikasi Anda untuk memanggil operasi STS AssumeRole.

1. Login ke Konsol RAM.

2. Di panel navigasi sebelah kiri, pilih Identity > Users.

3. Pada halaman Users, klik Create User.

4. Pada halaman Create User, konfigurasikan pengaturan berikut:

   • Pada bagian User Account Information, atur Logon Name dan Display Name.

   • Pada bagian Access Mode, pilih Using permanent AccessKey to access.

5. Klik OK.

   Penting

   RAM secara otomatis menghasilkan pasangan AccessKey untuk RAM user tersebut. Pasangan AccessKey hanya ditampilkan sekali. Salin dan simpan ID AccessKey dan Rahasia AccessKey sebelum menutup halaman. Untuk informasi lebih lanjut, lihat Create an AccessKey pair.

6. Pada halaman Users, temukan RAM user tersebut dan klik Add Permissions di kolom Actions.

   Untuk memberikan izin ke beberapa RAM user sekaligus, pilih user tersebut lalu klik Add Permissions di bagian bawah halaman.

7. Pada panel Grant Permission, konfigurasikan pengaturan berikut:

   1. Atur Resource Scope:

      • Account: Izin berlaku untuk Akun Alibaba Cloud saat ini.

      • ResourceGroup: Izin berlaku untuk kelompok sumber daya tertentu. Lihat Use a resource group to grant a RAM user the permissions to manage a specific ECS instance.

      Penting

      Sebelum mengatur Resource Scope ke ResourceGroup, pastikan layanan cloud tersebut mendukung kelompok sumber daya. Lihat Services that work with Resource Group.

   2. Konfirmasi Principal (RAM user yang Anda beri izin). Sistem secara otomatis memilih RAM user saat ini sebagai principal.

   3. Pada bagian Policy, pilih AliyunSTSAssumeRoleAccess.

   4. Klik Grant permissions.

8. Klik Close.

Langkah 2: Buat RAM role dan berikan izin Managed Service for OpenTelemetry

Buat RAM role yang menentukan data dan operasi apa saja yang dapat diakses melalui sesi konsol yang disematkan.

1. Create a RAM role for a trusted Alibaba Cloud account.

2. Grant permissions to the RAM role. Pilih salah satu kebijakan berikut berdasarkan tingkat akses yang Anda butuhkan:

   Policy	Access level
   AliyunTracingAnalysisFullAccess	Full read and write access to Managed Service for OpenTelemetry
   AliyunTracingAnalysisReadOnlyAccess	Read-only access to Managed Service for OpenTelemetry

   Penting

   Izin RAM role menentukan data dan operasi yang tersedia di konsol yang disematkan.

Langkah 3: Dapatkan pasangan AccessKey sementara dan token STS

Dari backend aplikasi Anda, panggil operasi STS AssumeRole untuk mendapatkan kredensial sementara. Gunakan salah satu metode berikut:

• OpenAPI Explorer

• RAM SDK for Java

Ganti placeholder dalam kode contoh dengan nilai aktual Anda:

String akId = "<your-access-key-id>";
String ak = "<your-access-key-secret>";
String roleArn = "<your-role-arn>";

Langkah 4: Dapatkan token login

Panggil operasi GetSigninToken untuk menukar kredensial sementara dari Langkah 3 menjadi token login.

http://signin4service.alibabacloud.com/federation?Action=GetSigninToken
    &AccessKeyId=<temporary-access-key-id>
    &AccessKeySecret=<temporary-access-key-secret>
    &SecurityToken=<sts-token>
    &TicketType=mini

Langkah 5: Bangun URL tanpa login

Gabungkan token login dari Langkah 4 dengan URL halaman konsol untuk membuat URL tanpa login.

1. Dapatkan URL halaman konsol target. Misalnya, halaman Applications untuk wilayah China (Hangzhou):

   https://trace4servims.console.alibabacloud.com/#/overview/cn-hangzhou

2. (Opsional) Tambahkan parameter tata letak ke URL halaman konsol untuk menyembunyikan elemen navigasi:

   Parameter	Effect	Example
   hideTopbar=true	Hides the top navigation bar	https://trace4servims.console.alibabacloud.com/#/overview/cn-hangzhou?hideTopbar=true
   hideSidebar=true	Hides the left-side navigation pane	https://trace4servims.console.alibabacloud.com/#/overview/cn-hangzhou?hideSidebar=true

   Untuk menyembunyikan keduanya, gabungkan parameter: ?hideTopbar=true&hideSidebar=true

3. Bangun URL tanpa login:

   http://signin.alibabacloud.com/federation?Action=Login
       &LoginUrl=<your-login-failure-redirect-url>
       &SigninToken=<logon-token>
       &Destination=<console-page-url>

   Parameter	Description
   LoginUrl	URL tempat pengguna dialihkan jika login gagal (mengembalikan HTTP 302)
   SigninToken	Token login dari Langkah 4
   Destination	URL halaman konsol Managed Service for OpenTelemetry (dengan parameter tata letak opsional)