Epic EHR 구성

이 페이지에서는 Epic EHR 데이터 스토어를 만들기 전에 Epic 앱을 등록하고 구성하는 방법을 설명합니다. 조직에서 자체 Epic 앱을 등록합니다. 일반적으로 Epic 분석가가 이 단계를 완료합니다.

Epic 앱 등록

Epic on FHIR에서 Gemini Enterprise용 앱을 등록하고 Epic 환경에서 사용할 수 있도록 합니다. 다음 설정을 사용하세요.

설정 값
애플리케이션 대상 임상의 또는 관리 권한 사용자
수신 API Epic API 사용 설정에 나열된 R4 API
발신 API 없음
이 앱에서 동적 클라이언트를 등록하나요? 아니요
기밀 클라이언트 여부 예
지속적인 액세스 필요 예
순환 갱신 토큰 사용 예
JWK 세트 URL 비워 두기
SMART on FHIR 버전 R4
SMART 범위 버전 SMART v1
FHIR ID 생성 스키마 USCDI FHIR 리소스에 64자 제한 FHIR ID 사용

앱에 대한 조직의 영구 액세스 설정에 따라 사용자의 승인 지속 시간이 결정됩니다. 이 기간이 종료되면 사용자가 커넥터를 다시 승인합니다.

리디렉션 URI 설정

앱에서 다음 리디렉션 URI를 모두 표시된 대로 정확하게 등록합니다.

  • https://vertexaisearch.cloud.google.com/oauth-redirect
  • https://vertexaisearch.cloud.google.com/console/oauth/default_oauth.html

Epic API 사용 설정

앱에서 Patient, Observation, Condition, MedicationRequest, AllergyIntolerance, DiagnosticReport, DocumentReference, Binary, Encounter, ServiceRequest, Coverage, Immunization, Procedure FHIR 리소스에 대해 R4 읽기 및 검색 API를 사용 설정합니다.

관찰 및 조건과 같은 일부 리소스에는 실험실 및 활력 징후와 같은 각 카테고리에 대한 별도의 API가 있습니다. 사용자가 쿼리할 카테고리를 사용 설정합니다. 쓰기 API를 사용 설정하지 않습니다.

API가 사용 설정되지 않은 경우 해당 API를 사용하는 작업만 실패합니다.

클라이언트 ID 및 클라이언트 보안 비밀번호 가져오기

Epic은 앱에 비프로덕션 클라이언트 ID와 프로덕션 클라이언트 ID를 발급합니다. URL이 가리키는 Epic 환경과 일치하는 클라이언트 ID를 사용합니다. 앱은 기밀 클라이언트이므로 클라이언트 보안 비밀번호도 있습니다. 데이터 스토어를 만들 때 클라이언트 ID와 클라이언트 보안 비밀번호를 입력합니다.

Epic 엔드포인트 찾기

데이터 스토어를 만들려면 Epic 환경의 URL 3개(FHIR R4 기준 URL, 승인 URL, 토큰 URL)가 필요합니다. Epic 분석가가 제공할 수 있습니다. FHIR_BASE_URL/.well-known/smart-configuration에 있는 조직의 SMART 구성에는 승인 URL (authorization_endpoint)과 토큰 URL(token_endpoint)도 나열됩니다. FHIR_BASE_URL를 FHIR R4 기준 URL로 바꿉니다.

각 URL을 https://로 입력하고 후행 슬래시를 포함하지 않습니다. 예를 들어 Epic의 공개 샌드박스는 다음 URL을 사용합니다.

URL Epic 샌드박스 예시
FHIR R4 기준 URL https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4
승인 URL https://fhir.epic.com/interconnect-fhir-oauth/oauth2/authorize
토큰 URL https://fhir.epic.com/interconnect-fhir-oauth/oauth2/token

문제 해결

다음 표에는 일반적인 문제와 해결 방법이 나와 있습니다.

문제 해결 방법
콘솔에 다음 메시지 중 하나가 표시됩니다.
  • "Epic FHIR R4 URL은 후행 슬래시가 없는 https:// URL이어야 합니다."
  • 'Epic 승인 URL은 후행 슬래시가 없는 https:// URL이어야 합니다.'
  • "Epic 토큰 URL은 후행 슬래시가 없는 https:// URL이어야 합니다."
 https://를 포함하고 후행 슬래시가 없는 URL을 입력합니다.
콘솔에 '갱신 토큰을 가져올 수 없습니다.'가 표시됩니다. Epic 앱에서 Is Confidential Client 및 Requires Persistent Access를 선택하고 변경사항을 저장합니다. 그런 다음 Google Cloud 콘솔에서 인증 확인을 다시 클릭합니다.
Epic에서 리디렉션 URI가 일치하지 않는다고 보고합니다. 리디렉션 URI 설정에 표시된 대로 두 리디렉션 URI를 모두 등록합니다.
로그인 중에 Epic에 '잘못된 OAuth 2.0 요청'이 표시됩니다. 각 Epic 로그인 링크는 한 번만 작동하므로 로그인 창을 새로고침하면 이 오류가 표시됩니다. 창을 닫고 새로고침하지 않고 다시 로그인을 시작합니다. 오류가 계속 발생하면 앱에 요청된 범위의 API가 있는지 확인합니다.
Epic에서 invalid_client를 반환합니다. 클라이언트 ID 또는 클라이언트 보안 비밀번호가 잘못되었거나, 공백이 추가되었거나, 다른 Epic 환경에 속합니다. URL이 가리키는 환경의 클라이언트 ID와 클라이언트 보안 비밀번호를 입력합니다.
로그인 창이 Gemini Enterprise로 돌아가지 않거나 로그인 후 커넥터가 승인되지 않습니다. 로그인 창을 닫고 Gemini Enterprise를 새로고침한 후 커넥터를 다시 승인합니다.
한 작업은 실패하고 다른 작업은 작동합니다. 해당 작업의 Epic API가 사용 설정되지 않았습니다. 앱에서 사용 설정한 후 사용자가 커넥터를 다시 승인하도록 합니다.
Gemini Enterprise에서 '죄송합니다. 이 작업을 수행할 권한이 없는 것 같습니다. 관리자에게 문의하세요.'라는 오류 메시지가 표시됩니다. 사용자의 Epic 승인이 종료되었습니다. 사용자가 커넥터를 다시 승인합니다.
Gemini Enterprise는 이름으로 환자를 찾지 않습니다. 생년월일을 추가하거나 MRN 또는 Epic 환자 ID를 사용합니다.
Gemini Enterprise에서 일부 레코드를 가져올 수 없다고 표시됩니다. Epic 보안은 사용자에게 이러한 기록을 공개하지 않습니다. 사용자는 Epic에서 허용하는 레코드만 볼 수 있습니다.
보고서 또는 메모의 텍스트를 사용할 수 없습니다. 문서가 PDF 또는 커넥터가 읽을 수 없는 다른 형식입니다. Epic에서 문서를 엽니다.
하나의 앱에서만 승인이 계속 실패합니다. 앱에서 Epic EHR 데이터 스토어를 삭제하고 다시 추가한 후 커넥터를 다시 승인합니다.

다음 단계