Postman을 사용 하 여 액세스

중요

Azure 의료 Api는 현재 미리 보기로 제공 됩니다. Microsoft Azure 미리 보기에 대한 추가 사용 약관에는 베타 또는 미리 보기로 제공되거나 아직 일반 공급으로 릴리스되지 않은 Azure 기능에 적용되는 추가 약관이 포함되어 있습니다.

이 문서에서는 사후 man을 사용 하 여 의료 api fhir 서비스 (fhir 서비스 라고 함)에 액세스 하는 단계를 안내 합니다.

사전 요구 사항

  • Azure에 배포 된 FHIR 서비스입니다. FHIR 서비스를 배포 하는 방법에 대 한 자세한 내용은 canr 서비스 배포를 참조 하세요.
  • FHIR 서비스에 액세스 하기 위한 등록 된 클라이언트 응용 프로그램입니다. 클라이언트 응용 프로그램을 등록 하는 방법에 대 한 자세한 내용은 Azure Active Directory에서 서비스 클라이언트 응용 프로그램 등록을 참조 하세요.
  • 클라이언트 응용 프로그램에 부여 된 사용 권한 및 사용자 계정 (예: "FHIR 데이터 참가자")은 FHIR 서비스에 액세스 합니다.
  • Postman을 로컬로 설치 했습니다. postman에 대 한 자세한 내용은 postman을 사용 하 여 시작를 참조 하세요.

Postman 사용: 작업 영역, 컬렉션 및 환경 만들기

Postman을 처음 접하는 경우 다음 단계를 수행 합니다. 그렇지 않으면 이 단계를 건너뛸 수 있습니다.

Postman은 사용자와 사용자의 팀이 Api, 컬렉션, 환경 및 기타 구성 요소를 공유할 수 있도록 작업 영역 개념을 소개 합니다. 기본 "내 작업 영역" 또는 "팀 작업 영역"을 사용 하거나 사용자 또는 팀에 대 한 새 작업 영역을 만들 수 있습니다.

Screenshot of create a new workspace in Postman.

다음으로 관련 된 모든 REST API 요청을 그룹화 할 수 있는 새 컬렉션을 만듭니다. 작업 영역에서 컬렉션 만들기를 선택 합니다. 기본 이름을 새 컬렉션 으로 유지 하거나 이름을 바꿀 수 있습니다. 변경 사항이 자동으로 저장됩니다.

Screenshot of create a new collection.

Postman 컬렉션을 가져오고 내보낼 수도 있습니다. 자세한 내용은 Postman 설명서를 참조 하세요.

Screenshot of import data.

환경 변수 만들기 또는 업데이트

요청에서 전체 url을 사용할 수 있지만, url 및 기타 데이터를 변수에 저장 하 고이를 사용 하는 것이 좋습니다.

FHIR 서비스에 액세스 하려면 다음 변수를 만들거나 업데이트 해야 합니다.

  • tenantid – FHIR 서비스가 배포 되는 Azure 테 넌 트입니다. 응용 프로그램 등록 개요 메뉴 옵션에서 찾을 수 있습니다.
  • subid – FHIR 서비스가 배포 되는 Azure 구독입니다. 이는 Fhir 서비스 개요 메뉴 옵션에서 찾을 수 있습니다.
  • clientid – 응용 프로그램 클라이언트 등록 ID입니다.
  • clientsecret – 응용 프로그램 클라이언트 등록 암호입니다.
  • fhirurl – fanr 서비스 전체 URL입니다. 예들 들어 https://xxx.azurehealthcareapis.com입니다. 이는 Fhir 서비스 개요 메뉴 옵션에서 찾을 수 있습니다.
  • bearerToken – 스크립트에 Azure Active Directory (Azure AD) 액세스 토큰을 저장 하는 변수입니다. 비워 둠

참고

클라이언트 응용 프로그램 등록에서 리디렉션 URL를 구성 했는지 확인 https://www.getpostman.com/oauth2/callback 합니다.

Screenshot of environments variable.

FHIR 서버에 커넥트

Postman을 열고 사용 하려는 작업 영역, 컬렉션환경을 선택 합니다. 아이콘을 선택 + 하 여 새 요청을 만듭니다.

Screenshot of create a new request.

Get 기능 문

{{fhirurl}}/metadataGET 요청에를 입력 하 고 적중 Send 합니다. FHIR 서비스의 기능 문이 표시 되어야 합니다.

Screenshot of capability statement parameters.

Screenshot of save request.

Azure AD 액세스 토큰 가져오기

FHIR 서비스는 Azure AD에 의해 보호 됩니다. 기본 인증을 사용 하지 않도록 설정할 수 없습니다. FHIR 서비스에 액세스 하려면 먼저 Azure AD 액세스 토큰을 가져와야 합니다. 자세한 내용은 Microsoft ID 플랫폼 액세스 토큰을 참조 하세요.

새 요청을 만듭니다 POST .

  1. 요청 헤더에를 입력 합니다. https://login.microsoftonline.com/{{tenantid}}/oauth2/token

  2. 본문 탭을 선택 하 고 x-www-form-urlencoded를 선택 합니다. 키 및 값 섹션에서 다음 값을 입력 합니다.

    • grant_type:
    • client_id:
    • client_secret:
    • 리소스:
  3. 테스트 탭을 선택 하 고 텍스트 섹션에를 입력 합니다.

  4. 저장을 선택하여 설정을 저장합니다.

  5. 보내기를 누릅니다. 변수에 자동으로 저장 되는 Azure AD 액세스 토큰과의 응답이 표시 됩니다 bearerToken . 그런 다음 모든 FHIR 서비스 API 요청에서 사용할 수 있습니다.

Screenshot of send button.

와 같은 온라인 도구를 사용 하 여 액세스 토큰을 검사할 수 있습니다 https://jwt.ms . 토큰의 각 클레임에 대 한 자세한 설명을 보려면 클레임 탭을 선택 합니다.

Screenshot of access token claims.

리소스 가져오기

Azure AD 액세스 토큰을 가져온 후에는 FHIR 데이터에 액세스할 수 있습니다. 새 요청에 GET 를 입력 {{fhirurl}}/Patient 합니다.

전달자 토큰 을 권한 부여 유형으로 선택 합니다. {{bearerToken}}{{bearerToken}} 섹션에를 입력 합니다. 보내기를 선택합니다. 응답으로 FHIR 리소스에 환자 목록이 표시 됩니다.

Screenshot of select bearer token.

FHIR 리소스 만들기 또는 업데이트

Azure AD 액세스 토큰을 가져온 후에는 FHIR 데이터를 만들거나 업데이트할 수 있습니다. 예를 들어 새 환자를 만들거나 기존 환자를 업데이트할 수 있습니다.

새 요청을 만들고, 메서드를 "Post"로 변경 하 고, 요청 섹션에 값을 입력 합니다.

{{fhirurl}}/Patient

권한 부여 유형으로 전달자 토큰 을 선택 합니다. {{bearerToken}}{{bearerToken}} 섹션에를 입력 합니다. 본문 탭을 선택 합니다. 원시 옵션 및 JSON 을 본문 텍스트 형식으로 선택 합니다. 본문 섹션에 텍스트를 복사 하 여 붙여 넣습니다.

{
    "resourceType": "Patient",
    "active": true,
    "name": [
        {
            "use": "official",
            "family": "Kirk",
            "given": [
                "James",
                "Tiberious"
            ]
        },
        {
            "use": "usual",
            "given": [
                "Jim"
            ]
        }
    ],
    "gender": "male",
    "birthDate": "1960-12-25"
}

보내기를 선택합니다. JSON 응답에 새 환자가 표시 되어야 합니다.

Screenshot of send button to create a new patient.

FHIR 데이터 내보내기

Azure AD 액세스 토큰을 가져온 후에는 Azure storage 계정으로 FHIR 데이터를 내보낼 수 있습니다.

새 요청을 만듭니다 GET . {{fhirurl}}/$export?_container=export

전달자 토큰 을 권한 부여 유형으로 선택 합니다. {{bearerToken}}{{bearerToken}} 섹션에를 입력 합니다. 헤더 를 선택 하 여 두 개의 새 헤더를 추가 합니다.

  • 수락:
  • 선호:

보내기를 누릅니다. 응답을 확인 해야 합니다 202 Accepted . 응답의 헤더 탭을 선택 하 고 콘텐츠 위치의값을 기록 합니다. 값을 사용 하 여 내보내기 작업 상태를 쿼리할 수 있습니다.

Screenshot of post to create a new patient 202 accepted response.

다음 단계

이 문서에서는 Postman을 사용 하 여 Azure 의료 Api에서 FHIR 서비스에 액세스 하는 방법을 배웠습니다. Azure 의료 Api의 FHIR 서비스에 대 한 자세한 내용은을 참조 하세요.