Managed Service for OpenTelemetry konsol sayfalarını web uygulamanıza gömün. Böylece ekibiniz Alibaba Cloud konsoluna geçiş yapmadan izleme verilerini (uygulamalar, uygulama ayrıntıları ve izler) görüntüleyebilir.
Gömme akışı, oturum açma gerektirmeyen URL'ler oluşturmak için Resource Access Management (RAM) ve Security Token Service (STS) hizmetlerini kullanır. RAM ilkeleri sayfa düzenini (gezinti çubuklarını gizleme) ve erişim düzeyini (tam veya salt okunur) denetler.
Nasıl çalışır
Gömme akışı, konsol sayfalarına geçici ve sınırlı erişim sağlamak için STS tabanlı birleşik oturum açmayı kullanır:
|
|
|
|
|
|
|
|
|
|
|
|
Ön koşullar
Başlamadan önce şunlara sahip olduğunuzdan emin olun:
RAM yönetici ayrıcalıklarına (veya
AliyunRAMFullAccessilkesine) sahip bir Alibaba Cloud hesabıHTTP istekleri yapabilen bir arka uca sahip, kendi yönettiğiniz bir web uygulaması
1. Adım: Bir RAM kullanıcısı oluşturun ve STS AssumeRole izni verin
Uygulama arka ucunuzun STS AssumeRole işlemini çağırması için kullanacağı bir RAM kullanıcısı oluşturun.
RAM konsolu üzerinde oturum açın.
Sol gezinme bölmesinde Identity > Users seçeneğini belirleyin.
Users sayfasında Create User öğesine tıklayın.
-
Create User sayfasında aşağıdaki ayarları yapılandırın:
User Account Information bölümünde Logon Name ve Display Name alanlarını ayarlayın.
Access Mode bölümünde Using permanent AccessKey to access seçeneğini belirleyin.
-
OK öğesine tıklayın.
ÖnemliRAM, RAM kullanıcısı için otomatik olarak bir AccessKey çifti oluşturur. AccessKey çifti yalnızca bir kez gösterilir. Sayfayı kapatmadan önce AccessKey ID ve AccessKey secret değerlerini kopyalayın ve güvenli bir yerde saklayın. Daha fazla bilgi için bkz. AccessKey çifti oluşturma.
-
Users sayfasında ilgili RAM kullanıcısını bulun ve Actions sütunundaki Add Permissions öğesine tıklayın.
Birden çok RAM kullanıcısına aynı anda izin vermek için kullanıcıları seçin ve sayfanın alt kısmındaki Add Permissions öğesine tıklayın.
-
Grant Permission panelinde aşağıdaki ayarları yapılandırın:
-
Resource Scope alanını ayarlayın:
Account: İzin, mevcut Alibaba Cloud hesabı için geçerlidir.
ResourceGroup: İzin, belirli bir kaynak grubu için geçerlidir. Bkz. Belirli bir ECS örneğini yönetmek için RAM kullanıcısına izin vermek üzere kaynak grubu kullanma.
ÖnemliResource Scope alanını ResourceGroup olarak ayarlamadan önce cloud hizmetinin kaynak gruplarını desteklediğinden emin olun. Bkz. Kaynak Grubu ile çalışan hizmetler.
Principal (izin verilen RAM kullanıcısı) değerini onaylayın. Sistem, geçerli RAM kullanıcısını asıl olarak otomatik şekilde seçer.
Policy bölümünde AliyunSTSAssumeRoleAccess ilkesini seçin.
Grant permissions öğesine tıklayın.
-
Close öğesine tıklayın.
2. Adım: Bir RAM rolü oluşturun ve Managed Service for OpenTelemetry izinleri verin
Gömülü konsol oturumunun nelerine erişebileceğini tanımlayan bir RAM rolü oluşturun.
Güvenilen bir Alibaba Cloud hesabı için RAM rolü oluşturma işlemini tamamlayın.
-
RAM rolüne izin verme işlemini tamamlayın. Gereken erişim düzeyine bağlı olarak aşağıdaki ilkelerden birini seçin:
İlke
Erişim düzeyiAliyunTracingAnalysisFullAccess
Managed Service for OpenTelemetry için tam okuma ve yazma erişimiAliyunTracingAnalysisReadOnlyAccess
Managed Service for OpenTelemetry için salt okunur erişimÖnemliRAM rolü izinleri, gömülü konsolda hangi verilerin ve işlemlerin kullanılabilir olduğunu belirler.
3. Adım: Geçici bir AccessKey çifti ve STS belirteci alın
Uygulama arka ucunuzdan, geçici kimlik bilgilerini almak için STS AssumeRole işlemini çağırın. Aşağıdaki yöntemlerden birini kullanın:
Örnek kodda yer tutucuları gerçek değerlerinizle değiştirin:
String akId = "<your-access-key-id>";
String ak = "<your-access-key-secret>";
String roleArn = "<your-role-arn>";
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
4. Adım: Oturum açma belirteci alın
GetSigninToken işlemini çağırarak 3. Adımdaki geçici kimlik bilgilerini bir oturum açma belirteci ile değiştirin.
STS belirteci özel karakterler içerebilir. Belirteci isteğe dahil etmeden önce URL kodlaması uygulayın.
http://signin4service.alibabacloud.com/federation?Action=GetSigninToken
&AccessKeyId=<temporary-access-key-id>
&AccessKeySecret=<temporary-access-key-secret>
&SecurityToken=<sts-token>
&TicketType=mini
Web uygulamanız bir partner cloud platformunda dağıtılmışsa yalnızca &TicketType=mini parametresini ekleyin.
5. Adım: Oturum açma gerektirmeyen bir URL oluşturun
4. Adımdaki oturum açma belirtecini konsol sayfası URL'si ile birleştirerek oturum açma gerektirmeyen bir URL oluşturun.
-
Hedef konsol sayfası URL'sini alın. Örneğin, Çin (Hangzhou) bölgesi için Applications sayfası:
https://trace4servims.console.alibabacloud.com/#/overview/cn-hangzhou -
(İsteğe bağlı) Gezinti öğelerini gizlemek için konsol sayfası URL'sine düzen parametreleri ekleyin:
Parametre
Etkisi
ÖrnekhideTopbar=true
Üst gezinti çubuğunu gizlerhttps://trace4servims.console.alibabacloud.com/#/overview/cn-hangzhou?hideTopbar=truehideSidebar=true
Sol gezinme bölmesini gizlerhttps://trace4servims.console.alibabacloud.com/#/overview/cn-hangzhou?hideSidebar=trueHer ikisini de gizlemek için parametreleri birleştirin:
?hideTopbar=true&hideSidebar=true -
Oturum açma gerektirmeyen URL'yi oluşturun:
http://signin.alibabacloud.com/federation?Action=Login &LoginUrl=<your-login-failure-redirect-url> &SigninToken=<logon-token> &Destination=<console-page-url>
Parametre
AçıklamaLoginUrl
Oturum açma başarısız olursa kullanıcıların yönlendirileceği URL (HTTP 302 döndürür)SigninToken
4. Adımdaki oturum açma belirteciDestination
Managed Service for OpenTelemetry konsol sayfası URL'si (isteğe bağlı düzen parametreleriyle)
Belirteç sona ermesini yönetme
Geçici STS belirteçleri 3 saat sonra sona erer. Kesintisiz erişimi sürdürmek için:
Uygulama arka ucunuzdan her sayfa isteğinde yeni bir oturum açma belirteci oluşturun.
Güncellenmiş oturum açma gerektirmeyen URL'ye 302 yönlendirmesi yapın.
Sonuç
Managed Service for OpenTelemetry konsol sayfası web uygulamanızın içinde görüntülenir.
Örnek kod
Tam örnek kodu (Java) indirin. Bu örnek, Managed Service for OpenTelemetry konsolunun Applications sayfasını kendi yönettiğiniz bir web uygulamasına gömer.