Appearance
Scopes SMART
Los scopes definen qué datos puede leer Quralo de la API FHIR de tu sistema de salud. Se eligen de una lista curada (nunca texto libre) al crear o editar la integración.
Formato de los scopes
Siguen el formato SMART system/{Recurso}.{operación}:
system/— indica que el token actúa a nombre del sistema (M2M), no de un usuario.Patient,Observation, etc. — el recurso FHIR al que da acceso..read— la operación permitida (en esta integración, lectura).
Catálogo de scopes
| Scope (valor enviado) | Label en UI | Descripción en UI |
|---|---|---|
system/Patient.read | Lectura de pacientes | Permite leer datos demográficos de pacientes. |
system/Observation.read | Lectura de observaciones | Permite leer resultados y observaciones clínicas, como laboratorio y signos vitales. |
system/DiagnosticReport.read | Lectura de informes de diagnóstico | Permite leer informes de diagnóstico, como imágenes o laboratorio. |
system/MedicationRequest.read | Lectura de prescripciones de medicación | Permite leer solicitudes de medicación. |
system/ServiceRequest.read | Lectura de solicitudes de servicio | Permite leer solicitudes de servicio, como estudios o procedimientos. |
system/Encounter.read | Lectura de encuentros | Permite leer encuentros clínicos. |
system/*.read | Lectura de todos los recursos | Otorga lectura sobre todos los recursos FHIR del sistema externo. Usar solo si es necesario. |
system/*.read
El scope system/*.read otorga lectura sobre todos los recursos FHIR del sistema externo. Es el de mayor privilegio: usalo solo si es necesario y preferí otorgar los scopes específicos que cubran las necesidades reales de tus add-ons (principio de menor privilegio).
Cómo se relacionan con los add-ons
- Los add-ons de Quralo indican qué scopes necesitan. Si un add-on requiere un scope que no está configurado, el sistema advertirá qué scopes faltan.
- Al configurar la integración, incluí al menos los scopes que requieren los add-ons que vas a usar. Podés agregar scopes que sobren, pero lo recomendable es otorgar el mínimo necesario.
"Unificar scopes" y subconjuntos
El campo Unificar scopes controla cómo Quralo pide los scopes en cada token:
| Situación | Comportamiento |
|---|---|
| Sin marcar (default) | Quralo solicita a futuro el subset de scopes que requiera cada add-on, dentro de los configurados. Cada token pide solo lo que necesita (menor privilegio por token). |
| Marcado | Quralo siempre solicita todos los scopes configurados (la unión completa), sin importar el add-on. |
¿Cuándo marcar "Unificar scopes"?
Marcalo solo si tu sistema externo no soporta solicitar subconjuntos de los scopes concedidos al cliente y rechaza las peticiones de tokens con un subset. Si lo soporta, dejalo sin marcar para aprovechar el menor privilegio por token.
Verificación de scopes
Cuando Quralo obtiene un token con un subset de scopes, el token endpoint del sistema externo debe responder con un access token restringido a ese subset. Si el servidor rechaza la petición, es señal de que no soporta subsets y deberías marcar Unificar scopes.
Para el detalle de cómo se validan los scopes en la verificación de la conexión, ver Verificación y monitoreo.