Megosztás a következőn keresztül:

Migrálás az új fejlesztői portálra

  • Cikk

Ez a cikk az elavult örökölt portálról az új fejlesztői portálra való migráláshoz szükséges lépéseket ismerteti a API Management.

Fontos

Az örökölt fejlesztői portál elavult, és csak biztonsági frissítéseket fog kapni. Továbbra is használhatja a szokásos módon a 2023 októberében esedékes kivezetéséig, amikor eltávolítjuk az API Management-szolgáltatások közül.

API Management fejlesztői portál

Rendelkezésre állás

Fontos

Ez a funkció az API Management Prémium, Standard, Alapszintű és Fejlesztői szintjén érhető el.

A v2-szinteken (előzetes verzió) elérhető funkciókért tekintse meg a v2-szintek áttekintését.

Fejlesztések az új fejlesztői portálon

Az új fejlesztői portál az elavult portál számos korlátozásával foglalkozik. A vizualizációk húzással történő szerkesztésére szolgáló szerkesztővel és a webhely stílusának megfelelő dedikált panelrel rendelkezik a tervezők számára. A lapok, testreszabások és konfigurációk Azure Resource Manager-erőforrásokként vannak mentve a API Management szolgáltatásban, így automatizálhatja a portálok üzembe helyezését. Végül a portál kódbázisa nyílt forráskódú, így egyéni funkciókkal bővítheti.

Migrálás az új fejlesztői portálra

Az új fejlesztői portál nem kompatibilis az elavult portállal, és az automatizált migrálás nem lehetséges. Manuálisan újra létre kell hoznia a tartalmakat (oldalakat, szövegeket, médiafájlokat), és testre kell szabnia az új portál megjelenését. A pontos lépések a portál testreszabásától és összetettségétől függően változnak. Útmutatásért tekintse meg a fejlesztői portál oktatóanyagát . A fennmaradó konfiguráció, például az API-k, a termékek, a felhasználók és az identitásszolgáltatók listája automatikusan meg van osztva mindkét portálon.

Fontos

Ha korábban elindította az új fejlesztői portált, de nem végzett módosításokat, állítsa alaphelyzetbe az alapértelmezett tartalmat a legújabb verzióra való frissítéshez.

Ha az elavult portálról migrál, tartsa szem előtt a következő módosításokat:

  • Ha a fejlesztői portált egy egyéni tartományon keresztül teszi elérhetővé, rendeljen hozzá egy tartományt az új fejlesztői portálhoz. Használja a Fejlesztői portál lehetőséget a Azure Portal legördülő listájából.

  • CorS-szabályzat alkalmazása AZ API-kra az interaktív tesztkonzol engedélyezéséhez.

  • Ha egyéni CSS-t ad a portál stílusához, a stílust a beépített tervezőpanel használatával kell replikálnia. A CSS-injektálás nem engedélyezett az új portálon.

  • Egyéni JavaScriptet csak az új portál saját üzemeltetésű verziójában szúrhat be.

  • Ha a API Management egy virtuális hálózaton található, és Application Gateway keresztül van elérhetővé téve az interneten, a pontos konfigurációs lépésekért tekintse meg ezt a dokumentációs cikket. A következőket kell elvégeznie:

    • Engedélyezze a kapcsolatot a API Management felügyeleti végpontjával.
    • Engedélyezze a kapcsolatot az új portálvégponttal.
    • A kijelölt Web Application Firewall szabályok letiltása.

  • Ha az alapértelmezett e-mail értesítési sablonokat úgy módosította, hogy egy explicit módon definiált elavult portál URL-címet tartalmazzon, módosítsa őket úgy, hogy a portál URL-címét használja, vagy mutasson az új portál URL-címére. Ha a sablonok ehelyett a beépített portál URL-paraméterét használják, nincs szükség módosításokra.

  • A problémák és az alkalmazások nem támogatottak az új fejlesztői portálon.

  • A Facebook, a Microsoft, a Twitter és a Google identitásszolgáltatókkal való közvetlen integrációja nem támogatott az új fejlesztői portálon. Ezekkel a szolgáltatókkal Azure AD B2C-n keresztül integrálható.

  • Ha delegálást használ, módosítsa a visszatérési URL-címet az alkalmazásokban, és használja a Közös hozzáférésű jogkivonat API-végpontjának lekérését az SSO URL-cím létrehozása végpont helyett.

  • Ha identitásszolgáltatóként Microsoft Entra azonosítót használ:

    • Módosítsa az alkalmazás visszatérési URL-címét úgy, hogy az az új fejlesztői portál tartományára mutasson.
    • Módosítsa az alkalmazás visszatérési URL-címének utótagját a-ról /signin-aad a-ra /signin.

  • Ha identitásszolgáltatóként Azure AD B2C-t használ:

    • Módosítsa az alkalmazás visszatérési URL-címét úgy, hogy az az új fejlesztői portál tartományára mutasson.
    • Módosítsa az alkalmazás visszatérési URL-címének utótagját a-ról /signin-aad a-ra /signin.
    • Adja meg a utónevet, a vezetéknevet és a felhasználó objektumazonosítóját az alkalmazásjogcímekben.

  • Ha az OAuth 2.0-t használja az interaktív tesztkonzolon, módosítsa az alkalmazás visszatérési URL-címét úgy, hogy az új fejlesztői portál tartományára mutasson, és módosítsa az utótagot:

    • /signin-oauth/code/callback/[serverName] Az /docs/services/[serverName]/console/oauth2/authorizationcode/callback engedélyezési kód engedélyezési folyamatához.
    • Az implicit engedélyezési folyamattól /docs/services/[serverName]/console/oauth2/implicit/callback a felé /signin-oauth/implicit/callback .

  • Ha az openID Connectet használja az interaktív tesztkonzolon, módosítsa az alkalmazás visszatérési URL-címét úgy, hogy az új fejlesztői portál tartományára mutasson, és módosítsa az utótagot:

    • /signin-oauth/code/callback/[serverName] Az /docs/services/[serverName]/console/openidconnect/authorizationcode/callback engedélyezési kód engedélyezési folyamatához.
    • Az implicit engedélyezési folyamattól /docs/services/[serverName]/console/openidconnect/implicit/callback a felé /signin-oauth/implicit/callback .

Következő lépések

További információ a fejlesztői portálról: