새 개발자 포털로 마이그레이션

이 문서에서는 사용되지 않는 레거시 포털에서 API Management의 새 개발자 포털로 마이그레이션하기 위해 수행해야 하는 단계를 설명합니다.

적용 대상: 개발자 | 기본 | 표준 | 프리미엄

새 개발자 포털의 향상된 기능

새 개발자 포털은 사용되지 않는 포털의 여러 제한 사항을 해결합니다. 콘텐츠 편집하기 위한 시각적 끌어서 놓기 편집기와 디자이너가 웹 사이트의 스타일을 지정할 수 있는 전용 패널이 있습니다. 페이지, 사용자 지정 및 구성은 API Management 서비스에서 Azure Resource Manager 리소스로 저장되므로 포털 배포 자동화할있습니다. 마지막으로 포털의 코드베이스는 오픈 소스이므로 사용자 지정 기능사용하여 확장할 수 있습니다.

새 개발자 포털로 마이그레이션하는 방법

새 개발자 포털은 사용되지 않는 포털과 호환되지 않으며 자동화된 마이그레이션은 불가능합니다. 콘텐츠(페이지, 텍스트, 미디어 파일)를 수동으로 다시 만들고 새 포털의 모양을 사용자 지정해야 합니다. 정확한 단계는 포털의 사용자 지정 및 복잡성에 따라 달라집니다. 지침은 개발자 포털 자습서 참조하세요. API, 제품, 사용자, ID 공급자 목록과 같은 나머지 구성은 두 포털에서 자동으로 공유됩니다.

더 이상 사용되지 않는 포털에서 마이그레이션하는 경우 다음과 같은 변경 사항에 유의하세요.

• 사용자 지정 도메인을 통해 개발자 포털을 노출하는 경우, 새 개발자 포털에 도메인을 할당하십시오. Azure Portal의 드롭다운에서 개발자 포털 옵션을 사용합니다.

• API에 CORS 정책 적용하여 대화형 테스트 콘솔을 사용하도록 설정합니다.

• 포털 스타일을 지정하기 위해 사용자 지정 CSS를 삽입하는 경우 기본 제공 디자인 패널 사용하여 스타일을복제해야 합니다. CSS 삽입은 새 포털에서 허용되지 않습니다.

• 새 포털 자체 호스팅 버전에서만 사용자 지정 JavaScript를 삽입할 수 있습니다.

• API Management가 가상 네트워크에 있고 Application Gateway를 통해 인터넷에 노출되는 경우 자세한 구성 단계는 이 문서 문서 참조하세요. 다음을 수행해야 합니다.

  • API Management의 관리 엔드포인트에 대한 연결을 사용하도록 설정합니다.
  • 새 포털 엔드포인트에 대한 연결을 사용하도록 설정합니다.
  • 선택한 웹 애플리케이션 방화벽 규칙을 사용하지 않도록 설정합니다.

• 명시적으로 정의된 사용되지 않는 포털 URL을 포함하도록 기본 전자 메일 알림 템플릿을 변경한 경우 포털 URL 매개 변수를 사용하거나 새 포털 URL을 가리키도록 변경합니다. 템플릿에서 기본 제공 포털 URL 매개 변수를 대신 사용하는 경우 변경이 필요하지 않습니다.

• 문제 및 애플리케이션 새 개발자 포털에서 지원되지 않습니다.

• Facebook, Microsoft, Twitter 및 Google을 ID 공급자로 직접 통합하는 기능은 새 개발자 포털에서 지원되지 않습니다. Azure AD B2C를 통해 해당 공급자와 통합할 수 있습니다.

• 위임을 사용하는 경우 애플리케이션에서 반환 URL을 변경하고 SSO URL 생성 엔드포인트 대신 공유 액세스 토큰 가져오기 API 엔드포인트 사용합니다.

• Microsoft Entra ID를 ID 공급자로 사용하는 경우:

  • 새 개발자 포털 도메인을 가리키도록 애플리케이션의 반환 URL을 변경합니다.
  • 애플리케이션에서 반환 URL의 접미사를 /signin-aad에서 /signin로 수정합니다.

• Azure AD B2C를 ID 공급자로 사용하는 경우:

  • 새 개발자 포털 도메인을 가리키도록 애플리케이션의 반환 URL을 변경합니다.
  • 애플리케이션에서 반환 URL의 접미사를 /signin-aad에서 /signin로 수정합니다.
  • 애플리케이션 클레임에 지정된 이름, 성및 사용자의 개체 ID를 포함합니다.

• 대화형 테스트 콘솔에서 OAuth 2.0을 사용하는 경우 새 개발자 포털 도메인을 가리키도록 애플리케이션의 반환 URL을 변경하고 접미사를 수정합니다.

  • 권한 부여 코드 부여 흐름에서 /docs/services/[serverName]/console/oauth2/authorizationcode/callback에서 /signin-oauth/code/callback/[serverName]로.
  • 암시적 허용 흐름을 위한 /docs/services/[serverName]/console/oauth2/implicit/callback에서 /signin-oauth/implicit/callback까지.

• 대화형 테스트 콘솔에서 OpenID Connect를 사용하는 경우 새 개발자 포털 도메인을 가리키도록 애플리케이션의 반환 URL을 변경하고 접미사를 수정합니다.

  • 권한 부여 코드 부여 흐름에서 /docs/services/[serverName]/console/openidconnect/authorizationcode/callback에서 /signin-oauth/code/callback/[serverName]로.
  • 암시적 허용 흐름을 위한 /docs/services/[serverName]/console/openidconnect/implicit/callback에서 /signin-oauth/implicit/callback까지.

다음 단계

다음 문서를 통해 개발자 포털에 대해 자세히 알아봅니다.

• Azure API Management 개발자 포털 개요
• 개발자 포털 액세스 및 사용자 지정