בדף הזה מוסבר איך להסיר פרטי זיהוי ממידע אישי רגיש במשאבי FHIR באמצעות Cloud Healthcare API ברמות הבאות:
- ברמת מערך הנתונים באמצעות
datasets.deidentify - ברמת מאגר FHIR באמצעות
fhirStores.deidentify
בדף הזה מוסבר גם איך להחיל מסננים כשמבטלים את זיהוי הנתונים ברמת מאגר FHIR.
סקירה כללית על הסרת פרטי הזיהוי
הסרת פרטי הזיהוי ברמת מערך הנתונים
כדי להסיר את הפרטים המזהים מנתוני FHIR ברמת מערך הנתונים, קוראים לפעולה datasets.deidentify. קריאה ל-API להסרת פרטי הזיהוי כוללת את הרכיבים הבאים:
- קבוצת נתוני המקור: קבוצת נתונים שמכילה מאגרי FHIR עם משאב אחד או יותר שכוללים מידע אישי רגיש.
- מערך הנתונים של היעד: הסרת פרטי הזיהוי לא משפיעה על מערך הנתונים המקורי או על הנתונים שבו. במקום זאת, עותקים של הנתונים המקוריים שעברו הסרת פרטים מזהים נכתבים למערך נתונים חדש שנקרא מערך נתוני היעד.
- מה רוצים להסיר את פרטי הזיהוי שלו: פרמטרים של הגדרה שמציינים איך לעבד את מערך הנתונים. אפשר להגדיר את הפרמטרים האלה על ידי ציון שלהם ב-
FhirConfigאו ב-TextConfigבתוך האובייקטDeidentifyConfigוהעברה שלו באחת מהדרכים הבאות:- הגדרת השדה
configבגוף הבקשה - אחסון שלו ב-Cloud Storage בפורמט JSON וציון המיקום של הקובץ בקטגוריה באמצעות השדה
gcsConfigUriבגוף הבקשה
- הגדרת השדה
רוב הדוגמאות במדריך הזה מראות איך לבטל את הזיהוי של נתוני FHIR ברמת מערך הנתונים.
הסרת פרטי הזיהוי ברמת מאגר FHIR
ביטול הזיהוי של נתוני FHIR ברמת מאגר FHIR מאפשר לכם לשלוט טוב יותר בנתוני FHIR שביטול הזיהוי שלהם מתבצע.
כדי להסיר פרטי זיהוי מנתוני FHIR במאגר FHIR, צריך להפעיל את method fhirStores.deidentify. קריאה ל-API של הסרת פרטים מזהים כוללת את הרכיבים הבאים:
- מאגר FHIR המקור: מאגר FHIR שמכיל משאב אחד או יותר עם מידע אישי רגיש.
- מאגר ה-FHIR של היעד: ביטול הזיהוי לא משפיע על מאגר ה-FHIR המקורי או על הנתונים שלו. במקום זאת, עותקים שעברו דה-אינדניפיקציה של הנתונים המקוריים נכתבים בחנות היעד של FHIR. מאגר היעד של FHIR צריך כבר להתקיים.
- מה להסיר מהזיהוי: פרמטרים של הגדרה שמציינים איך לעבד את מאגר FHIR. אפשר להגדיר את הפרמטרים האלה על ידי ציון שלהם ב-
FhirConfigאו ב-TextConfigבתוך האובייקטDeidentifyConfigוהעברה שלו באחת מהדרכים הבאות:- הגדרת השדה
configבגוף הבקשה - אחסון שלו ב-Cloud Storage בפורמט JSON וציון המיקום של הקובץ בקטגוריה באמצעות השדה
gcsConfigUriבגוף הבקשה
- הגדרת השדה
דוגמה לאנונימיזציה של נתוני FHIR ברמת מאגר FHIR מופיעה במאמר אנונימיזציה של נתונים ברמת מאגר FHIR.
מסננים
אפשר להסיר את הפרטים המזהים מקבוצת משנה של נתונים במאגר FHIR על ידי ציון רשימה של מזהי משאבי FHIR בבקשת fhirStores.deidentify. לדוגמה, אפשר לעיין במאמר בנושא הסרת פרטים מזהים מקבוצת משנה של מאגר FHIR.
דוגמה למשאב FHIR שמשמש במדריך הזה
בדוגמאות במדריך הזה נעשה שימוש במשאב Patient
(DSTU2,
STU3 ו-R4)
בחנות FHIR. למטופל יש את המאפיינים שמוצגים בדוגמה הבאה. הערך id נוצר על ידי השרת. אם יוצרים את משאב המטופל בחנות FHIR משלכם, הערך id שמוחזר שונה מהערך שמוצג בדוגמה של המטופל.
{
"address": [
{
"city": "Anycity",
"district": "Anydistrict",
"line": [
"123 Main Street"
],
"period": {
"start": "1990-12-05"
},
"postalCode": "12345",
"state": "CA",
"text": "123 Main Street Anycity, Anydistrict, CA 12345",
"type": "both",
"use": "home"
}
],
"birthDate": "1980-12-05",
"gender": "female",
"id": "r77433dd-dkeuc-633743nfd-383nfdsjds732",
"name": [
{
"family": "Smith",
"given": [
"Darcy"
],
"use": "official"
}
],
"resourceType": "Patient",
"text": {
"status": "generated",
"div": "<div><p><b>Patient</b></p><p><b>Name</b>: Smith, Darcy</p><p><b>DateOfBirth</b>: 1980-12-05</p><p><b>Gender</b>: Female</p></div>"
}
}
הסרת פרטי הזיהוי מנתוני FHIR כברירת מחדל
אתם יכולים להסיר את הפרטים המזהים מנתוני FHIR באמצעות שיטת 'ברירת מחדל' שמסתירה מידע רפואי מוגן (PHI) נפוץ במשאבים בחנות FHIR. שיטת ברירת המחדל מצנזרת את המידע הבא:
- infoTypes שצוינו בdefault FHIR infoTypes
- נתיבים שצוינו בפרופיל ברירת המחדל להסרת פרטי הזיהוי ב-FHIR
בדוגמאות הבאות אפשר לראות איך להסיר את הפרטים המזהים מהמשאב Patient באמצעות שיטת ברירת המחדל של FHIR. כשמשתמשים בשיטת ברירת המחדל, משתמשים ב-FhirConfig ריק בתוך אובייקט DeidentifyConfig.
curl
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data "{ 'destinationDataset': 'projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID', 'config': { 'fhir': {} } }" "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
}
get כדי לעקוב אחרי סטטוס הפעולה:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
"done": true.
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
"apiMethodName": "google.cloud.healthcare.v1.dataset.DatasetService.DeidentifyDataset",
"createTime": "CREATE_TIME",
"endTime": "END_TIME",
"logsUrl": "https://console.cloud.google.com/logs/viewer/CLOUD_LOGGING_URL"
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.deidentify.DeidentifySummary",
"successStoreCount": "1",
"successResourceCount": "1"
}
}
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/fhir+json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/DESTINATION_DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient/r77433dd-dkeuc-633743nfd-383nfdsjds732"
{
"address": [
{
"city": "",
"district": "",
"line": [
""
],
"period": {
"start": "1990-12-05"
},
"postalCode": "",
"state": "CA",
"text": "",
"type": "both",
"use": "home"
}
],
"birthDate": "1981-02-24",
"gender": "female",
"id": "r77433dd-dkeuc-633743nfd-383nfdsjds732",
"meta": {
"lastUpdated": "2018-01-01T2018-01-01T00:00:00+00:00",
"versionId": "MTU0MDU4NTcxNjI2MTUxNDAwMA"
},
"name": [
{
"family": "",
"given": [
""
],
"use": "official"
}
],
"resourceType": "Patient",
"text": {
"div": "<div><p><b>Patient</b></p><p><b>Name</b>: [PERSON_NAME][PERSON_NAME][PERSON_NAME]</p><p><b>DateOfBirth</b>: 1981-02-24</p><p><b>Gender</b>: Female</p></div>",
"status": "generated"
}
}
PowerShell
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Post ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Body "{ 'destinationDataset': 'projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID', 'config': { 'fhir': {} } }" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
}
get כדי לעקוב אחרי סטטוס הפעולה:
$cred = gcloud auth print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Get ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content
"done": true.
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_NUMBER",
"metadata": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
"apiMethodName": "google.cloud.healthcare.v1.dataset.DatasetService.DeidentifyDataset",
"createTime": "CREATE_TIME",
"endTime": "END_TIME",
"logsUrl": "https://console.cloud.google.com/logs/viewer/CLOUD_LOGGING_URL"
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.deidentify.DeidentifySummary",
"successStoreCount": "1",
"successResourceCount": "1"
}
}
$cred = gcloud auth print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-RestMethod ` -Method Get ` -Headers $headers ` -ContentType: "application/fhir+json; charset=utf-8" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/DESTINATION_DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient/r77433dd-dkeuc-633743nfd-383nfdsjds732" | ConvertTo-Json
{
"address": [
{
"city": "",
"district": "",
"line": [
""
],
"period": {
"start": "1990-12-05"
},
"postalCode": "",
"state": "CA",
"text": "",
"type": "both",
"use": "home"
}
],
"birthDate": "1981-02-24",
"gender": "female",
"id": "r77433dd-dkeuc-633743nfd-383nfdsjds732",
"meta": {
"lastUpdated": "2018-01-01T2018-01-01T00:00:00+00:00",
"versionId": "MTU0MDU4NTcxNjI2MTUxNDAwMA"
},
"name": [
{
"family": "",
"given": [
""
],
"use": "official"
}
],
"resourceType": "Patient",
"text": {
"div": "<div><p><b>Patient</b></p><p><b>Name</b>: [PERSON_NAME][PERSON_NAME][PERSON_NAME]</p><p><b>DateOfBirth</b>: 1981-02-24</p><p><b>Gender</b>: Female</p></div>",
"status": "generated"
}
}
אפשר לראות שהערכים הבאים עברו טרנספורמציה כדי להסיר את הפרטים המזהים מהמשאב:
- ערך חדש סופק בשדה
birthDateבאמצעות טכניקה של הזזת תאריכים עם הפרש של 100 ימים. - הערך ב
address.cityהוסר. - הערך ב
address.districtהוסר. - הערך ב
address.lineהוסר. - הערך ב
address.postalCodeהוסר. - הערך ב
address.textהוסר. - הערך ב
name.familyהוסר. - הערך ב
name.givenהוסר. - הטקסט החופשי בשדה
text.divשונה כדי להחליף את שם המטופל בinfoType שלו,[PERSON_NAME]. הערך של תאריך הלידה של המטופל עבר המרה באותו אופן שבו עבר המרה הערך בשדהbirthDate.
הסרת פרטי הזיהוי מנתיבי FHIR ספציפיים
כדי לציין אילו נתיבי FHIR יבוצע בהם ביטול הזיהוי ואיך לבצע בהם טרנספורמציה, צריך להגדיר את fieldMetadataList באובייקט FhirConfig.
בתוך fieldMetadataList, מציינים רשימה מופרדת בנקודות של שמות שדות או שמות של סוגי משאבים של FHIR ברשימה paths. בשלב הבא, מציינים ערך Action שיחול על כל מה שמופיע ב-paths. אפשר לעיין בActionמסמכים כדי לראות את הערכים האפשריים.
למידע על הגדרת השדה paths ב-Cloud Healthcare API, אפשר לעיין במאמר paths.
העיצוב של הערכים ב-paths מבוסס על FHIRPath.
פרופיל ברירת המחדל להסרת פרטי הזיהוי ב-FHIR
כברירת מחדל, אם לא מציינים נתיבי FHIR ב-fieldMetadataList, Cloud Healthcare API מחיל את פרופילי הסרת פרטי הזיהוי הבאים כדי לבחור ולשנות נתיבי FHIR. הפרופיל שמוחל תלוי בגרסת FHIR שבה אתם משתמשים. אפשר להרחיב את הקטעים הבאים כדי לראות את הפרופילים של הגרסה שבה אתם משתמשים. אפשר גם להוריד את הפרופילים (DSTU2, STU3 ו-R4).
שימוש בנתיבים כדי להסיר את הפרטים המזהים של משאבים
בדוגמאות הבאות אפשר לראות איך מגדירים את האנונימיזציה של משאב המטופל לפי הקריטריונים הבאים:
- הערכים
HumanName(DSTU2, STU3, ו-R4) של משאב המטופל מקבלים אוטומטית את הערךTRANSFORM(הסתרת מידע). בדוגמה של המטופל, הערכים של HumanName הם"family": "Smith"ו-"given": [ "Darcy" ].
לא מסופקים ערכים אחרים ברשימה paths בתוך fieldMetadataList,
לכן הנתונים הנותרים לא משתנים.
בדוגמאות הבאות אפשר לראות איך להסיר את הפרטים המזהים של ערכי HumanName במשאב Patient:
curl
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data "{ 'destinationDataset': 'projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID', 'config': { 'fhir': { 'fieldMetadataList': [ { 'paths': [ 'Patient.HumanName' ], 'action': 'TRANSFORM' } ] } } }" "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
}
get כדי לעקוב אחרי סטטוס הפעולה:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
"done": true.
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
"apiMethodName": "google.cloud.healthcare.v1.dataset.DatasetService.DeidentifyDataset",
"createTime": "CREATE_TIME",
"endTime": "END_TIME",
"logsUrl": "https://console.cloud.google.com/logs/viewer/CLOUD_LOGGING_URL"
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.deidentify.DeidentifySummary",
"successStoreCount": "1",
"successResourceCount": "1"
}
}
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/fhir+json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/DESTINATION_DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient/r77433dd-dkeuc-633743nfd-383nfdsjds732"
{
"address": [
{
"city": "Anycity",
"district": "Anydistrict",
"line": [
"123 Main Street"
],
"period": {
"start": "1990-12-05"
},
"postalCode": "12345",
"state": "CA",
"text": "123 Main Street Anycity, Anydistrict, CA 12345",
"type": "both",
"use": "home"
}
],
"birthDate": "1980-12-05",
"gender": "female",
"id": "r77433dd-dkeuc-633743nfd-383nfdsjds732",
"meta": {
"lastUpdated": "2018-01-01T2018-01-01T00:00:00+00:00",
"versionId": "MTU0MDU4NTcxNjI2MTUxNDAwMAA"
},
"name": [
{
"family": "",
"given": [
""
],
"use": "official"
}
],
"resourceType": "Patient",
"text": {
"div": "<div><p><b>Patient</b></p><p><b>Name</b>: Smith, Darcy</p><p><b>DateOfBirth</b>: 1980-12-05</p><p><b>Gender</b>: Female</p></div>",
"status": "generated"
}
}
PowerShell
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Post ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Body "{ 'destinationDataset': 'projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID', 'config': { 'fhir': { 'fieldMetadataList': [ { 'paths': [ 'Patient.HumanName' ], 'action': 'TRANSFORM' } ] } } }" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
}
get כדי לעקוב אחרי סטטוס הפעולה:
$cred = gcloud auth print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Get ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content
"done": true.
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_NUMBER",
"metadata": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
"apiMethodName": "google.cloud.healthcare.v1.dataset.DatasetService.DeidentifyDataset",
"createTime": "CREATE_TIME",
"endTime": "END_TIME",
"logsUrl": "https://console.cloud.google.com/logs/viewer/CLOUD_LOGGING_URL"
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.deidentify.DeidentifySummary",
"successStoreCount": "1",
"successResourceCount": "1"
}
}
$cred = gcloud auth print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-RestMethod ` -Method Get ` -Headers $headers ` -ContentType: "application/fhir+json; charset=utf-8" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/DESTINATION_DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient/r77433dd-dkeuc-633743nfd-383nfdsjds732" | ConvertTo-Json
{
"address": [
{
"city": "Anycity",
"district": "Anydistrict",
"line": [
"123 Main Street"
],
"period": {
"start": "1990-12-05"
},
"postalCode": "12345",
"state": "CA",
"text": "123 Main Street Anycity, Anydistrict, CA 12345",
"type": "both",
"use": "home"
}
],
"birthDate": "1980-12-05",
"gender": "female",
"id": "r77433dd-dkeuc-633743nfd-383nfdsjds732",
"meta": {
"lastUpdated": "2018-01-01T2018-01-01T00:00:00+00:00",
"versionId": "MTU0MDU4NTcxNjI2MTUxNDAwMAA"
},
"name": [
{
"family": "",
"given": [
""
],
"use": "official"
}
],
"resourceType": "Patient",
"text": {
"div": "<div><p><b>Patient</b></p><p><b>Name</b>: Smith, Darcy</p><p><b>DateOfBirth</b>: 1980-12-05</p><p><b>Gender</b>: Female</p></div>",
"status": "generated"
}
}
אפשר לראות שהערכים הבאים עברו טרנספורמציה כדי להסיר את הפרטים המזהים מהמשאב:
- הערך ב
name.familyהוסר. - הערך ב
name.givenהוסר.
עם זאת, בניגוד לדוגמה בביטול הזיהוי ב-FHIR כברירת מחדל, שבה בוצע שינוי בפרטים אישיים רגישים נפוצים, לא בוצע שינוי בפרטים address ו-birthDate של המטופל ובטקסט החופשי ב-text.div כי הם לא נוספו לרשימה paths ב-fieldMetadataList.
שימוש ב-infoTypes ובטרנספורמציות פרימיטיביות עם משאבי FHIR
Cloud Healthcare API יכול להשתמש בסוגי מידע (infoTypes) כדי להגדיר את הנתונים שהוא סורק כשמבצעים הסרת פרטים מזהים במשאבי FHIR. סוג מידע (infoType) הוא סוג של מידע אישי רגיש, כמו שם מטופל, כתובת אימייל, מספר טלפון, מספר זיהוי או מספר כרטיס אשראי. סוגי ה-infoType שמשמשים בפעולת הסרת פרטי הזיהוי ב-Cloud Healthcare API כוללים את אלה שנמצאים ב-מניעת אובדן נתונים בענן.
טרנספורמציות פרימיטיביות הן כללים שמשמשים לטרנספורמציה של ערך קלט.
סוגי מידע שמוגדרים כברירת מחדל ב-FHIR
סוגי המידע שמשמשים כברירת מחדל לביטול הזיהוי של נתוני FHIR הם:
AGECREDIT_CARD_NUMBERDATEEMAIL_ADDRESSIP_ADDRESSLOCATIONMAC_ADDRESSPASSPORTPERSON_NAMEPHONE_NUMBERSWIFT_CODEUS_DRIVERS_LICENSE_NUMBERUS_SOCIAL_SECURITY_NUMBERUS_VEHICLE_IDENTIFICATION_NUMBERUS_INDIVIDUAL_TAXPAYER_IDENTIFICATION_NUMBER
Cloud Healthcare API מסיר פרטים מזהים מטקסט רגיש במשאבי FHIR באמצעות סוגי המידע הרגילים שלו, בתוספת סוג מידע מותאם אישית נוסף למספרי קבלה.
אפשרויות טרנספורמציה פרימיטיביות
אפשרויות ההמרה הפרימיטיביות של Cloud Healthcare API כוללות:
-
RedactConfig: מסתיר ערך על ידי הסרתו. -
CharacterMaskConfig: מסתיר מחרוזת באופן מלא או חלקי על ידי החלפת תווים בקלט בתו קבוע שצוין. -
DateShiftConfig: משנה את התאריכים במספר אקראי של ימים, עם אפשרות לשמור על עקביות באותו הקשר. -
CryptoHashConfig: משתמשת ב-SHA-256 כדי להחליף ערכי קלט בייצוג בקידוד Base64 של מחרוזת פלט מגובבת שנוצרה באמצעות מפתח הצפנה נתון של נתונים. -
ReplaceWithInfoTypeConfig: מחליפה ערך קלט בשם של סוג המידע שלו.
ציון הגדרות ב-TextConfig
סוגי מידע וטרנספורמציות פרימיטיביות מצוינים בתוך InfoTypeTransformation, שהוא אובייקט בתוך TextConfig.
מציינים את סוגי המידע במערך infoTypes כערכים מופרדים בפסיקים.
הוספת infoType היא אופציונלית. אם לא מציינים לפחות infoType אחד, הטרנספורמציה חלה על כל ה-infoType המובנים בנתונים.
אם מציינים infoTypes ב-InfoTypeTransformation, צריך לציין לפחות טרנספורמציה פרימיטיבית אחת.
בקטעים הבאים מוסבר איך להשתמש בהמרות הפרימיטיביות שזמינות ב-InfoTypeTransformation יחד עם infoTypes כדי להתאים אישית את האופן שבו משאבי FHIR עוברים הסרת פרטים מזהים.
RedactConfig
הגדרת redactConfig מצנזרת ערך נתון על ידי הסרתו לחלוטין. להודעה redactConfig אין ארגומנטים, אבל ציון שלה מאפשר טרנספורמציה.
בדוגמאות הבאות אפשר לראות איך מצנזרים את תאריך הלידה של המטופל בשדה Patient.text.div במשאב Patient.
כדי לבצע את המשימה הזו, צריך להגדיר את DATE infoType עם הנתיב Patient.text.div והטרנספורמציה redactConfig.
אחרי שליחת הבקשה להסרת פרטים מזהים אל Cloud Healthcare API, תאריך הלידה בערך Patient.text.div יוסתר.
curl
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data "{ 'destinationDataset': 'projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID', 'config': { 'fhir': { 'fieldMetadataList': { 'paths': [ 'Patient.text.div' ], 'action': 'INSPECT_AND_TRANSFORM' } }, 'text': { 'transformations': [ { 'infoTypes': [ 'DATE' ], 'redactConfig': {} } ] } } }" "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
}
get כדי לעקוב אחרי סטטוס הפעולה:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
"done": true.
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
"apiMethodName": "google.cloud.healthcare.v1.dataset.DatasetService.DeidentifyDataset",
"createTime": "CREATE_TIME",
"endTime": "END_TIME",
"logsUrl": "https://console.cloud.google.com/logs/viewer/CLOUD_LOGGING_URL"
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.deidentify.DeidentifySummary",
"successStoreCount": "1",
"successResourceCount": "1"
}
}
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/fhir+json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/DESTINATION_DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient/r77433dd-dkeuc-633743nfd-383nfdsjds732"
{
"address": [
{
"city": "Anycity",
"district": "Anydistrict",
"line": [
"123 Main Street"
],
"period": {
"start": "1990-12-05"
},
"postalCode": "12345",
"state": "CA",
"text": "123 Main Street Anycity, Anydistrict, CA 12345",
"type": "both",
"use": "home"
}
],
"birthDate": "1980-12-05",
"gender": "female",
"id": "r77433dd-dkeuc-633743nfd-383nfdsjds732",
"meta": {
"lastUpdated": "2018-01-01T2018-01-01T00:00:00+00:00",
"versionId": "MTU0MDU4NTcxNjI2MTUxNDAwMAA"
},
"name": [
{
"family": "Smith",
"given": [
"Darcy"
],
"use": "official"
}
],
"resourceType": "Patient",
"text": {
"div": "<div><p><b>Patient</b></p><p><b>Name</b>: Smith, Darcy</p><p><b>DateOfBirth</b>: </p><p><b>Gender</b>: Female</p></div>",
"status": "generated"
}
}
PowerShell
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Post ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Body "{ 'destinationDataset': 'projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID', 'config': { 'fhir': { 'fieldMetadataList': { 'paths': [ 'Patient.text.div' ], 'action': 'INSPECT_AND_TRANSFORM' } }, 'text': { 'transformations': [ { 'infoTypes': [ 'DATE' ], 'redactConfig': {} } ] } } }" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
}
get כדי לעקוב אחרי סטטוס הפעולה:
$cred = gcloud auth print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Get ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content
"done": true.
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_NUMBER",
"metadata": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
"apiMethodName": "google.cloud.healthcare.v1.dataset.DatasetService.DeidentifyDataset",
"createTime": "CREATE_TIME",
"endTime": "END_TIME",
"logsUrl": "https://console.cloud.google.com/logs/viewer/CLOUD_LOGGING_URL"
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.deidentify.DeidentifySummary",
"successStoreCount": "1",
"successResourceCount": "1"
}
}
$cred = gcloud auth print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-RestMethod ` -Method Get ` -Headers $headers ` -ContentType: "application/fhir+json; charset=utf-8" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/DESTINATION_DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient/r77433dd-dkeuc-633743nfd-383nfdsjds732" | ConvertTo-Json
{
"address": [
{
"city": "Anycity",
"district": "Anydistrict",
"line": [
"123 Main Street"
],
"period": {
"start": "1990-12-05"
},
"postalCode": "12345",
"state": "CA",
"text": "123 Main Street Anycity, Anydistrict, CA 12345",
"type": "both",
"use": "home"
}
],
"birthDate": "1980-12-05",
"gender": "female",
"id": "r77433dd-dkeuc-633743nfd-383nfdsjds732",
"meta": {
"lastUpdated": "2018-01-01T2018-01-01T00:00:00+00:00",
"versionId": "MTU0MDU4NTcxNjI2MTUxNDAwMAA"
},
"name": [
{
"family": "Smith",
"given": [
"Darcy"
],
"use": "official"
}
],
"resourceType": "Patient",
"text": {
"div": "<div><p><b>Patient</b></p><p><b>Name</b>: Smith, Darcy</p><p><b>DateOfBirth</b>: </p><p><b>Gender</b>: Female</p></div>",
"status": "generated"
}
}
הפלט מראה שהערך של DateOfBirth ב-text.div הוסר. לעומת זאת, בדוגמה שבקטע הסרת פרטים מזהים מנתיבי FHIR ספציפיים, הערך של DateOfBirth ב-text.div לא הוסר באמצעות הגדרת ברירת המחדל.
CharacterMaskConfig
הגדרה של characterMaskConfig מחליפה מחרוזות שתואמות לסוגי המידע שצוינו בתו קבוע שמוגדר. לדוגמה, במקום לצנזר את השם של המטופל או להפוך אותו באמצעות גיבוב קריפטוגרפי, אפשר להחליף את השם בסדרה של כוכביות (*). מציינים את התו הקבוע כערך בשדה maskingCharacter.
בדוגמאות הבאות אפשר לראות איך מרחיבים את הדוגמה שמופיעה במאמר בנושא הסרת פרטים מזהים מנתיבי FHIR ספציפיים, אבל עכשיו הן כוללות הגדרה של infoType PERSON_NAME באמצעות טרנספורמציה characterMaskConfig. לא צוינה דמות קבועה, ולכן ברירת המחדל של המיסוך היא שימוש בכוכבית. אחרי ששולחים את בקשת הסרת הפרטים המזהים אל Cloud Healthcare API, הערכים ב-name.family וב-name.given מוחלפים בכוכביות.
curl
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data "{ 'destinationDataset': 'projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID', 'config': { 'fhir': { 'fieldMetadataList': { 'paths': [ 'Patient.HumanName' ], 'action': 'TRANSFORM' } }, 'text': { 'transformations': [ { 'infoTypes': [ 'PERSON_NAME' ], 'characterMaskConfig': { 'maskingCharacter': '' } } ] } } }" "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
}
get כדי לעקוב אחרי סטטוס הפעולה:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
"done": true.
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
"apiMethodName": "google.cloud.healthcare.v1.dataset.DatasetService.DeidentifyDataset",
"createTime": "CREATE_TIME",
"endTime": "END_TIME",
"logsUrl": "https://console.cloud.google.com/logs/viewer/CLOUD_LOGGING_URL"
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.deidentify.DeidentifySummary",
"successStoreCount": "1",
"successResourceCount": "1"
}
}
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/fhir+json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/DESTINATION_DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient/r77433dd-dkeuc-633743nfd-383nfdsjds732"
{
"address": [
{
"city": "Anycity",
"district": "Anydistrict",
"line": [
"123 Main Street"
],
"period": {
"start": "1990-12-05"
},
"postalCode": "12345",
"state": "CA",
"text": "123 Main Street Anycity, Anydistrict, CA 12345",
"type": "both",
"use": "home"
}
],
"birthDate": "1980-12-05",
"gender": "female",
"id": "r77433dd-dkeuc-633743nfd-383nfdsjds732",
"meta": {
"lastUpdated": "2018-01-01T2018-01-01T00:00:00+00:00",
"versionId": "MTU0MDU4NTcxNjI2MTUxNDAwMAA"
},
"name": [
{
"family": "*****",
"given": [
"*****"
],
"use": "official"
}
],
"resourceType": "Patient",
"text": {
"div": "<div><p><b>Patient</b></p><p><b>Name</b>: Smith, Darcy</p><p><b>DateOfBirth</b>: 1980-12-05</p><p><b>Gender</b>: Female</p></div>",
"status": "generated"
}
}
PowerShell
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Post ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Body "{ 'destinationDataset': 'projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID', 'config': { 'fhir': { 'fieldMetadataList': { 'paths': [ 'Patient.HumanName' ], 'action': 'TRANSFORM' } }, 'text': { 'transformations': [ { 'infoTypes': [ 'PERSON_NAME' ], 'characterMaskConfig': { 'maskingCharacter': '' } } ] } } }" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
}
get כדי לעקוב אחרי סטטוס הפעולה:
$cred = gcloud auth print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Get ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content
"done": true.
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_NUMBER",
"metadata": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
"apiMethodName": "google.cloud.healthcare.v1.dataset.DatasetService.DeidentifyDataset",
"createTime": "CREATE_TIME",
"endTime": "END_TIME",
"logsUrl": "https://console.cloud.google.com/logs/viewer/CLOUD_LOGGING_URL"
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.deidentify.DeidentifySummary",
"successStoreCount": "1",
"successResourceCount": "1"
}
}
$cred = gcloud auth print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-RestMethod ` -Method Get ` -Headers $headers ` -ContentType: "application/fhir+json; charset=utf-8" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/DESTINATION_DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient/r77433dd-dkeuc-633743nfd-383nfdsjds732" | ConvertTo-Json
{
"address": [
{
"city": "Anycity",
"district": "Anydistrict",
"line": [
"123 Main Street"
],
"period": {
"start": "1990-12-05"
},
"postalCode": "12345",
"state": "CA",
"text": "123 Main Street Anycity, Anydistrict, CA 12345",
"type": "both",
"use": "home"
}
],
"birthDate": "1980-12-05",
"gender": "female",
"id": "r77433dd-dkeuc-633743nfd-383nfdsjds732",
"meta": {
"lastUpdated": "2018-01-01T2018-01-01T00:00:00+00:00",
"versionId": "MTU0MDU4NTcxNjI2MTUxNDAwMAA"
},
"name": [
{
"family": "*****",
"given": [
"*****"
],
"use": "official"
}
],
"resourceType": "Patient",
"text": {
"div": "<div><p><b>Patient</b></p><p><b>Name</b>: Smith, Darcy</p><p><b>DateOfBirth</b>: 1980-12-05</p><p><b>Gender</b>: Female</p></div>",
"status": "generated"
}
}
בפלט אפשר לראות שהערכים ב-name.family וב-name.given הוחלפו בכוכביות. לעומת זאת, בדוגמה שבמאמר ביטול הזיהוי של נתיבי FHIR ספציפיים, הערכים ב-name.family וב-name.given צונזרו.
DateShiftConfig
ה-Cloud Healthcare API יכול לשנות תאריכים על ידי הזזה שלהם בטווח מוגדר מראש. כדי לשמור על עקביות בהמרות של תאריכים בין הפעלות של הסרת פרטים מזהים, משתמשים ב-DateShiftConfig עם אחת מהאפשרויות הבאות:
- (Deprecated): מפתח גולמי בקידוד Base64 מסוג AES 128/192/256-bit.
- (מומלץ): מפתח עטוף של Cloud Key Management Service (Cloud KMS). במאמר הסרת פרטים מזהים והוספת פרטים מזהים לטקסט רגיש יש דוגמה לשימוש במפתחות עטופים של Cloud KMS.
כדי לפענח את המפתח העטוף של Cloud KMS, צריך להעניק תפקיד עם ההרשאה cloudkms.cryptoKeyVersions.useToDecrypt לחשבון השירות של סוכן השירות של Cloud Healthcare. מומלץ להשתמש בתפקיד Cloud KMS CryptoKey Decrypter (roles/cloudkms.cryptoKeyDecrypter). כשמשתמשים ב-Cloud KMS לפעולות קריפטוגרפיות, חלים חיובים. מידע נוסף זמין במחירון של Cloud Key Management Service.
Cloud Healthcare API משתמש במפתח הזה כדי לחשב את ההפרש בין תאריכים, כמו תאריך הלידה של המטופל, בטווח של 100 ימים.
אם לא מספקים מפתח, Cloud Healthcare API יוצר מפתח משלו בכל פעם שמופעלת פעולת הסרת הפרטים המזהים בערכי תאריכים. התוצאה יכולה להיות תאריכים שונים בכל הרצה.
בדוגמאות הבאות מוצגות דרכים להגדיר את infoType DATE באמצעות הטרנספורמציה DateShiftConfig בנתיבים Patient.birthDate ו-Patient.text.div. אחרי שליחת הבקשה לביטול הזיהוי ל-Cloud Healthcare API, הערך של birthDate ותאריך הלידה ב-Patient.text.div ישתנו בטווח של 100 ימים יותר או פחות מתאריך הלידה המקורי, 1980-12-05.
מפתח ההצפנה שמופיע בדוגמה, U2FsdGVkX19bS2oZsdbK9X5zi2utBn22uY+I2Vo0zOU=, הוא מפתח גולמי מוצפן ב-AES באורך 256 ביט בקידוד Base64, שנוצר באמצעות הפקודה הבאה. כשמוצגת בקשה, מזינים סיסמה לבחירה לפקודה:
echo -n "test" | openssl enc -e -aes-256-ofb -a -salt
curl
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data "{ 'destinationDataset': 'projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID', 'config': { 'fhir': { 'fieldMetadataList': { 'paths': [ 'Patient.birthDate', 'Patient.text.div' ], 'action': 'INSPECT_AND_TRANSFORM' } }, 'text': { 'transformations': { 'infoTypes': [ 'DATE' ], 'dateShiftConfig': { 'cryptoKey': 'U2FsdGVkX19bS2oZsdbK9X5zi2utBn22uY+I2Vo0zOU=' } } } } }" "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
}
get כדי לעקוב אחרי סטטוס הפעולה:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
"done": true.
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
"apiMethodName": "google.cloud.healthcare.v1.dataset.DatasetService.DeidentifyDataset",
"createTime": "CREATE_TIME",
"endTime": "END_TIME",
"logsUrl": "https://console.cloud.google.com/logs/viewer/CLOUD_LOGGING_URL"
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.deidentify.DeidentifySummary",
"successStoreCount": "1",
"successResourceCount": "1"
}
}
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/fhir+json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/DESTINATION_DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient/r77433dd-dkeuc-633743nfd-383nfdsjds732"
{
"address": [
{
"city": "Anycity",
"district": "Anydistrict",
"line": [
"123 Main Street"
],
"period": {
"start": "1990-12-05"
},
"postalCode": "12345",
"state": "",
"text": "123 Main Street Anycity, Anydistrict, CA 12345",
"type": "both",
"use": "home"
}
],
"birthDate": "1981-02-19",
"gender": "female",
"id": "r77433dd-dkeuc-633743nfd-383nfdsjds732",
"meta": {
"lastUpdated": "2018-01-01T2018-01-01T00:00:00+00:00",
"versionId": "MTU0MDU4NTcxNjI2MTUxNDAwMAA"
},
"name": [
{
"family": "Smith",
"given": [
"Darcy"
],
"use": "official"
}
],
"resourceType": "Patient",
"text": {
"div": "<div><p><b>Patient</b></p><p><b>Name</b>: Smith, Darcy</p><p><b>DateOfBirth</b>: 1981-02-19</p><p><b>Gender</b>: Female</p></div>",
"status": "generated"
}
}
PowerShell
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Post ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Body "{ 'destinationDataset': 'projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID', 'config': { 'fhir': { 'fieldMetadataList': { 'paths': [ 'Patient.HumanName', 'Patient.text.div' ], 'action': 'INSPECT_AND_TRANSFORM' } }, 'text': { 'transformations': { 'infoTypes': [ 'DATE' ], 'dateShiftConfig': { 'cryptoKey': 'U2FsdGVkX19bS2oZsdbK9X5zi2utBn22uY+I2Vo0zOU=' } } } } }" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
}
get כדי לעקוב אחרי סטטוס הפעולה:
$cred = gcloud auth print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Get ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content
"done": true.
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_NUMBER",
"metadata": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
"apiMethodName": "google.cloud.healthcare.v1.dataset.DatasetService.DeidentifyDataset",
"createTime": "CREATE_TIME",
"endTime": "END_TIME",
"logsUrl": "https://console.cloud.google.com/logs/viewer/CLOUD_LOGGING_URL"
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.deidentify.DeidentifySummary",
"successStoreCount": "1",
"successResourceCount": "1"
}
}
$cred = gcloud auth print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-RestMethod ` -Method Get ` -Headers $headers ` -ContentType: "application/fhir+json; charset=utf-8" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/DESTINATION_DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient/r77433dd-dkeuc-633743nfd-383nfdsjds732" | ConvertTo-Json
{
"address": [
{
"city": "Anycity",
"district": "Anydistrict",
"line": [
"123 Main Street"
],
"period": {
"start": "1990-12-05"
},
"postalCode": "12345",
"state": "",
"text": "123 Main Street Anycity, Anydistrict, CA 12345",
"type": "both",
"use": "home"
}
],
"birthDate": "1981-02-19",
"gender": "female",
"id": "r77433dd-dkeuc-633743nfd-383nfdsjds732",
"meta": {
"lastUpdated": "2018-01-01T2018-01-01T00:00:00+00:00",
"versionId": "MTU0MDU4NTcxNjI2MTUxNDAwMAA"
},
"name": [
{
"family": "Smith",
"given": [
"Darcy"
],
"use": "official"
}
],
"resourceType": "Patient",
"text": {
"div": "<div><p><b>Patient</b></p><p><b>Name</b>: Smith, Darcy</p><p><b>DateOfBirth</b>: 1981-02-19</p><p><b>Gender</b>: Female</p></div>",
"status": "generated"
}
}
בפלט אפשר לראות שהערך ב-birthDate ותאריך הלידה ב-Patient.text.div הומרו לערך חדש של 1981-02-19. הטרנספורמציה הזו התרחשה כתוצאה משילוב של ההפרש של 100 ימים עם מזהה המטופל והערך cryptoKey שסופק.
הערכים החדשים של birthDate ותאריך הלידה ב-Patient.text.div עקביים עבור המטופל הזה בין הפעלות של הסרת פרטים מזהים, כל עוד מסופק אותו cryptoKey.
CryptoHashConfig
ממשק Cloud Healthcare API יכול להמיר נתונים על ידי החלפת ערכים בגיבובים קריפטוגרפיים (שנקראים גם ערכי סרוגייט). כדי לעשות את זה, צריך לציין הודעה cryptoHashConfig.
אפשר להשאיר את השדה cryptoHashConfig ריק, או לספק בו את אחד מהערכים הבאים:
- (Deprecated): מפתח גולמי בקידוד Base64 מסוג AES 128/192/256-bit.
- (מומלץ): מפתח עטוף של Cloud Key Management Service (Cloud KMS). במאמר הסרת פרטים מזהים והוספת פרטים מזהים לטקסט רגיש יש דוגמה לשימוש במפתחות עטופים של Cloud KMS.
כדי לפענח את המפתח העטוף של Cloud KMS, צריך להעניק תפקיד עם ההרשאה cloudkms.cryptoKeyVersions.useToDecrypt לחשבון השירות של סוכן השירות של Cloud Healthcare. מומלץ להשתמש בתפקיד Cloud KMS CryptoKey Decrypter (roles/cloudkms.cryptoKeyDecrypter). כשמשתמשים ב-Cloud KMS לפעולות קריפטוגרפיות, חלים חיובים. מידע נוסף זמין במחירון של Cloud Key Management Service.
אם מספקים מפתח עקבי, נוצרים ערכים חלופיים שהם עקביים בין הפעלות של הסרת פרטים מזהים. אם לא מספקים מפתח, Cloud Healthcare API יוצר מפתח חדש בכל פעם שהפעולה מופעלת. שימוש במפתח אחר יניב ערכי תחליף שונים.
הדוגמאות הבאות הן הרחבה של הדוגמה שמופיעה במאמר בנושא הסרת פרטים מזהים מנתיבי FHIR ספציפיים, אבל עכשיו הן כוללות הגדרה של PERSON_NAME infoType עם הטרנספורמציה cryptoKey בנתיב Patient.HumanName. אחרי ששולחים את בקשת הסרת הפרטים המזהים אל Cloud Healthcare API, הערכים name.family ו-name.given מוחלפים בערכי סרוגייט.
מפתח ההצפנה שמופיע בדוגמה, U2FsdGVkX19bS2oZsdbK9X5zi2utBn22uY+I2Vo0zOU=, הוא מפתח גולמי מוצפן ב-AES באורך 256 ביט בקידוד Base64, שנוצר באמצעות הפקודה הבאה. כשמוצגת בקשה, מזינים סיסמה לבחירה לפקודה:
echo -n "test" | openssl enc -e -aes-256-ofb -a -salt
curl
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data "{ 'destinationDataset': 'projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID', 'config': { 'fhir': { 'fieldMetadataList': { 'paths': [ 'Patient.HumanName' ], 'action': 'INSPECT_AND_TRANSFORM' } }, 'text': { 'transformations': { 'infoTypes': [ 'PERSON_NAME' ], 'cryptoHashConfig': { 'cryptoKey': 'U2FsdGVkX19bS2oZsdbK9X5zi2utBn22uY+I2Vo0zOU=' } } } } }" "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
}
get כדי לעקוב אחרי סטטוס הפעולה:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
"done": true.
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
"apiMethodName": "google.cloud.healthcare.v1.dataset.DatasetService.DeidentifyDataset",
"createTime": "CREATE_TIME",
"endTime": "END_TIME",
"logsUrl": "https://console.cloud.google.com/logs/viewer/CLOUD_LOGGING_URL"
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.deidentify.DeidentifySummary",
"successStoreCount": "1",
"successResourceCount": "1"
}
}
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/fhir+json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/DESTINATION_DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient/r77433dd-dkeuc-633743nfd-383nfdsjds732"
{
"address": [
{
"city": "Anycity",
"district": "Anydistrict",
"line": [
"123 Main Street"
],
"period": {
"start": "1990-12-05"
},
"postalCode": "12345",
"state": "CA",
"text": "123 Main Street Anycity, Anydistrict, CA 12345",
"type": "both",
"use": "home"
}
],
"birthDate": "1980-12-05",
"gender": "female",
"id": "r77433dd-dkeuc-633743nfd-383nfdsjds732",
"meta": {
"lastUpdated": "2018-01-01T2018-01-01T00:00:00+00:00",
"versionId": "MTU0MDU4NTcxNjI2MTUxNDAwMAA"
},
"name": [
{
"family": "NlVBV12Hhb5DD8WNqlTpXboFxzlUSlqAmYDet/jIViQ=",
"given": [
"FSH4D/IGb80a1rS0L0kqfC3DCDt6//17VPhIkOzH2pk="
],
"use": "official"
}
],
"resourceType": "Patient",
"text": {
"div": "<div><p><b>Patient</b></p><p><b>Name</b>: Smith, Darcy</p><p><b>DateOfBirth</b>: 1980-12-05</p><p><b>Gender</b>: Female</p></div>",
"status": "generated"
}
}
PowerShell
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Post ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Body "{ 'destinationDataset': 'projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID', 'config': { 'fhir': { 'fieldMetadataList': { 'paths': [ 'Patient.HumanName' ], 'action': 'TRANSFORM' } }, 'text': { 'transformations': { 'infoTypes': [ 'PERSON_NAME' ], 'cryptoHashConfig': { 'cryptoKey': 'U2FsdGVkX19bS2oZsdbK9X5zi2utBn22uY+I2Vo0zOU=' } } } } }" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
}
get כדי לעקוב אחרי סטטוס הפעולה:
$cred = gcloud auth print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Get ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content
"done": true.
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_NUMBER",
"metadata": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
"apiMethodName": "google.cloud.healthcare.v1.dataset.DatasetService.DeidentifyDataset",
"createTime": "CREATE_TIME",
"endTime": "END_TIME",
"logsUrl": "https://console.cloud.google.com/logs/viewer/CLOUD_LOGGING_URL"
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.deidentify.DeidentifySummary",
"successStoreCount": "1",
"successResourceCount": "1"
}
}
$cred = gcloud auth print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-RestMethod ` -Method Get ` -Headers $headers ` -ContentType: "application/fhir+json; charset=utf-8" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/DESTINATION_DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient/r77433dd-dkeuc-633743nfd-383nfdsjds732" | ConvertTo-Json
{
"address": [
{
"city": "Anycity",
"district": "Anydistrict",
"line": [
"123 Main Street"
],
"period": {
"start": "1990-12-05"
},
"postalCode": "12345",
"state": "CA",
"text": "123 Main Street Anycity, Anydistrict, CA 12345",
"type": "both",
"use": "home"
}
],
"birthDate": "1980-12-05",
"gender": "female",
"id": "r77433dd-dkeuc-633743nfd-383nfdsjds732",
"meta": {
"lastUpdated": "2018-01-01T2018-01-01T00:00:00+00:00",
"versionId": "MTU0MDU4NTcxNjI2MTUxNDAwMAA"
},
"name": [
{
"family": "NlVBV12Hhb5DD8WNqlTpXboFxzlUSlqAmYDet/jIViQ=",
"given": [
"FSH4D/IGb80a1rS0L0kqfC3DCDt6//17VPhIkOzH2pk="
],
"use": "official"
}
],
"resourceType": "Patient",
"text": {
"div": "<div><p><b>Patient</b></p><p><b>Name</b>: Smith, Darcy</p><p><b>DateOfBirth</b>: 1980-12-05</p><p><b>Gender</b>: Female</p></div>",
"status": "generated"
}
}
בפלט אפשר לראות שהערכים של name.family ושל name.given עברו המרה באמצעות גיבוב קריפטוגרפי. הטרנספורמציה הזו התרחשה כתוצאה משילוב של מזהה המטופל והערך cryptoKey שסופק.
הערכים החדשים של name.family ו-name.given עקביים עבור המטופל הזה בין הפעלות של הסרת פרטים מזהים, כל עוד מסופק אותו ערך של cryptoKey.
ReplaceWithInfoTypeConfig
באמצעות Cloud Healthcare API אפשר להמיר נתונים על ידי החלפת ערכים בשם של infoTypeהערך. כדי לעשות את זה, צריך לציין replaceWithInfoTypeConfigהודעה.
בדוגמאות הבאות מורחבת הדוגמה שמופיעה במאמר בנושא הסרת פרטים מזהים מנתיבי FHIR ספציפיים, אבל מוגדרת בהן טרנספורמציה של replaceWithInfoType ב-PERSON_NAME והנתיב fieldMetadataList מוגדר ל-Patient.HumanName.
אחרי ששולחים את הבקשה להסרת הפרטים המזהים אל Cloud Healthcare API, הערכים של name.family ושל name.given מוחלפים בערך של infoType.
curl
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data "{ 'destinationDataset': 'projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID', 'config': { 'fhir': { 'fieldMetadataList': { 'paths': [ 'Patient.HumanName' ], 'action': 'INSPECT_AND_TRANSFORM' } }, 'text': { 'transformations': { 'infoTypes': [ 'PERSON_NAME' ], 'replaceWithInfoType': {} } } } }" "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
}
get כדי לעקוב אחרי סטטוס הפעולה:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
"done": true.
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
"apiMethodName": "google.cloud.healthcare.v1.dataset.DatasetService.DeidentifyDataset",
"createTime": "CREATE_TIME",
"endTime": "END_TIME",
"logsUrl": "https://console.cloud.google.com/logs/viewer/CLOUD_LOGGING_URL"
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.deidentify.DeidentifySummary",
"successStoreCount": "1",
"successResourceCount": "1"
}
}
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/fhir+json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/DESTINATION_DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient/r77433dd-dkeuc-633743nfd-383nfdsjds732"
{
"address": [
{
"city": "Anycity",
"district": "Anydistrict",
"line": [
"123 Main Street"
],
"period": {
"start": "1990-12-05"
},
"postalCode": "12345",
"state": "CA",
"text": "123 Main Street Anycity, Anydistrict, CA 12345",
"type": "both",
"use": "home"
}
],
"birthDate": "1980-12-05",
"gender": "female",
"id": "r77433dd-dkeuc-633743nfd-383nfdsjds732",
"meta": {
"lastUpdated": "2018-01-01T2018-01-01T00:00:00+00:00",
"versionId": "MTU0MDU4NTcxNjI2MTUxNDAwMAA"
},
"name": [
{
"family": "[PERSON_NAME]",
"given": [
"[PERSON_NAME]"
],
"use": "official"
}
],
"resourceType": "Patient",
"text": {
"div": "<div><p><b>Patient</b></p><p><b>Name</b>: Smith, Darcy</p><p><b>DateOfBirth</b>: 1980-12-05</p><p><b>Gender</b>: Female</p></div>",
"status": "generated"
}
}
PowerShell
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Post ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Body "{ 'destinationDataset': 'projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID', 'config': { 'fhir': { 'fieldMetadataList': { 'paths': [ 'Patient.HumanName' ], 'action': 'TRANSFORM' } }, 'text': { 'transformations': { 'infoTypes': [ 'PERSON_NAME' ], 'replaceWithInfoTypeConfig': {} } } } }" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
}
get כדי לעקוב אחרי סטטוס הפעולה:
$cred = gcloud auth print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Get ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content
"done": true.
{
"name": "projects/PROJECT_ID/locations/REGION/datasets/SOURCE_DATASET_ID/operations/OPERATION_NUMBER",
"metadata": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
"apiMethodName": "google.cloud.healthcare.v1.dataset.DatasetService.DeidentifyDataset",
"createTime": "CREATE_TIME",
"endTime": "END_TIME",
"logsUrl": "https://console.cloud.google.com/logs/viewer/CLOUD_LOGGING_URL"
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.deidentify.DeidentifySummary",
"successStoreCount": "1",
"successResourceCount": "1"
}
}
$cred = gcloud auth print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-RestMethod ` -Method Get ` -Headers $headers ` -ContentType: "application/fhir+json; charset=utf-8" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/datasets/DESTINATION_DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient/r77433dd-dkeuc-633743nfd-383nfdsjds732" | ConvertTo-Json
{
"address": [
{
"city": "Anycity",
"district": "Anydistrict",
"line": [
"123 Main Street"
],
"period": {
"start": "1990-12-05"
},
"postalCode": "12345",
"state": "CA",
"text": "123 Main Street Anycity, Anydistrict, CA 12345",
"type": "both",
"use": "home"
}
],
"birthDate": "1980-12-05",
"gender": "female",
"id": "r77433dd-dkeuc-633743nfd-383nfdsjds732",
"meta": {
"lastUpdated": "2018-01-01T2018-01-01T00:00:00+00:00",
"versionId": "MTU0MDU4NTcxNjI2MTUxNDAwMAA"
},
"name": [
{
"family": "[PERSON_NAME]",
"given": [
"[PERSON_NAME]"
],
"use": "official"
}
],
"resourceType": "Patient",
"text": {
"div": "<div><p><b>Patient</b></p><p><b>Name</b>: Smith, Darcy</p><p><b>DateOfBirth</b>: 1980-12-05</p><p><b>Gender</b>: Female</p></div>",
"status": "generated"
}
}
בפלט אפשר לראות שהערכים של name.family ו-name.given הוחלפו ב-infoType של הערך.
הסרת פרטים מזהים מנתונים ברמת מאגר FHIR
בדוגמאות הקודמות אפשר לראות איך להסיר את הפרטים המזהים מנתוני FHIR ברמת מערך הנתונים. כדי לשנות בקשה להסרת פרטים מזהים ממערך נתונים לבקשה להסרת פרטים מזהים ממאגר FHIR, מבצעים את השינויים הבאים:
- משנים את הערך של
destinationDatasetבגוף הבקשה ל-destinationStore - הוספת
fhirStores/DESTINATION_FHIR_STORE_IDבסוף הערך ב-destinationStore - מוסיפים
fhirStores/SOURCE_FHIR_STORE_IDכשמציינים את מיקום נתוני המקור.
לדוגמה:
הסרת פרטים מזהים ברמת מערך הנתונים:
'destinationDataset': 'projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID' … "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"
ביטול הזיהוי ברמת מאגר FHIR:
'destinationStore': 'projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/fhirStores/DESTINATION_FHIR_STORE_ID' … "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/fhirStores/SOURCE_FHIR_STORE_ID:deidentify"
בדוגמאות הבאות מוסבר איך להסיר פרטי זיהוי מנתיבי FHIR ספציפיים, אבל הסרת פרטי הזיהוי מתבצעת בחנות FHIR אחת והנתונים שפרטי הזיהוי שלהם הוסרו מועתקים לחנות FHIR חדשה. שימו לב שמאגר ה-FHIR שאליו מתייחסים באמצעות DESTINATION_FHIR_STORE_ID חייב כבר להתקיים.
curl
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data "{ 'destinationStore': 'projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/fhirStores/DESTINATION_FHIR_STORE_ID', 'config': { 'fhir': { 'fieldMetadataList': [ { 'paths': [ 'Patient.HumanName' ], 'action': 'TRANSFORM' } ] } } }" "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/fhirStores/SOURCE_FHIR_STORE_ID:deidentify"
אם הבקשה מצליחה, השרת מחזיר את התגובה בפורמט JSON:
{
"name": "projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
}
התשובה מכילה שם פעולה. אפשר להשתמש בשיטת הפעולה get כדי לעקוב אחרי סטטוס הפעולה:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
אם הבקשה מצליחה, השרת מחזיר את התגובה בפורמט JSON.
אחרי שתהליך הסרת הפרטים המזהים מסתיים, התשובה מכילה את "done": true.
{
"name": "projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
"apiMethodName": "google.cloud.healthcare.v1.deidentify.DeidentifyService.DeidentifyFhirStore",
"createTime": "CREATE_TIME",
"endTime": "END_TIME",
"logsUrl": "https://console.cloud.google.com/logs/query/CLOUD_LOGGING_URL",
"counter": {
"success": "SUCCESS_COUNT"
}
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.deidentify.DeidentifyFhirStoreSummary"
}
}
PowerShell
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Post ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Body "{ 'destinationStore': 'projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/fhirStores/DESTINATION_FHIR_STORE_ID', 'config': { 'fhir': { 'fieldMetadataList': [ { 'paths': [ 'Patient.HumanName' ], 'action': 'TRANSFORM' } ] } } }" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/fhirStores/SOURCE_FHIR_STORE_ID:deidentify" | Select-Object -Expand Content
אם הבקשה מצליחה, השרת מחזיר את התגובה בפורמט JSON:
{
"name": "projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
}
התשובה מכילה מזהה פעולה. אפשר להשתמש בשיטת הפעולה get כדי לעקוב אחרי סטטוס הפעולה:
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Get ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content
אם הבקשה מצליחה, השרת מחזיר את התגובה בפורמט JSON. אחרי שתהליך הסרת הפרטים המזהים מסתיים, התשובה מכילה את "done": true.
{
"name": "projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
"apiMethodName": "google.cloud.healthcare.v1.deidentify.DeidentifyService.DeidentifyFhirStore",
"createTime": "CREATE_TIME",
"endTime": "END_TIME",
"logsUrl": "https://console.cloud.google.com/logs/query/CLOUD_LOGGING_URL",
"counter": {
"success": "SUCCESS_COUNT"
}
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.deidentify.DeidentifyFhirStoreSummary"
}
}
הסרת פרטים מזהים מתת-קבוצה של מאגר FHIR
כשמסירים את הפרטים המזהים מנתוני FHIR ברמת מאגר FHIR, אפשר להסיר את הפרטים המזהים מקבוצת משנה של הנתונים על ידי ציון מסנן.
המסנן הוא רשימה של מזהי משאבים ב-FHIR. מציינים את המזהים באובייקט Resources בתוך האובייקט FhirFilter.
בדוגמה הבאה מוסבר על הסרת פרטים מזהים מנתונים ברמת מאגר FHIR, אבל מוצגת רשימה של שני מזהי משאבים של FHIR (אחד של Patient ואחד של Observation) שקובעת אילו משאבים יעברו הסרת פרטים מזהים.
curl
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data "{ 'destinationStore': 'projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/fhirStores/DESTINATION_FHIR_STORE_ID', 'config': { 'fhir': { 'fieldMetadataList': [ { 'action': 'TRANSFORM', 'paths': [ 'Patient.HumanName' ] } ] } }, 'resourceFilter': { 'resources': { 'resources': [ 'Patient/PATIENT_ID', 'Observation/OBSERVATION_ID' ] } } }" "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/fhirStores/SOURCE_FHIR_STORE_ID:deidentify"
אם הבקשה מצליחה, השרת מחזיר את התגובה בפורמט JSON:
{
"name": "projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
}
התשובה מכילה שם פעולה. אפשר להשתמש בשיטת הפעולה get כדי לעקוב אחרי סטטוס הפעולה:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
אם הבקשה מצליחה, השרת מחזיר את התגובה בפורמט JSON.
אחרי שתהליך הסרת הפרטים המזהים מסתיים, התשובה מכילה את "done": true.
{
"name": "projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
"apiMethodName": "google.cloud.healthcare.v1.deidentify.DeidentifyService.DeidentifyFhirStore",
"createTime": "CREATE_TIME",
"endTime": "END_TIME",
"logsUrl": "https://console.cloud.google.com/logs/query/CLOUD_LOGGING_URL",
"counter": {
"success": "SUCCESS_COUNT"
}
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.deidentify.DeidentifyFhirStoreSummary"
}
}
PowerShell
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Post ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Body "{ 'destinationStore': 'projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/fhirStores/DESTINATION_FHIR_STORE_ID', 'resourceFilter': { 'resources': { 'resources': [ 'Patient/PATIENT_ID', 'Observation/OBSERVATION_ID' ] } }, 'config': { 'fhir': { 'fieldMetadataList': [ { 'paths': [ 'Patient.HumanName' ], 'action': 'TRANSFORM' } ] } } }" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/fhirStores/SOURCE_FHIR_STORE_ID:deidentify" | Select-Object -Expand Content
אם הבקשה מצליחה, השרת מחזיר את התגובה בפורמט JSON:
{
"name": "projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
}
התשובה מכילה מזהה פעולה. אפשר להשתמש בשיטת הפעולה get כדי לעקוב אחרי סטטוס הפעולה:
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Get ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content
אם הבקשה מצליחה, השרת מחזיר את התגובה בפורמט JSON. אחרי שתהליך הסרת הפרטים המזהים מסתיים, התשובה מכילה את "done": true.
{
"name": "projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
"apiMethodName": "google.cloud.healthcare.v1.deidentify.DeidentifyService.DeidentifyFhirStore",
"createTime": "CREATE_TIME",
"endTime": "END_TIME",
"logsUrl": "https://console.cloud.google.com/logs/query/CLOUD_LOGGING_URL",
"counter": {
"success": "SUCCESS_COUNT"
}
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.healthcare.v1.deidentify.DeidentifyFhirStoreSummary"
}
}
הסרת פרטים מזהים מהנתונים במסוף Google Cloud
אפשר להסיר את הפרטים המזהים מהנתונים ב Google Cloud מסוף, גם ממערך נתונים וגם ממאגר FHIR. ההגדרה של הסרת פרטי הזיהוי ב-FHIR משמשת להסרת פרטי הזיהוי גם ממערכי נתונים וגם ממאגרי FHIR. מידע נוסף זמין במאמר בנושא הסרת פרטי הזיהוי מנתוני FHIR שמוגדרת כברירת מחדל.
הסרת פרטי הזיהוי מנתונים בקבוצת נתונים
כדי להסיר פרטים מזהים מנתונים במערך נתונים:
נכנסים לדף Datasets במסוף Google Cloud .
ברשימה פעולות, בוחרים באפשרות הסרת פרטים מזהים בשביל מערך הנתונים שרוצים להסיר ממנו פרטים מזהים.
יוצג הדף De-identify Dataset (הסרת פרטים מזהים מקבוצת נתונים).
לוחצים על הגדרת מערך נתונים ליעד ומזינים שם למערך הנתונים החדש שבו יישמרו הנתונים שעברו הסרת פרטים מזהים.
לוחצים על De-identify (הסרת פרטים מזהים) כדי להסיר את הפרטים המזהים מהנתונים במערך הנתונים.
הסרת פרטים מזהים מנתונים במאגר FHIR
כדי להסיר פרטים מזהים מנתונים במאגר FHIR, מבצעים את השלבים הבאים:
נכנסים לדף Datasets במסוף Google Cloud .
לוחצים על מערך הנתונים שרוצים להסיר ממנו את פרטי הזיהוי.
ברשימת מאגרי FHIR, בוחרים באפשרות הסרת פרטים מזהים מהרשימה פעולות של מאגר FHIR שרוצים להסיר ממנו פרטים מזהים.
מוצג הדף De-identify FHIR Store (הסרת פרטים מזהים ממאגר FHIR).
בוחרים באפשרות הגדרת מאגר נתונים ליעד ובוחרים את מערך הנתונים ואת מאגר FHIR שבהם יישמרו הנתונים שעברו הסרת פרטים מזהים.
הערה: אם רוצים לאחסן את הנתונים שעברו הסרת פרטי זיהוי במאגר FHIR חדש, צריך קודם ליצור את המאגר החדש ואז לבחור אותו כמאגר היעד של FHIR.
לוחצים על הסרת פרטים מזהים כדי להסיר את הפרטים המזהים מהנתונים במאגר FHIR.
פתרון בעיות בפעולות של הסרת פרטי הזיהוי ב-FHIR
אם מתרחשות שגיאות במהלך פעולת הסרת פרטים מזהים ב-FHIR, השגיאות נרשמות ביומן ב-Cloud Logging. מידע נוסף זמין במאמר צפייה ביומני שגיאות ב-Cloud Logging.
אם כל הפעולה מחזירה שגיאה, אפשר לעיין במאמר בנושא פתרון בעיות בפעולות ארוכות טווח.