다음을 통해 공유

Azure API for FHIR에 대한 클라이언트 애플리케이션 등록

  • 아티클

Important

Azure API for FHIR은 2026년 9월 30일에 사용 중지됩니다. 해당 날짜까지 마이그레이션 전략에 따라 Azure Health Data Services FHIR® 서비스로 전환합니다. Azure API for FHIR의 사용 중지로 인해 2025년 4월 1일부터 신규 배포가 허용되지 않습니다. Azure Health Data Services FHIR 서비스는 고객이 다른 Azure 서비스에 통합하여 FHIR, DICOM 및 MedTech 서비스를 관리할 수 있도록 하는 Azure API for FHIR의 진화된 버전입니다.

이전 자습서에서는 Azure API for FHIR을 배포하고 설정했습니다. 이제 Azure API for FHIR을 설정했으므로 퍼블릭 클라이언트 애플리케이션을 등록합니다. 자세한 내용이나 문제 해결을 위해 전체 공용 클라이언트 앱 등록 방법 가이드를 읽어볼 수 있지만 이 문서에서는 이 자습서의 주요 단계를 언급했습니다.

  1. Microsoft Entra ID로 이동

  2. 앱 등록 -->새 등록을 선택합니다.

  3. 애플리케이션 이름 지정

  4. 퍼블릭 클라이언트/네이티브(모바일 및 데스크톱)를 선택하고 리디렉션 URI를 https://www.getpostman.com/oauth2/callback으로 설정합니다.

    애플리케이션 등록 창의 스크린샷 및 애플리케이션 이름과 리디렉션 URL의 예입니다.

클라이언트 애플리케이션 설정

클라이언트 애플리케이션이 등록되면 개요 페이지에서 애플리케이션(클라이언트) ID와 테넌트 ID를 복사합니다. 나중에 클라이언트를 평가할 때 이 두 값이 필요합니다.

애플리케이션 및 디렉터리 ID가 강조 표시된 클라이언트 애플리케이션 설정 창의 스크린샷.

웹앱으로 연결

Azure API for FHIR에 연결하기 위해 웹앱을 작성한 경우 올바른 인증 옵션도 설정해야 합니다.

  1. 왼쪽 메뉴의 관리 아래에서 인증을 선택합니다.

  2. 새 플랫폼 구성을 추가하려면 웹을 선택합니다.

  3. 이 자습서의 네 번째 부분에서 웹 애플리케이션을 만들 때를 준비하는 과정에서 리디렉션 URI를 설정합니다. 이렇게 하려면 리디렉션 URI 목록에 https://\<WEB-APP-NAME>.azurewebsites.net을 추가합니다. 웹앱을 작성하는 단계에서 다른 이름을 선택하는 경우 돌아가서 이를 업데이트해야 합니다.

  4. 액세스 토큰 및 ID 토큰 확인란을 선택합니다.

    플랫폼 추가 단계가 강조 표시된 인증 설정 블레이드의 스크린샷.

API 사용 권한 추가

이제 올바른 인증을 설정했으므로 API 사용 권한을 설정합니다.

  1. API 권한을 선택하고 권한 추가를 선택합니다.
  2. 내 조직에서 사용하는 API에서 Azure Health Data Services를 검색합니다.
  3. user_impersonation을 선택하고 권한 추가를 선택합니다.

API 사용 권한을 추가하는 단계가 강조 표시된 API 사용 권한 추가 블레이드의 스크린샷.

다음 단계

이제 퍼블릭 클라이언트 애플리케이션이 있습니다. 다음 자습서에서는 Postman을 통해 이 애플리케이션을 테스트하고 액세스 권한을 얻는 방법을 살펴봅니다.

Postman에서 클라이언트 애플리케이션 테스트

FHIR®은 HL7의 등록 상표이며, HL7의 사용 허가 하에 사용됩니다.