HealthRecordCommunity
FHIR🌏 InternationalπŸ› FirelyEnriched

FHIR User Lookup Mechanism: Understanding the $fhirUser-lookup Operation

FHIR User Lookup - $fhirUser-lookup β€” Firely Server documentation - Firely Docs

October 14, 2026Firely

Summary

This article explains the $fhirUser-lookup custom operation, which improves the process of searching for FHIR users. This allows the authentication system (Firely Auth) to identify users more flexibly and accurately.

Details

This document is a technical specification detailing the functionality and implementation of the $fhirUser-lookup custom operation within Firely Server. Previously, user identification during Single Sign-On (SSO) relied on system-level searches based on Identity Provider claims, which faced limitations such as ambiguous search results or the inability to utilize all available claim data. By introducing this new operation, Firely Auth delegates user lookup to Firely Server, enabling more advanced search processing. The flow involves converting claims into FHIR search parameters and sending a POST request for SSO users, or passing parameters for locally created users. This plugin also supports custom implementations for advanced scenarios, such as integrating with an external Master Patient Index (MPI). The operation's availability must be confirmed via the CapabilityStatement.

πŸ“°
Read Original Article
docs.fire.ly
β†’

Original content copyright by respective publishers