Todos los productos
Search

Este producto

    API Gateway:Gestión de autorizaciones

    Centro de documentos

    API Gateway:Gestión de autorizaciones

    Última actualización: Sep 03, 2026

    La autorización de API establece una relación entre una aplicación y una API. La aplicación funciona como la identidad para invocar una API y debe contar con autorización para hacerlo.

    Requisitos previos

    El método de autenticación de la API está configurado como Alibaba Cloud App authentication.

    Aplicaciones

    Una aplicación es la identidad que se utiliza para invocar una API. De forma predeterminada, cada aplicación cuenta con un key pair compuesto por un AppKey y un AppSecret. El AppKey debe enviarse como parámetro en el encabezado de la solicitud, mientras que el AppSecret se emplea para calcular la firma de la solicitud. Para obtener más información sobre cómo calcular y enviar la firma, consulte Use digest authentication to call an API.

    • El key pair formado por AppKey y AppSecret otorga permisos completos a la aplicación. Guárdelo en un lugar seguro. Si el key pair se ve comprometido, restablézcalo from la consola de API Gateway.

    • Cree varias aplicaciones y autorícelas para invocar distintas API según las necesidades de su negocio. Tenga en cuenta que las autorizaciones se asignan a las aplicaciones, no a una cuenta de Alibaba Cloud.

    • En la consola de API Gateway, cree, modifique y elimine aplicaciones; además, consulte sus detalles, gestione claves y revise las API autorizadas.

    • Agregue nuevos pares de AppKey y AppSecret a una aplicación from su página de detalles. El nuevo key pair hereda todos los permisos de la aplicación y se puede eliminar. Sin embargo, el key pair predeterminado generado al crear la aplicación no se puede eliminar.

    Crear una aplicación

    1. Inicie sesión en API Gateway console. En el panel de navegación izquierdo, seleccione Call APIs > Apps, y luego haga clic en Create App en la esquina superior derecha.

    2. En la página Create App, introduzca un App Name y haga clic en Create.

    Nota

    Al crear una aplicación, tiene la opción de configure etiquetas, proporcionar información personalizada de AK y definir un extension field.

    • Configuración de etiquetas: Utilice etiquetas para organizar sus aplicaciones.

    • Información personalizada de AK: Le permite definir un AppKey y un AppCode personalizados al crear una aplicación. También puede modifique el AppKey y el AppCode de una aplicación en producción. Los cambios surten efecto de inmediato.

    • Extension field: Permite configure un campo de extensión para la aplicación. API Gateway transmite este campo al servicio backend como el parámetro del sistema CaAppExtInfo.

      Importante

      Si adquirió una instancia dedicada antes de agosto de 2023 y el campo de extensión no surte efecto, envíe un ticket para actualizar la versión de su instancia.

    Deshabilitar una aplicación

    1. Inicie sesión en API Gateway console. En el panel de navegación izquierdo, seleccione Call APIs > Apps.

    2. Haga clic en la aplicación deseada para ir a la página Application Details. A continuación, haga clic en Disable App Authentication en la esquina superior derecha.

      Nota

      Una vez deshabilitada, la aplicación ya no podrá invocar las API autorizadas. Vuelva a habilite la aplicación en cualquier momento para reanudar las invocaciones.

      Importante

      Si adquirió una instancia dedicada antes de julio de 2025 y esta función no opera correctamente, envíe un ticket para actualizar la versión de su instancia.

    Autorización de API

    La autorización es el proceso mediante el cual se concede permiso a una aplicación para invocar una API. Una aplicación debe estar autorizada antes de poder invocar una API.

    • Autorice directamente sus propias aplicaciones para que invoquen sus API.

    • También puede autorizar sus aplicaciones para invocar API adquiridas en Alibaba Cloud Marketplace. Si no dispone de una aplicación, Alibaba Cloud Marketplace creará una automáticamente y la autorizará durante el proceso de compra. Para más información, visite la consola de Alibaba Cloud Marketplace.

    • Para utilizar la API de un socio (de otra cuenta de Alibaba Cloud) mediante un acuerdo fuera de línea, cree una aplicación y proporcione su ID de aplicación al socio. Posteriormente, el socio podrá autorizar su aplicación buscándola por dicho ID.

    Procedimiento

    1. Inicie sesión en API Gateway console. En el panel de navegación izquierdo, seleccione Manage APIs > APIs, localice la API deseada y, en la columna Actions, haga clic en image> Authorize.

    2. En la página de autorización, seleccione un stage y un Authorization validity period, y luego elija la aplicación que desea autorizar en la sección Choose apps for authorization. Para autorizar una aplicación de su propia cuenta, seleccione My apps y haga clic en Search para cargar todas las aplicaciones vinculadas a su cuenta.

      Para autorizar una aplicación de otra cuenta, seleccione App ID, introduzca el ID correspondiente en el cuadro de texto y haga clic en Search.

      Importante

      Si adquirió una instancia dedicada antes de noviembre de 2023 y un key pair recién agregado no surte efecto, envíe un ticket para actualizar la versión de su instancia. El key pair predeterminado generado al crear la aplicación no se ve afectado por la versión de la instancia.