Managed Service for OpenTelemetry:Integrar páginas de la consola de Managed Service for OpenTelemetry en una aplicación web autogestionada

Funcionamiento

El flujo de integración emplea un inicio de sesión federado basado en STS para otorgar acceso temporal y con alcance limitado a las páginas de la consola:

Requisitos previos

Antes de empezar, asegúrese de contar con lo siguiente:

• Una cuenta de Alibaba Cloud con privilegios administrativos de RAM (o la directiva AliyunRAMFullAccess)

• Una aplicación web autogestionada con un backend capaz de realizar solicitudes HTTP

Paso 1: Crear un usuario de RAM y otorgar el permiso STS AssumeRole

Cree un usuario de RAM que el backend de su aplicación utilizará para invocar la operación STS AssumeRole.

1. Inicie sesión en la consola de RAM.

2. En el panel de navegación izquierdo, seleccione Identity > Users.

3. En la página Users, haga clic en Create User.

4. En la página Create User, configure los siguientes parámetros:

   • En la sección User Account Information, establezca Logon Name y Display Name.

   • En la sección Access Mode, seleccione Using permanent AccessKey to access.

5. Haga clic en OK.

   Importante

   RAM genera automáticamente un par de AccessKey para el usuario de RAM. Este par se muestra únicamente una vez. Copie y guarde el ID de AccessKey y el secreto de AccessKey antes de cerrar la página. Para obtener más información, consulte Create an AccessKey pair.

6. En la página Users, localice al usuario de RAM y haga clic en Add Permissions dentro de la columna Actions.

   Para otorgar permisos a varios usuarios de RAM simultáneamente, selecciónelos y haga clic en Add Permissions en la parte inferior de la página.

7. En el panel Grant Permission, configure los siguientes parámetros:

   1. Establezca Resource Scope:

      • Account: El permiso se aplica a la cuenta actual de Alibaba Cloud.

      • ResourceGroup: El permiso se aplica a un resource group específico. Consulte Use a resource group to grant a RAM user the permissions to manage a specific ECS instance.

      Importante

      Antes de establecer Resource Scope como ResourceGroup, confirme que el servicio en la nube admita resource groups. Consulte Services that work with Resource Group.

   2. Confirme el Principal (el usuario de RAM al que le está otorgando permisos). El sistema selecciona automáticamente al usuario de RAM actual como principal.

   3. En la sección Policy, seleccione AliyunSTSAssumeRoleAccess.

   4. Haga clic en Grant permissions.

8. Haga clic en Close.

Paso 2: Crear un rol de RAM y otorgar permisos de Managed Service for OpenTelemetry

Cree un rol de RAM que defina los recursos a los que puede acceder la sesión integrada de la consola.

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

2. Grant permissions to the RAM role. Elija una de las siguientes directivas según el nivel de acceso que necesite:

   Policy	Access level
   AliyunTracingAnalysisFullAccess	Acceso completo de lectura y escritura a Managed Service for OpenTelemetry
   AliyunTracingAnalysisReadOnlyAccess	Acceso de solo lectura a Managed Service for OpenTelemetry

   Importante

   Los permisos del rol de RAM determinan qué datos y operaciones están disponibles en la consola integrada.

Paso 3: Obtener un par de AccessKey temporal y un token de STS

Desde el backend de su aplicación, invoque la operación AssumeRole de STS para obtener credenciales temporales. Utilice uno de los siguientes métodos:

• OpenAPI Explorer

• RAM SDK for Java

Reemplace los marcadores de posición en el código de ejemplo con sus valores reales:

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

Paso 4: Obtener un token de inicio de sesión

Invoque la operación GetSigninToken para intercambiar las credenciales temporales del Paso 3 por un token de inicio de sesión.

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

Paso 5: Construir una URL que no requiera inicio de sesión

Combine el token de inicio de sesión del Paso 4 con la URL de la página de la consola para construir una URL que no requiera inicio de sesión.

1. Obtenga la URL de la página de la consola de destino. Por ejemplo, la página Applications correspondiente a la región China (Hangzhou):

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

2. (Opcional) Agregue parámetros de diseño a la URL de la página de la consola para ocultar elementos de navegación:

   Parameter	Effect	Example
   hideTopbar=true	Oculta la barra de navegación superior	https://trace4servims.console.alibabacloud.com/#/overview/cn-hangzhou?hideTopbar=true
   hideSidebar=true	Oculta el panel de navegación izquierdo	https://trace4servims.console.alibabacloud.com/#/overview/cn-hangzhou?hideSidebar=true

   Para ocultar ambos elementos, combine los parámetros: ?hideTopbar=true&hideSidebar=true

3. Construya la URL que no requiere inicio de sesión:

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

   Parameter	Description
   LoginUrl	La URL a la que se redirige a los usuarios si falla el inicio de sesión (devuelve HTTP 302)
   SigninToken	El token de inicio de sesión obtenido en el Paso 4
   Destination	La URL de la página de la consola de Managed Service for OpenTelemetry (con parámetros de diseño opcionales)

Resultado

La página de la consola de Managed Service for OpenTelemetry se mostrará dentro de su aplicación web.

Código de ejemplo

Descargue el código de ejemplo completo (Java). Este ejemplo integra la página Applications de la consola de Managed Service for OpenTelemetry en una aplicación web autogestionada.