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은 실행 가능한 분석 및 기계 학습 솔루션을 위한 솔루션을 사용하는 임상 건강 데이터를 위한 관리형 표준 기반 규격의 API입니다.
필수 조건으로 Azure 구독이 필요하며 Azure 리소스 그룹을 만들고 Azure 리소스를 배포할 수 있는 적절한 권한이 부여되었습니다. Azure 구독이 없는 경우 시작하기 전에 체험 계정을 만듭니다.
Azure 리소스 만들기
Azure API for FHIR을 시작하려면 Azure Portal에서 리소스를 만들어야 합니다. 검색 서비스 및 마켓플레이스 상자에 Azure API for FHIR을 입력합니다.
Azure API for FHIR 리소스를 찾은 후 만들기를 선택합니다.
Azure API for FHIR 배포
Azure Portal을 사용하여 Azure API for FHIR 인스턴스를 배포하기 위한 빠른 시작 가이드의 단계를 참조하세요. PowerShell, CLI 및 ARM 템플릿을 사용하여 Azure API for FHIR 인스턴스를 배포할 수도 있습니다.
Azure API for FHIR 액세스
의료 데이터를 사용하는 경우 데이터가 안전하고 권한이 없는 사용자 또는 애플리케이션에서 액세스할 수 없도록 하는 것이 중요합니다. FHIR 서버는 이 데이터 보안을 위해 OAuth 2.0을 사용합니다. Azure API for FHIR는 OAuth 2.0 ID 공급자의 한 예인 Microsoft Entra ID를 사용하여 보호됩니다. Azure API for FHIR에 대한 Microsoft Entra ID 구성은 FHIR 서버 권한 부여에 대한 개요와 FHIR 서버에 액세스하기 위한 토큰을 가져오는 데 필요한 단계를 제공합니다. 이러한 단계는 FHIR 서버 및 모든 ID 공급자에 적용되지만, 이 문서에서는 FHIR 서버로서의 Azure API for FHIR 및 Microsoft Entra ID를 ID 공급자로 다룹니다. Azure API for FHIR에 액세스하는 방법에 대한 자세한 내용은 액세스 제어 개요를 참조하세요.
액세스 토큰 유효성 검사
Azure API for FHIR에서 액세스 토큰의 유효성을 검사하는 방법은 구현 및 구성에 따라 달라집니다. Azure API for FHIR 액세스 토큰 유효성 검사 문서에서는 액세스 문제를 해결할 때 유용할 수 있는 유효성 검사 단계를 안내합니다.
클라이언트 애플리케이션 등록
애플리케이션이 Microsoft Entra ID와 상호 작용하려면 등록이 필요합니다. FHIR 서버의 컨텍스트에서는 두 가지 종류의 애플리케이션 등록이 있습니다.
- 리소스 애플리케이션 등록,
- 클라이언트 애플리케이션 등록
두 가지 종류의 애플리케이션 등록에 대한 자세한 내용은 Azure API for FHIR에 Microsoft Entra 앱 등록을 참조하세요.
Azure RBAC for FHIR 구성
Azure RBAC for FHIR 구성 문서에서는 Azure RBAC(Azure 역할 기반 액세스 제어)를 사용하여 Azure API for FHIR 데이터 평면에 대한 액세스 권한을 할당하는 방법을 설명합니다. Azure RBAC는 데이터 평면 사용자가 Azure 구독과 연결된 Microsoft Entra 테넌트에서 관리될 때 데이터 평면 액세스를 할당하는 데 선호되는 방법입니다. 외부 Microsoft Entra 테넌트를 사용하는 경우 로컬 RBAC 할당 참조를 참조하세요.
다음 단계
이 문서에서는 Azure API for FHIR을 사용하기 시작하는 기본 단계를 설명했습니다. Azure API for FHIR에 대한 자세한 내용은 다음을 참조하세요.
참고 항목
FHIR®은 HL7의 등록 상표이며, HL7의 사용 허가 하에 사용됩니다.