Lägga till anpassade HTTP-huvuden i granskningsloggar i FHIR-tjänsten
Viktigt!
Azure API för FHIR avvecklas den 30 september 2026. Följ migreringsstrategierna för att övergå till Azure Health Data Services FHIR-tjänsten® senast det datumet. På grund av tillbakadragandet av Azure API för FHIR tillåts inte nya distributioner från och med den 1 april 2025. Azure Health Data Services FHIR-tjänsten är den utvecklade versionen av Azure API för FHIR som gör det möjligt för kunder att hantera FHIR-, DICOM- och MedTech-tjänster med integreringar i andra Azure-tjänster.
I API:et för Azure Fast Healthcare Interoperability Resources (FHIR®) kanske en användare vill inkludera ytterligare information i loggarna, som kommer från det anropande systemet.
När till exempel användaren av API:et autentiseras av ett externt system vidarebefordrar systemet anropet till FHIR-API:et. På FHIR API-lagret går informationen om den ursprungliga användaren förlorad eftersom anropet vidarebefordrades. Det kan vara nödvändigt att logga och behålla den här användarinformationen i gransknings- eller hanteringssyfte. Det anropande systemet kan tillhandahålla användaridentitet, uppringarplats eller annan nödvändig information i HTTP-huvudena, som överförs när samtalet vidarebefordras.
Du kan använda anpassade rubriker för att samla in flera typer av information. Till exempel:
- Identitets- eller auktoriseringsinformation
- Uppringarens ursprung
- Ursprunglig organisation
- Information om klientsystem (elektronisk hälsojournal, patientportal)
Viktigt!
Tänk på att informationen som skickas i anpassade huvuden lagras i ett internt Microsoft-loggningssystem i 30 dagar efter att den har varit tillgänglig i Azure Log Monitoring. Vi rekommenderar att du krypterar all information innan du lägger till den i anpassade rubriker. Du bör inte skicka någon PHI-information via kundhuvuden.
Du måste använda följande namngivningskonvention för dina HTTP-huvuden: X-MS-AZUREFHIR-AUDIT-name<>.
Dessa HTTP-huvuden ingår i en egenskapsväska som läggs till i loggen. Till exempel:
- X-MS-AZUREFHIR-AUDIT-USERID: 1234
- X-MS-AZUREFHIR-AUDIT-USERLOCATION: XXXX
- X-MS-AZUREFHIR-AUDIT-XYZ: 1234
Den här informationen serialiseras sedan till JSON när den läggs till i egenskapskolumnen i loggen. Till exempel:
{ "X-MS-AZUREFHIR-AUDIT-USERID" : "1234",
"X-MS-AZUREFHIR-AUDIT-USERLOCATION" : "XXXX",
"X-MS-AZUREFHIR-AUDIT-XYZ" : "1234" }
Precis som med alla HTTP-huvuden kan samma rubriknamn upprepas med olika värden. Till exempel:
- X-MS-AZUREFHIR-AUDIT-USERLOCATION: HospitalA
- X-MS-AZUREFHIR-AUDIT-USERLOCATION: Emergency
När de läggs till i loggen kombineras värdena med en kommaavgränsad lista. Till exempel:
{ "X-MS-AZUREFHIR-AUDIT-USERLOCATION" : "HospitalA, Emergency" }
Du kan lägga till högst 10 unika rubriker (upprepningar av samma rubrik med olika värden räknas bara som en). Den totala maximala längden på värdet för en rubrik är 2 048 tecken.
Om du använder Firefly C#-klient-API-biblioteket ser koden ut ungefär så här:
FhirClient client;
client = new FhirClient(serverUrl);
client.OnBeforeRequest += (object sender, BeforeRequestEventArgs e) =>
{
// Add custom headers to be added to the logs
e.RawRequest.Headers.Add("X-MS-AZUREFHIR-AUDIT-UserLocation", "HospitalA");
};
client.Get("Patient");
Nästa steg
I den här artikeln har du lärt dig hur du lägger till data i granskningsloggar med hjälp av anpassade rubriker i Azure API för FHIR. Information om konfigurationsinställningar för Azure API för FHIR finns i
FHIR® är ett registrerat varumärke som tillhör HL7 och används med tillstånd av HL7.