Panoramica
L'API Cloud Healthcare utilizza Identity and Access Management (IAM) per controllo dell'accesso.
Nell'API Cloud Healthcare, il controllo dell'accesso può essere configurato a livello di progetto, set di dati o datastore. Ad esempio, puoi concedere a un gruppo di sviluppatori l'accesso a tutti i set di dati all'interno di un progetto. Per informazioni su come configurare e utilizzare IAM con l'API Cloud Healthcare, consulta le sezioni Controllo degli accessi e Controllo degli accessi ad altri prodotti.
Per una descrizione dettagliata di IAM e delle sue funzionalità, consulta la documentazione di IAM. in particolare la sezione sulla gestione dei criteri IAM.
Ogni metodo dell'API Cloud Healthcare prevede che chi effettua la chiamata debba disporre delle autorizzazioni necessarie. Per ulteriori informazioni, consulta le sezioni relative ad autorizzazioni e ruoli.
Autorizzazioni
Le tabelle riportate di seguito elencano le autorizzazioni IAM associate all'API Cloud Healthcare. I nomi dei metodi sono abbreviati nella tabella. Il nome completo di ciascun metodo inizia con projects.locations.
.
Metodi del datastore di consensi
Metodo per l'archivio consensi | Autorizzazioni obbligatorie |
---|---|
datasets.consentStores.checkDataAccess |
healthcare.consentStores.checkDataAccess per l'archivio di consensi richiesto. |
datasets.consentStores.create |
healthcare.consentStores.create per il set di dati padre. |
datasets.consentStores.delete |
healthcare.consentStores.delete per l'archivio di consensi richiesto. |
datasets.consentStores.evaluateUserConsents |
healthcare.consentStores.evaluateUserConsents per l'archivio di consensi richiesto. |
datasets.consentStores.get |
healthcare.consentStores.get per l'archivio di consensi richiesto. |
datasets.consentStores.getIamPolicy |
healthcare.consentStores.getIamPolicy per l'archivio di consensi richiesto. |
datasets.consentStores.list |
healthcare.consentStores.list per il set di dati padre. |
datasets.consentStores.patch |
healthcare.consentStores.update per l'archivio di consensi richiesto. |
datasets.consentStores.queryAccessibleData |
healthcare.consentStores.queryAccessibleData per l'archivio di consensi richiesto. |
datasets.consentStores.setIamPolicy |
healthcare.consentStores.setIamPolicy per l'archivio di consensi richiesto. |
datasets.consentStores.attributeDefinitions.create |
healthcare.attributeDefinitions.create nell'archivio del consenso dei genitori. |
datasets.consentStores.attributeDefinitions.delete |
healthcare.attributeDefinitions.delete sulla risorsa di definizione dell'attributo richiesto. |
datasets.consentStores.attributeDefinitions.get |
healthcare.attributeDefinitions.get sulla risorsa di definizione dell'attributo richiesto. |
datasets.consentStores.attributeDefinitions.list |
healthcare.attributeDefinitions.list nell'archivio del consenso dei genitori. |
datasets.consentStores.attributeDefinitions.patch |
healthcare.attributeDefinitions.update sulla risorsa di definizione dell'attributo richiesto. |
datasets.consentStores.consentArtifacts.create |
healthcare.consentArtifacts.create nell'archivio del consenso dei genitori. |
datasets.consentStores.consentArtifacts.delete |
healthcare.consentArtifacts.delete sulla risorsa artefatto di consenso richiesta. |
datasets.consentStores.consentArtifacts.get |
healthcare.consentArtifacts.get sulla risorsa artefatto di consenso richiesta. |
datasets.consentStores.consentArtifacts.list |
healthcare.consentArtifacts.list nell'archivio del consenso dei genitori. |
datasets.consentStores.consents.create |
healthcare.consents.create nell'archivio del consenso dei genitori. |
datasets.consentStores.consents.delete |
healthcare.consents.delete nella risorsa di consenso richiesta. |
datasets.consentStores.consents.get |
healthcare.consents.get nella risorsa di consenso richiesta. |
datasets.consentStores.consents.list |
healthcare.consents.list nell'archivio del consenso dei genitori. |
datasets.consentStores.consents.patch |
healthcare.consents.update nella risorsa di consenso richiesta. |
datasets.consentStores.consents.revoke |
healthcare.consents.revoke nella risorsa di consenso richiesta. |
datasets.consentStores.userDataMappings.archive |
healthcare.userDataMappings.archive sulla risorsa di mappatura dei dati utente richiesta. |
datasets.consentStores.userDataMappings.create |
healthcare.userDataMappings.create nell'archivio del consenso dei genitori. |
datasets.consentStores.userDataMappings.delete |
healthcare.userDataMappings.delete sulla risorsa di mappatura dei dati utente richiesta. |
datasets.consentStores.userDataMappings.get |
healthcare.userDataMappings.get sulla risorsa di mappatura dei dati utente richiesta. |
datasets.consentStores.userDataMappings.list |
healthcare.userDataMappings.list nell'archivio del consenso dei genitori. |
datasets.consentStores.userDataMappings.patch |
healthcare.userDataMappings.update sulla risorsa di mappatura dei dati utente richiesta. |
Metodi per set di dati
Metodo per set di dati | Autorizzazioni obbligatorie |
---|---|
datasets.create |
healthcare.datasets.create sul progetto Google Cloud padre. |
datasets.deidentify |
|
datasets.delete |
healthcare.datasets.delete per il set di dati richiesto. |
datasets.get |
healthcare.datasets.get per il set di dati richiesto. |
datasets.getIamPolicy |
healthcare.datasets.getIamPolicy per il set di dati richiesto. |
datasets.list |
healthcare.datasets.list sul progetto Google Cloud padre. |
datasets.patch |
healthcare.datasets.update per il set di dati richiesto. |
datasets.setIAMPolicy |
healthcare.datasets.setIamPolicy per il set di dati richiesto. |
Metodi per archivi DICOM
Metodo per archivi DICOM | Autorizzazioni obbligatorie |
---|---|
datasets.dicomStores.create |
healthcare.dicomStores.create per il set di dati padre. |
datasets.dicomStores.deidentify |
|
datasets.dicomStores.delete |
healthcare.dicomStores.delete per l'archivio DICOM richiesto. |
datasets.dicomStores.export |
|
datasets.dicomStores.get |
healthcare.dicomStores.get per l'archivio DICOM richiesto. |
datasets.dicomStores.getIamPolicy |
healthcare.dicomStores.getIamPolicy per l'archivio DICOM richiesto. |
datasets.dicomStores.import |
|
datasets.dicomStores.list |
healthcare.dicomStores.list per il set di dati padre. |
datasets.dicomStores.patch |
healthcare.dicomStores.update per l'archivio DICOM richiesto. |
datasets.dicomStores.searchForInstances |
healthcare.dicomStores.dicomWebRead per l'archivio DICOM richiesto. |
datasets.dicomStores.searchForSeries |
healthcare.dicomStores.dicomWebRead per l'archivio DICOM richiesto. |
datasets.dicomStores.searchForStudies |
healthcare.dicomStores.dicomWebRead per l'archivio DICOM richiesto. |
datasets.dicomStores.setIamPolicy |
healthcare.dicomStores.setIamPolicy per l'archivio DICOM richiesto. |
datasets.dicomStores.storeInstances |
healthcare.dicomStores.dicomWebWrite per l'archivio DICOM richiesto. |
datasets.dicomStores.studies.delete |
healthcare.dicomStores.dicomWebDelete per l'archivio DICOM richiesto. |
datasets.dicomStores.studies.retrieveMetadata |
healthcare.dicomStores.dicomWebRead per l'archivio DICOM richiesto. |
datasets.dicomStores.studies.retrieveStudy |
healthcare.dicomStores.dicomWebRead per l'archivio DICOM richiesto. |
datasets.dicomStores.studies.searchForInstances |
healthcare.dicomStores.dicomWebRead per l'archivio DICOM richiesto. |
datasets.dicomStores.studies.searchForSeries |
healthcare.dicomStores.dicomWebRead per l'archivio DICOM richiesto. |
datasets.dicomStores.studies.storeInstances |
healthcare.dicomStores.dicomWebWrite per l'archivio DICOM richiesto. |
datasets.dicomStores.studies.updateInstances |
healthcare.dicomStores.dicomWebUpdate per l'archivio DICOM richiesto. |
datasets.dicomStores.studies.updateMetadata |
healthcare.dicomStores.dicomWebUpdate per l'archivio DICOM richiesto. |
datasets.dicomStores.studies.series.delete |
healthcare.dicomStores.dicomWebDelete per l'archivio DICOM richiesto. |
datasets.dicomStores.studies.series.retrieveMetadata |
healthcare.dicomStores.dicomWebRead per l'archivio DICOM richiesto. |
datasets.dicomStores.studies.series.retrieveSeries |
healthcare.dicomStores.dicomWebRead per l'archivio DICOM richiesto. |
datasets.dicomStores.studies.series.searchForInstances |
healthcare.dicomStores.dicomWebRead per l'archivio DICOM richiesto. |
datasets.dicomStores.studies.series.updateMetadata |
healthcare.dicomStores.dicomWebUpdate per l'archivio DICOM richiesto. |
datasets.dicomStores.studies.series.instances.delete |
healthcare.dicomStores.dicomWebDelete per l'archivio DICOM richiesto. |
datasets.dicomStores.studies.series.instances.retrieveInstance |
healthcare.dicomStores.dicomWebRead per l'archivio DICOM richiesto. |
datasets.dicomStores.studies.series.instances.retrieveMetadata |
healthcare.dicomStores.dicomWebRead per l'archivio DICOM richiesto. |
datasets.dicomStores.studies.series.instances.retrieveRendered |
healthcare.dicomStores.dicomWebRead per l'archivio DICOM richiesto. |
datasets.dicomStores.studies.series.instances.updateMetadata |
healthcare.dicomStores.dicomWebUpdate per l'archivio DICOM richiesto. |
datasets.dicomStores.studies.series.instances.frames.retrieveFrames |
healthcare.dicomStores.dicomWebRead per l'archivio DICOM richiesto. |
datasets.dicomStores.studies.series.instances.frames.retrieveRendered |
healthcare.dicomStores.dicomWebRead per l'archivio DICOM richiesto. |
datasets.dicomStores.studies.series.instances.bulkdata.retrieveBulkdata |
healthcare.dicomStores.dicomWebRead per l'archivio DICOM richiesto. |
Metodi per archivi FHIR
Metodo per archivi FHIR | Autorizzazioni obbligatorie |
---|---|
datasets.fhirStores.applyConsents |
healthcare.fhirStores.applyConsents per la risorsa richiesta dell'archivio FHIR. |
datasets.fhirStores.applyAdminConsents |
healthcare.fhirStores.applyConsents per la risorsa richiesta dell'archivio FHIR. |
datasets.fhirStores.configureSearch |
healthcare.fhirStores.configureSearch per l'archivio FHIR richiesto. |
datasets.fhirStores.create |
healthcare.fhirStores.create per il set di dati padre. |
datasets.fhirStores.deidentify |
|
datasets.fhirStores.delete |
healthcare.fhirStores.delete per l'archivio FHIR richiesto. |
datasets.fhirStores.explainDataAccess |
healthcare.fhirStores.explainDataAccess per la risorsa richiesta dell'archivio FHIR. |
datasets.fhirStores.export |
|
datasets.fhirStores.get |
healthcare.fhirStores.get per l'archivio FHIR richiesto. |
datasets.fhirStores.getFHIRStoreMetrics |
healthcare.fhirStores.get per l'archivio FHIR richiesto. |
datasets.fhirStores.getIamPolicy |
healthcare.fhirStores.getIamPolicy per l'archivio FHIR richiesto. |
datasets.fhirStores.import |
|
datasets.fhirStores.list |
healthcare.fhirStores.list per il set di dati padre. |
datasets.fhirStores.patch |
healthcare.fhirStores.update per l'archivio FHIR richiesto. |
datasets.fhirStores.rollback |
healthcare.fhirStores.rollback per l'archivio FHIR richiesto. |
datasets.fhirStores.setIamPolicy |
healthcare.fhirStores.setIamPolicy per l'archivio FHIR richiesto. |
datasets.fhirStores.fhir.Encounter-everything |
healthcare.fhirResources.get su ogni risorsa restituita. |
datasets.fhirStores.fhir.Observation-lastn |
healthcare.fhirStores.searchResources per l'archivio FHIR padre. |
datasets.fhirStores.fhir.Patient-everything |
healthcare.fhirResources.get su ogni risorsa restituita. |
datasets.fhirStores.fhir.Resource-purge |
healthcare.fhirResources.purge per la risorsa richiesta dell'archivio FHIR. |
datasets.fhirStores.fhir.capabilities |
healthcare.fhirStores.get per l'archivio FHIR richiesto. |
datasets.fhirStores.fhir.conditionalDelete |
|
datasets.fhirStores.fhir.conditionalPatch |
|
datasets.fhirStores.fhir.conditionalUpdate |
|
datasets.fhirStores.fhir.create |
|
datasets.fhirStores.fhir.delete |
healthcare.fhirResources.delete per la risorsa richiesta dell'archivio FHIR. |
datasets.fhirStores.fhir.executeBundle |
healthcare.fhirResources.executeBundle per l'archivio FHIR richiesto e autorizzazioni aggiuntive (come healthcare.fhirResources.create e healthcare.fhirResources.update ) corrispondenti alle singole operazioni all'interno del bundle. Se chi effettua la chiamata dell'API dispone delle autorizzazioni healthcare.fhirResources.create , ma non delle autorizzazioni healthcare.fhirResources.update , può eseguire solo bundle contenenti operazioni healthcare.fhirResources.create . |
datasets.fhirStores.fhir.history |
healthcare.fhirResources.get per la risorsa richiesta dell'archivio FHIR e per ciascuna delle sue versioni. |
datasets.fhirStores.fhir.patch |
healthcare.fhirResources.patch per la risorsa richiesta dell'archivio FHIR. |
datasets.fhirStores.fhir.read |
healthcare.fhirResources.get per la risorsa richiesta dell'archivio FHIR. |
datasets.fhirStores.fhir.search |
healthcare.fhirStores.searchResources per l'archivio FHIR padre. |
datasets.fhirStores.fhir.update |
healthcare.fhirResources.update per la risorsa richiesta dell'archivio FHIR. |
datasets.fhirStores.fhir.vread |
healthcare.fhirResources.get per la versione della risorsa richiesta dell'archivio FHIR. |
datasets.fhirStores.fhir.Patient-consent-enforcement-status |
healthcare.fhirResources.get per la risorsa paziente dell'archivio FHIR richiesta. |
datasets.fhirStores.fhir.Consent-enforcement-status |
healthcare.fhirResources.get per la risorsa di consenso dell'archivio FHIR richiesta. |
Metodi per archivi HL7v2
Metodo per archivi HL7v2 | Autorizzazioni obbligatorie |
---|---|
datasets.hl7V2Stores.create |
healthcare.hl7V2Stores.create per il set di dati padre. |
datasets.hl7V2Stores.delete |
healthcare.hl7V2Stores.delete per l'archivio HL7v2 richiesto. |
datasets.hl7V2Stores.export |
healthcare.hl7V2Stores.export per l'archivio HL7v2 richiesto. |
datasets.hl7V2Stores.get |
healthcare.hl7V2Stores.get per l'archivio HL7v2 richiesto. |
datasets.hl7V2Stores.import |
healthcare.hl7V2Stores.import per l'archivio HL7v2 richiesto. |
datasets.hl7V2Stores.list |
healthcare.hl7V2Stores.list per il set di dati padre. |
datasets.hl7V2Stores.patch |
healthcare.hl7V2Stores.update per l'archivio HL7v2 richiesto. |
datasets.hl7V2Stores.getIamPolicy |
healthcare.hl7V2Stores.getIamPolicy per l'archivio HL7v2 richiesto. |
datasets.hl7V2Stores.setIamPolicy |
healthcare.hl7V2Stores.setIamPolicy per l'archivio HL7v2 richiesto. |
datasets.hl7V2Stores.messages.create |
healthcare.hl7V2Messages.create per l'archivio HL7v2 padre. |
datasets.hl7V2Stores.messages.delete |
healthcare.hl7V2Messages.delete per il messaggio richiesto dell'archivio HL7v2. |
datasets.hl7V2Stores.messages.get |
healthcare.hl7V2Messages.get per il messaggio richiesto dell'archivio HL7v2. |
datasets.hl7V2Stores.messages.ingest |
healthcare.hl7V2Messages.ingest per il messaggio richiesto dell'archivio HL7v2. |
datasets.hl7V2Stores.messages.list |
healthcare.hl7V2Messages.list per l'archivio HL7v2 padre. |
datasets.hl7V2Stores.messages.patch |
healthcare.hl7V2Messages.update per il messaggio richiesto dell'archivio HL7v2. |
Metodi di localizzazione
Metodo di localizzazione | Autorizzazioni obbligatorie |
---|---|
locations.get |
healthcare.locations.get nella posizione richiesta. |
locations.list |
healthcare.locations.list sul progetto Google Cloud padre. |
Metodi dell'API Healthcare Natural Language
Metodo API Healthcare Natural Language | Autorizzazioni obbligatorie |
---|---|
nlp.analyzeEntities |
healthcare.nlpservice.analyzeEntities |
Metodi di funzionamento
Metodo operations | Autorizzazione obbligatoria |
---|---|
datasets.operations.get |
healthcare.operations.get per il set di dati richiesto. |
datasets.operations.list |
healthcare.operations.list per il set di dati richiesto. |
datasets.operations.cancel |
healthcare.operations.cancel per il set di dati richiesto. |
Metodi di anonimizzazione
Metodo di anonimizzazione | Autorizzazione obbligatoria |
---|---|
services.deidentify.deidentifyDicomInstance |
healthcare.deidentify.run |
services.deidentify.deidentifyFhirResource |
healthcare.deidentify.run |
Ruoli
Le tabelle riportate di seguito elencano i ruoli IAM per l'API Cloud Healthcare, comprese le autorizzazioni associate a ciascun ruolo. I ruoli roles/owner
, roles/editor
e roles/viewer
includono le autorizzazioni per altri servizi Google Cloud . Per ulteriori informazioni sui ruoli, consulta la sezione Informazioni sui ruoli.
Ruoli del datastore di consensi
Ruolo per l'archivio di consensi | Autorizzazioni |
---|---|
Healthcare Consent Store Viewer( Elenca gli archivi di consensi in un set di dati. |
|
Healthcare Consent Store Administrator( Amministra archivi di consensi. |
|
Ruoli relativi ai consensi
Ruolo Consensi | Autorizzazioni |
---|---|
Healthcare Attribute Definition Reader( Leggi oggetti AttributeDefinition in un datastore di consensi. |
|
Healthcare Attribute Definition Editor( Modifica oggetti AttributeDefinition. |
|
Healthcare Consent Artifact Reader( Leggi oggetti ConsentArtifact in un datastore di consensi. |
|
Healthcare Consent Artifact Editor( Modifica oggetti ConsentArtifact. |
|
Healthcare Consent Artifact Administrator( Amministra oggetti ConsentArtifact. |
|
Healthcare Consent Reader( Leggi oggetti Consent in un datastore di consensi. |
|
Healthcare Consent Editor( Modifica oggetti Consenso. |
|
Healthcare User Data Mapping Reader( Leggi oggetti UserDataMapping in un datastore di consensi. |
|
Healthcare User Data Mapping Editor( Modifica oggetti UserDataMapping. |
|
Ruoli per set di dati
Ruolo per set di dati | Autorizzazioni |
---|---|
Healthcare Dataset Viewer( Elenca i set di dati Healthcare di un progetto. |
|
Healthcare Dataset Administrator( Amministra i set di dati Healthcare. |
|
Ruoli per archivi DICOM
Ruolo per archivi DICOM | Autorizzazioni |
---|---|
Healthcare DICOM Store Viewer( Elenca gli archivi DICOM in un set di dati. |
|
Healthcare DICOM Store Administrator( Amministra gli archivi DICOM. |
|
Healthcare DICOM Viewer( Recupera le immagini DICOM da un archivio DICOM. |
|
Healthcare DICOM Editor( Modifica immagini DICOM singolarmente o in blocchi. |
|
Ruoli per archivi FHIR
Ruolo per archivi FHIR | Autorizzazioni |
---|---|
Healthcare FHIR Store Viewer( Elenca gli archivi FHIR in un set di dati. |
|
Healthcare FHIR Store Administrator( Amministra archivi di risorse FHIR. |
|
Healthcare FHIR Resource Reader( Legge e cerca le risorse FHIR. |
|
Healthcare FHIR Resource Editor( Crea, elimina, aggiorna, legge e cerca le risorse FHIR. |
|
Ruoli per archivi HL7v2
Ruolo per archivi HL7v2 | Autorizzazioni |
---|---|
Healthcare HL7v2 Store Viewer( Visualizza gli archivi HL7v2 in un set di dati. |
|
Healthcare HL7v2 Store Administrator( Amministra gli archivi HL7v2. |
|
Healthcare HL7v2 Message Ingest( Importa i messaggi HL7v2 ricevuti da una rete di origine. |
|
Healthcare HL7v2 Message Consumer( Elenca e legge i messaggi HL7v2, aggiorna le etichette dei messaggi e pubblica nuovi messaggi. |
|
Healthcare HL7v2 Message Editor( Accesso in lettura, scrittura ed eliminazione ai messaggi HL7v2. |
|
Ruoli dell'API Healthcare Natural Language
Ruolo dell'API Healthcare Natural Language | Autorizzazioni |
---|---|
Healthcare NLP Service Viewer Beta( Estrazione e analisi di entità mediche da un dato testo. |
|
Agente di servizio Cloud Healthcare
L'agente di servizio Cloud Healthcare è un account di servizio condiviso nel tuo progetto che l'API Cloud Healthcare utilizza per interagire con altre risorse inGoogle Cloud.
Ad esempio, questo service agent viene utilizzato per leggere e scrivere nei bucket Cloud Storage, scrivere in BigQuery e pubblicare messaggi in Pub/Sub dall'API Cloud Healthcare.
Per eseguire una delle azioni precedenti, devi concedere all'agente di servizio Cloud Healthcare l'accesso al bucket Cloud Storage, al set di dati BigQuery o all'argomento Pub/Sub pertinente.
Quando crei un modello di autorizzazioni per il tuo progetto, ricorda che la concessione di uno qualsiasi dei ruoli elencati di seguito consente all'utente di richiamare operazioni eseguite come agente di servizio Cloud Healthcare e di accedere a tutti i dati a cui l'agente ha accesso:
roles/healthcare.consentStoreAdmin
roles/healthcare.consentStoreViewer
roles/healthcare.dicomStoreEditor
roles/healthcare.dicomStoreViewer
roles/healthcare.fhirStoreAdmin
roles/healthcare.hl7V2StoreAdmin
Analogamente, l'assegnazione delle seguenti autorizzazioni ai ruoli personalizzati consentirebbe all'utente di richiamare operazioni che verranno eseguite come agente di servizio Cloud Healthcare:
healthcare.consentStores.queryAccessibleData
healthcare.dicomStores.create
healthcare.dicomStores.update
healthcare.dicomStores.import
healthcare.dicomStores.export
healthcare.fhirStores.create
healthcare.fhirStores.update
healthcare.fhirStores.import
healthcare.fhirStores.export
healthcare.hl7V2Stores.create
healthcare.hl7V2Stores.update
Ad esempio:
- Se un utente dispone di autorizzazioni di importazione, può eseguire operazioni che agiscono come agente di servizio Cloud Healthcare se queste operazioni accedono a bucket Cloud Storage a cui l'agente di servizio Cloud Healthcare ha accesso in lettura.
- Se un utente dispone di autorizzazioni di esportazione, può eseguire operazioni che fungono da agente di servizio Cloud Healthcare se queste operazioni accedono a qualsiasi bucket a cui l'agente di servizio ha accesso in scrittura.
- Un utente che dispone delle autorizzazioni per creare o aggiornare un datastore può configurare le destinazioni di notifica Pub/Sub o le destinazioni di streaming BigQuery inviate dall'agente di servizio Cloud Healthcare quando vengono apportate modifiche al datastore.
Come best practice, utilizza più progetti per isolare ulteriormente le autorizzazioni concesse all'agente di servizio Cloud Healthcare.