Referencia: Autenticación y ámbitos
Revise el modelo de aplicación de dominios de identidad de OCI y la sintaxis de ámbito de OAuth utilizada para autorizar solicitudes de FHIR de DDFS protegidas.
Modelo de autenticación
DDFS se basa en dominios de identidad de OCI para emitir tokens de acceso de OAuth. Configure DDFS como un servidor de recursos protegido y configure una aplicación cliente confidencial independiente para cada emisor de llamada gestionado de forma independiente. Otorgue a cada cliente solo los ámbitos de recursos y operaciones requeridos por su flujo de trabajo.
Para conocer el procedimiento de configuración completo, consulte Creación de aplicaciones integradas para OAuth de DDFS.
Aplicaciones de dominio de identidad
| Aplicación integrada | Finalidad | Configuración |
|---|---|---|
| Servidor de recursos DDFS | Representa la API de FHIR de DDFS protegida y define los ámbitos que los clientes pueden solicitar. | Defina el público principal en el valor exacto en minúscula ddfs, defina los ámbitos de DDFS canónicos, guarde la configuración de OAuth y active la aplicación. |
| Aplicación Cliente | Representa una aplicación o servicio que llama a DDFS. | Utilice una aplicación confidencial, otorgue solo los ámbitos de DDFS necesarios, configure un método de autenticación de cliente aprobado, guarde la configuración de OAuth y active la aplicación. |
Dónde se configuran y solicitan los ámbitos
La misma autoridad de recurso de DDFS tiene un formato diferente en cada contexto de dominios de identidad:
| Contexto | Formulario de ámbito | Ejemplo |
|---|---|---|
| Definición de servidor de recursos | Canónico, sin el prefijo orientado al cliente | system/Patient.rs |
| Solicitud de token y otorgamiento de cliente | Prefijo ddfs fijo | ddfssystem/Patient.rs |
Reclamación de token emitido scope | Canónico, sin el prefijo orientado al cliente | system/Patient.rs |
Defina un ámbito en el servidor de recursos de DDFS antes de otorgarlo a un cliente. Un cliente solo puede solicitar ámbitos que se otorgan a esa aplicación cliente. La validación de público de token es independiente de esta asignación de ámbito.
Referencia de configuración de ámbito
Utilice los ámbitos de recursos y operaciones más estrechos que satisfagan el flujo de trabajo del cliente. El destino de recurso debe ser compatible con la versión de FHIR de DDFS seleccionada.
| Versión de FHIR | Destinos de Recursos |
|---|---|
| 4ª | AllergyIntolerance, CarePlan, CareTeam, Composition, Condition, Device, DiagnosticReport, DocumentReference, Encounter, Endpoint, FamilyMemberHistory, Group, Immunization, Location, Medication, MedicationRequest, MedicationStatement, Observation, Organization, Patient, Practitioner, PractitionerRole, Procedure, Provenance, RelatedPerson, ServiceRequest, and Specimen |
| Boleta R6-4 | Device, DeviceAssociation, Encounter, Location, Observation, Patient, Practitioner, PractitionerRole, Provenance, Subscription y SubscriptionTopic |
Para conocer las interacciones y operaciones admitidas para cada recurso, consulte FHIR R4 Resources, FHIR R6 Resources y FHIR Capability Statements. Compruebe el CapabilityStatement desplegado antes de configurar los ámbitos para un cliente.
| Flujo de trabajo | Definición de servidor de recursos | Solicitud de token y otorgamiento de cliente |
|---|---|---|
| Leer y buscar recursos del paciente | system/Patient.rs | ddfssystem/Patient.rs |
| Crear recursos de observación | system/Observation.c | ddfssystem/Observation.c |
| Leer y buscar recursos de dispositivos | system/Device.rs | ddfssystem/Device.rs |
| Leer y buscar Dispositivos de un fabricante | system/Device.rs?manufacturer=ExampleManufacturer | ddfssystem/Device.rs?manufacturer=ExampleManufacturer |
| Flujo de trabajo | Definición de servidor de recursos | Solicitud de token y otorgamiento de cliente | Requisito |
|---|---|---|---|
| Estado de suscripción de nivel de tipo | system/Subscription.s | ddfssystem/Subscription.s | El permiso de suscripción es necesario para Subscription/$status. |
| Estado de suscripción a nivel de instancia | system/Subscription.r | ddfssystem/Subscription.r | El permiso de suscripción es necesario para Subscription/{id}/$status. |
| Supresión y depuración permanentes suprimidas | system/{Resource}.d y https://docs.oracle.com/iaas/device-data-fhir/scopes/hard-delete | ddfssystem/{Resource}.d ddfshttps://docs.oracle.com/iaas/device-data-fhir/scopes/hard-delete | Se necesitan tanto el ámbito de supresión de recursos coincidentes como el ámbito de supresión permanente personalizado. |
| Ámbito parametrizado | system/{Resource}.{operations}?{criteria} | ddfssystem/{Resource}.{operations}?{criteria} | Utilice solo los parámetros de búsqueda anunciados para el recurso y la versión FHIR, y form-URL-encode el valor de solicitud de token completo. |
Sintaxis de ámbito
Defina un ámbito de recurso FHIR en el servidor de recursos DDFS de la siguiente forma:
system/<Resource>.<operations>
Al otorgar o solicitar esa autoridad para un cliente, agregue el prefijo ddfs fijo como se describe en Donde se configuran y solicitan los ámbitos.
| Carta o alias | Significado |
|---|---|
c | crear |
r | leído |
u | actualizar |
d | suprimir |
s | búsqueda |
read | r y s |
write | c, u y d |
* | c, r, u, d y s |
El nombre del recurso debe identificar un recurso FHIR admitido por la versión de FHIR de DDFS seleccionada. Utilice permisos comodín sólo cuando una alternativa de ámbito restringido no pueda satisfacer el flujo de trabajo administrativo.
Definiciones del ámbito del servidor de recursos
Defina cada ámbito de DDFS que solicite el cliente en el servidor de recursos de forma canónica. Por ejemplo, system/Patient.r autoriza las operaciones de lectura del paciente, pero no la búsqueda del paciente. Utilice system/Patient.rs o system/Patient.read cuando el cliente necesite tanto lectura como búsqueda.
Confirme que el recurso y la interacción se anuncian en CapabilityStatement para la versión de FHIR utilizada por el cliente.
Concesiones de clientes y solicitudes de token
Otorgue a un cliente solo los ámbitos requeridos por ese emisor de llamada. Solicite los valores con prefijo ddfs correspondientes en la solicitud de token, separados por espacios.
Por ejemplo, una solicitud de token de credenciales de cliente para acceso de búsqueda y lectura de dispositivo incluye:
grant_type=client_credentials
scope=ddfssystem/Device.rs
Form-URL-codificar el cuerpo de la solicitud. Después de que los dominios de identidad devuelvan el token de acceso, envíelo a DDFS en la cabecera Authorization: Bearer <access_token>. La operación normal del cliente no requiere descodificar el token.
Ámbitos parametrizados
Un ámbito con parámetros restringe la autorización de recursos agregando criterios de búsqueda de FHIR soportados después de ?. Defina el formulario canónico en el servidor de recursos de DDFS y utilice el formulario con prefijo ddfs correspondiente para la solicitud de token y otorgamiento de cliente.
Definición del servidor de recursos:
system/Device.rs?manufacturer=ExampleManufacturer
Solicitud de token y otorgamiento de cliente:
ddfssystem/Device.rs?manufacturer=ExampleManufacturer
Una restricción de token codificado puede incluir el sistema y el código separados por |:
ddfssystem/Observation.rs?category=http://terminology.hl7.org/CodeSystem/observation-category|vital-signs
- Utilice solo los parámetros de búsqueda anunciados para el recurso de destino y la versión de FHIR.
- Separe varios ámbitos solicitados con un espacio.
- Cuando un ámbito restringido contiene varios criterios, combine los criterios con
&. - Form-URL-codifica el valor
scopecompleto de la solicitud de token. Esto protege los espacios y los caracteres reservados, como?,&y|.
Ámbito de supresión permanente personalizado
Las operaciones $hardDelete y $purgeDeleted necesitan tanto un ámbito de supresión de recursos coincidente como el ámbito de supresión permanente personalizado.
Defina estos valores canónicos en el servidor de recursos DDFS para un flujo de trabajo de administración de pacientes:
system/Patient.d
https://docs.oracle.com/iaas/device-data-fhir/scopes/hard-delete
Otorgue y solicite estos valores orientados al cliente:
ddfssystem/Patient.d ddfshttps://docs.oracle.com/iaas/device-data-fhir/scopes/hard-delete
El token emitido contiene los valores canónicos correspondientes. Configure esta autorización elevada solo para clientes administrativos que requieran operaciones de supresión permanente.
Límite de autorización admitido
DDFS utiliza ámbitos de OAuth de dominios de identidad de OCI para la autorización de recursos de FHIR. DDFS no proporciona flujos de trabajo de inicio SMART ni autoriza recursos FHIR con formularios de ámbito SMART user/... y patient/....
Usar tokens de acceso
Tratar los tokens de acceso y las afirmaciones de cliente como credenciales. No las registre, las retenga más tiempo del necesario, las confirme en el control de origen o las pegue en tickets de soporte. Envíe un token de acceso a DDFS solo en la cabecera HTTP Authorization: Bearer <access_token>.
Solución de problemas
| Problema | Causa Posible | Acción |
|---|---|---|
| La solicitud de token informa de un ámbito no válido o no autorizado. | Falta el ámbito en el servidor de recursos, no se otorga al cliente, utiliza el formulario de contexto incorrecto o no está codificado en forma URL. | Compare la definición de servidor de recursos y el formulario de cliente en Where Scopes Are Configured and Requested. Confirme el permiso y, a continuación, form-URL-encode el parámetro de ámbito completo. |
| Un ámbito con parámetros no autoriza la solicitud esperada. | El recurso no anuncia el parámetro de búsqueda, el ámbito contiene un formulario de valor no soportado o no se han codificado los caracteres reservados. | Compruebe las definiciones CapabilityStatement y SearchParameter desplegadas. Codifique el valor de solicitud de token completo, incluidos ?, & y |. |
| DDFS devuelve HTTP 401. | Falta el token, ha caducado, tiene un formato incorrecto o no se ha emitido para el público y el dominio de identidad de DDFS configurados. | Solicite un nuevo token del dominio de identidad configurado y envíelo una vez en la cabecera del portador. No revele el token al recopilar diagnósticos. |
| DDFS devuelve HTTP 403. | El token no otorga el recurso y la operación necesarios para la solicitud. | Compare la interacción solicitada con los ámbitos otorgados. Agregue solo el ámbito de privilegio mínimo que falta. |
| No se autoriza una solicitud de supresión definitiva o de supresión de depuración. | Al cliente le falta el ámbito de supresión de recurso coincidente o el ámbito de supresión permanente personalizado. | Otorgue y solicite ambos valores que se muestran en Ámbito de supresión permanente personalizado. |
Para ver los problemas de configuración de aplicaciones, consulte Solución de problemas de Integrated Application Setup.
Preguntas frecuentes
- ¿Por qué los ámbitos de cliente y servidor de recursos tienen un aspecto diferente?
- El servidor de recursos define los valores canónicos
system/.... Los permisos de cliente y las solicitudes de token agregan el prefijoddfsfijo para que los dominios de identidad puedan asociar la solicitud al servidor de recursos de DDFS. - ¿Puedo otorgar acceso con comodines?
- La sintaxis de comodín está disponible, pero se prefiere el privilegio mínimo. Otorgue operaciones específicas de recursos a menos que un flujo de trabajo administrativo no pueda funcionar con un ámbito más restringido.
- ¿Por qué el ámbito token-request debe estar codificado en form-URL?
- El campo de ámbito puede contener espacios y caracteres reservados. La codificación de URL de formulario conserva los valores de ámbito exactos cuando se envía la solicitud.
- ¿Dónde puedo configurar la autenticación de cliente basada en certificados?
- Siga el Paso 3: Creación y activación de la aplicación cliente. Para DDFS, configure el permiso Credenciales de cliente con autenticación de afirmación de cliente JWT, seleccione Cliente de confianza e importe el certificado público del cliente. La clave privada coincidente permanece con la aplicación que realiza la llamada y firma cada afirmación de cliente de JWT de corta duración.
- ¿Admite DDFS SMART la autorización FHIR?
- Nº Utilice el modelo de OAuth de dominios de identidad de OCI y los ámbitos del sistema DDFS documentados en esta página.
- ¿Por qué la supresión definitiva necesita dos ámbitos?
- El ámbito de supresión del recurso otorga autoridad de supresión para el recurso seleccionado, mientras que el ámbito de supresión permanente personalizado otorga acceso a las operaciones de supresión permanente. Ambos son necesarios.
- ¿Debe un cliente descodificar o almacenar su token de acceso?
- Nº Un cliente normal envía el token a DDFS como credencial de portador y lo conserva solo el tiempo que sea necesario para el flujo de trabajo autorizado.