Azure API for FHIR에 대한 Azure Active Directory 앱 등록

Azure API for FHIR 또는 FHIR Server for Azure(OSS)를 설정할 때 선택할 수 있는 몇 가지 구성 옵션이 있습니다. 오픈 소스의 경우 사용자 고유의 리소스 애플리케이션 등록을 만들어야 합니다. Azure API for FHIR의 경우 이 리소스 애플리케이션은 자동으로 생성됩니다.

애플리케이션 등록

애플리케이션이 Azure AD와 상호 작용하려면 등록해야 합니다. FHIR 서버의 컨텍스트에서는 다음과 같은 두 가지 종류의 애플리케이션 등록을 설명합니다.

  1. 리소스 애플리케이션 등록
  2. 클라이언트 애플리케이션 등록

리소스 애플리케이션은 API의 Azure AD 또는 Azure AD로 보안되는 리소스의 표현이며, 특히 Azure API for FHIR이 있습니다. Azure API for FHIR에 대한 리소스 애플리케이션은 서비스를 프로비저닝할 때 자동으로 생성되지만, 오픈 소스 서버를 사용하는 경우 Azure AD에서 리소스 애플리케이션을 등록해야 합니다. 이 리소스 애플리케이션에는 식별자 URI가 있습니다. 이 URI는 FHIR 서버의 URI와 동일하게 하는 것이 좋습니다. 이 URI는 FHIR 서버에 대한 Audience로 사용되어야 합니다. 클라이언트 애플리케이션은 토큰을 요청할 때 이 FHIR 서버에 대한 액세스를 요청할 수 있습니다.

클라이언트 애플리케이션은 토큰을 요청하는 클라이언트의 등록입니다. 일반적으로 OAuth 2.0에서는 다음과 같은 세 가지 유형의 애플리케이션을 구분합니다.

  1. 기밀 클라이언트. Azure AD에서 웹앱이라고도 합니다. 기밀 클라이언트는 권한 부여 코드 흐름을 사용하여 유효한 자격 증명을 제시하는 로그인한 사용자를 대신하여 토큰을 가져오는 애플리케이션입니다. 비밀을 보유할 수 있고 토큰에 대한 인증 코드를 교환할 때 Azure AD 이 비밀을 표시하기 때문에 기밀 클라이언트라고 합니다. 기밀 클라이언트는 클라이언트 암호를 사용하여 인증할 수 있으므로 퍼블릭 클라이언트보다 더 신뢰할 수 있으며 수명이 긴 토큰을 가질 수 있으며 새로 고침 토큰을 부여할 수 있습니다. 기밀 클라이언트를 등록하는 방법에서 자세한 내용을 알아보세요. 클라이언트가 권한 부여 코드를 받을 회신 URL을 등록하는 것이 중요합니다.
  2. 클라이언트. 이들은 비밀을 유지할 수 없는 클라이언트입니다. 일반적으로 사용자가 클라이언트의 비밀을 검색할 수 있는 모바일 디바이스 애플리케이션 또는 단일 페이지 JavaScript 애플리케이션이 있습니다. 공용 클라이언트는 권한 부여 코드 흐름도 사용하지만 토큰을 가져올 때 비밀을 표시할 수 없으며 수명이 짧은 토큰과 새로 고침 토큰이 없을 수 있습니다. 퍼블릭 클라이언트를 등록하는 방법에서 자세한 내용을 알아보세요.
  3. 서비스 클라이언트. 이러한 클라이언트는 클라이언트 자격 증명 흐름을 사용하여 본인(사용자 대신이 아님)을 대신하여 토큰을 가져옵니다. 일반적으로 비 대화형 방법으로 FHIR 서버에 액세스하는 애플리케이션을 나타냅니다. 예를 들면 수집 프로세스가 있습니다. 서비스 클라이언트를 사용하는 경우 엔드포인트에 대한 호출 /authorize 을 사용하여 토큰을 가져오는 프로세스를 시작할 필요가 없습니다. 서비스 클라이언트는 /token 엔드포인트로 바로 이동하고 클라이언트 ID 및 클라이언트 암호를 제공하여 토큰을 가져올 수 있습니다. 서비스 클라이언트를 등록하는 방법에서 자세한 내용을 알아보세요.

다음 단계

이 개요에서는 FHIR API를 사용하는 데 필요한 애플리케이션 등록 유형을 살펴보았습니다.

설정에 따라 애플리케이션을 등록하는 방법 가이드를 참조하세요.

애플리케이션을 등록한 후에는 Azure API for FHIR을 배포할 수 있습니다.

FHIR®은 HL7의 등록 상표이며 HL7 의 권한으로 사용됩니다.