Migración al nuevo portal para desarrolladores

En este artículo se describen los pasos que debe seguir para migrar desde el portal heredado en desuso al nuevo portal para desarrolladores de API Management.

SE APLICA A: Desarrollador | Básico | Estándar | Premium

Mejoras en el nuevo portal para desarrolladores

El nuevo portal para desarrolladores aborda muchas limitaciones del portal en desuso. Cuenta con un editor de arrastrar y colocar visual para editar contenido y un panel dedicado para que los diseñadores estilon el sitio web. Las páginas, las personalizaciones y la configuración se guardan como recursos de Azure Resource Manager en el servicio API Management, lo que le permite automatizar las implementaciones del portal. Por último, el código base del portal es de código abierto, por lo que puede ampliarlo con funcionalidad personalizada.

Migración a un nuevo portal para desarrolladores

El nuevo portal para desarrolladores no es compatible con el portal en desuso y la migración automatizada no es posible. Debe volver a crear manualmente el contenido (páginas, texto, archivos multimedia) y personalizar la apariencia del nuevo portal. Los pasos precisos variarán en función de las personalizaciones y la complejidad del portal. Consulte el tutorial del portal para desarrolladores para obtener instrucciones. La configuración restante, como la lista de API, productos, usuarios, proveedores de identidades, se comparte automáticamente en ambos portales.

Al migrar desde el portal en desuso, tenga en cuenta los siguientes cambios:

• Si expone el portal para desarrolladores a través de un dominio personalizado, asigne un dominio al nuevo portal para desarrolladores. Use la opción Portal para desarrolladores en la lista desplegable de Azure Portal.

• Aplique una directiva de CORS en las API para habilitar la consola de prueba interactiva.

• Si inserta CSS personalizado para aplicar estilo al portal, debe replicar el estilo mediante el panel de diseño integrado. No se permite la inserción de CSS en el nuevo portal.

• Solo puede insertar JavaScript personalizado en la versión autohospedada del nuevo portal.

• Si API Management está en una red virtual y se expone a Internet a través de Application Gateway, consulte este artículo de documentación para conocer los pasos de configuración precisos. Necesitas:

  • Habilite la conectividad con el punto de conexión de administración de API Management.
  • Habilite la conectividad con el nuevo punto de conexión del portal.
  • Deshabilite las reglas de Firewall de aplicaciones web seleccionadas.

• Si ha cambiado las plantillas de notificación de correo electrónico predeterminadas para incluir una dirección URL del portal en desuso definida explícitamente, cámbielas para que usen el parámetro de dirección URL del portal o apunten a la nueva dirección URL del portal. Si las plantillas usan el parámetro de dirección URL del portal integrado en su lugar, no se requieren cambios.

• Los problemas y las aplicaciones no se admiten en el nuevo portal para desarrolladores.

• La integración directa con Facebook, Microsoft, Twitter y Google como proveedores de identidades no se admite en el nuevo portal para desarrolladores. Puede integrarse con esos proveedores a través de Azure AD B2C.

• Si utiliza delegación, cambie la URL de retorno en sus aplicaciones y use el punto de conexión Get Shared Access Token API en lugar del punto de conexión Generate SSO URL.

• Si usa microsoft Entra ID como proveedor de identidades:

  • Cambie la dirección URL de retorno de la aplicación para que apunte al nuevo dominio del portal para desarrolladores.
  • Modifique el sufijo de la dirección URL de devolución de la aplicación de /signin-aad a /signin.

• Si usa Azure AD B2C como proveedor de identidades:

  • Cambie la dirección URL de retorno de la aplicación para que apunte al nuevo dominio del portal para desarrolladores.
  • Modifique el sufijo de la dirección URL de devolución de la aplicación de /signin-aad a /signin.
  • Incluya el nombre de pila, el apellido y el ID de objeto del usuario en las reclamaciones de la aplicación.

• Si usa OAuth 2.0 en la consola de prueba interactiva, cambie la dirección URL de retorno de la aplicación para que apunte al nuevo dominio del portal para desarrolladores y modifique el sufijo:

  • De /docs/services/[serverName]/console/oauth2/authorizationcode/callback a /signin-oauth/code/callback/[serverName] para el flujo de concesión de código de autorización.
  • De /docs/services/[serverName]/console/oauth2/implicit/callback a /signin-oauth/implicit/callback para el flujo de concesión implícita.

• Si usa OpenID Connect en la consola de prueba interactiva, cambie la dirección URL de retorno de la aplicación para que apunte al nuevo dominio del portal para desarrolladores y modifique el sufijo:

  • De /docs/services/[serverName]/console/openidconnect/authorizationcode/callback a /signin-oauth/code/callback/[serverName] para el flujo de concesión de código de autorización.
  • De /docs/services/[serverName]/console/openidconnect/implicit/callback a /signin-oauth/implicit/callback para el flujo de concesión implícito.

Pasos siguientes

Obtenga más información sobre el portal para desarrolladores:

• Introducción al portal para desarrolladores de Azure API Management
• Acceso y personalización del portal para desarrolladores