Visual Studio Code에서 REST 클라이언트 확장을 사용하여 Azure Health Data Services에 액세스
이 문서에서는 Visual Studio Code에서 REST 클라이언트 확장을 사용하여 Azure Health Data Services에 액세스하는 방법을 알아봅니다.
REST 클라이언트 확장 설치
Visual Studio Code의 왼쪽 패널에서 확장 아이콘을 선택하고 "REST 클라이언트"를 검색합니다. REST 클라이언트 확장을 찾아 설치합니다.
.http 파일 만들기 및 변수 정의
Visual Studio Code에 새 파일을 만듭니다. 파일에 GET 요청 명령줄을 입력하고 test.http로 저장합니다. 파일 접미사 .http는 REST 클라이언트 환경을 자동으로 활성화합니다. Send Request를 선택하여 메타데이터를 가져옵니다.
클라이언트 애플리케이션 값 가져오기
Important
FHIR 서버 REST API(메타데이터 가져오기 이외)를 호출하기 전에 애플리케이션 등록을 완료해야 합니다. Azure 테넌트 ID, 클라이언트 ID, 클라이언트 암호 및 서비스 URL을 기록해 둡니다.
REST API 호출에서 클라이언트 ID와 같은 값을 직접 사용할 수 있지만 이러한 값에 대한 몇 가지 변수를 정의하고 대신 변수를 사용하는 것이 좋습니다.
test.http 파일에 애플리케이션 등록에서 가져온 다음 정보를 포함합니다.
### REST Client
@fhirurl =https://xxx.azurehealthcareapis.com
@clientid =xxx....
@clientsecret =xxx....
@tenantid =xxx....
Microsoft Entra 액세스 토큰 가져오기
test.http 파일에 다음 정보를 포함하면 Send Request를 누릅니다. 액세스 토큰이 포함된 HTTP 응답이 표시됩니다.
@name을 시작하는 줄에는 액세스 토큰이 포함된 HTTP 응답을 캡처하는 변수가 포함됩니다. @token 변수는 액세스 토큰을 저장하는 데 사용됩니다.
참고 항목
client_credentials의 grant_type은 액세스 토큰을 가져오는 데 사용됩니다.
### Get access token
# @name getAADToken
POST https://login.microsoftonline.com/{{tenantid}}/oauth2/token
Content-Type: application/x-www-form-urlencoded
grant_type=client_credentials
&resource={{fhirurl}}
&client_id={{clientid}}
&client_secret={{clientsecret}}
### Extract access token from getAADToken request
@token = {{getAADToken.response.body.access_token}}
참고 항목
FHIR 서비스 대상 그룹 매개 변수가 FHIR 서비스 엔드포인트 URL에 매핑되지 않는 시나리오에서 리소스 매개 변수 값은 FHIR 서비스 인증 블레이드의 대상 그룹 값에 매핑되어야 합니다.
GET FHIR 환자 데이터
이제 GET 요청으로 환자나 특정 환자의 목록을 가져올 수 있습니다. Authorization 줄은 GET 요청의 헤더 정보입니다. PUT 또는 POST 요청을 보내 FHIR 리소스를 만들거나 업데이트할 수도 있습니다.
### GET Patient
GET {{fhirurl}}/Patient/<patientid>
Authorization: Bearer {{token}}
PowerShell 또는 CLI 실행
Visual Studio Code 내에서 PowerShell 또는 CLI 스크립트를 실행할 수 있습니다. CTRL 및 ~ 키를 누르고 PowerShell 또는 Bash를 선택합니다. 통합 터미널에 대한 자세한 내용을 확인할 수 있습니다.
Visual Studio Code에서 PowerShell
Visual Studio Code에서 CLI
문제 해결
HL7 사양에 따라 액세스 토큰이 필요하지 않은 메타데이터를 가져올 수 없으면 FHIR 서버가 제대로 실행되고 있는지 확인합니다.
액세스 토큰을 가져올 수 없으면 클라이언트 애플리케이션이 올바르게 등록되어 있고 애플리케이션 등록 단계에서 올바른 값을 사용하고 있는지 확인합니다.
FHIR 서버에서 데이터를 가져올 수 없으면 클라이언트 애플리케이션(또는 서비스 주체)에게 FHIR 서버에 대한 "FHIR 데이터 기여자"와 같은 액세스 권한이 부여되었는지 확인합니다.
다음 단계
이 문서에서는 Visual Studio Code에서 REST 클라이언트 확장을 사용하여 Azure Health Data Services 데이터에 액세스하는 방법을 알아봅니다.
Azure Health Data Services에서 프로필에 대해 FHIR 리소스 유효성을 검사하는 방법은 다음을 참조하세요.
FHIR®은 HL7의 등록 상표이며, HL7의 사용 허가 하에 사용됩니다.