Solución de problemas

Utilice la información de resolución de problemas para identificar y abordar las incidencias comunes que se pueden producir al trabajar con el servicio de FHIR de datos de dispositivos.

Consulte también Preguntas frecuentes sobre el servicio FHIR de datos de dispositivos.

Políticas de Usuario

Solucione los problemas que faltan en las políticas de IAM y los ámbitos de OAuth de DDFS para las tareas comunes de consola, API, métricas, solicitud de trabajo y suscripción de DDFS.

Un usuario no puede mostrar, crear, actualizar, mover ni suprimir instancias de DDFS; ver solicitudes de trabajo; consultar métricas; o crear y supervisar suscripciones de FHIR. La consola o la API pueden devolver un mensaje de autorización, prohibido, no autorizado o de permiso denegado.

Causa

El grupo, la aplicación o el principal de servicio del usuario no tienen el acceso necesario para el recurso, el compartimento o la operación. DDFS utiliza políticas de OCI IAM para recursos de servicio como instancias, solicitudes de trabajo, métricas y secretos de Vault. DDFS utiliza ámbitos de OAuth de dominios de identidad de OCI para recursos del plano de datos de FHIR, como Subscription y SubscriptionTopic.

Solución

Solicite a un administrador que compare la operación con fallos, el compartimento y el emisor de llamada con los requisitos de política y ámbito.

Acceso necesario por tarea
Tarea Acceso necesario Referencia
Instancias de DDFS Utilice ddfs-instance-family para un acceso amplio o ddfs-instance para el acceso solo de instancia. inspect muestra las instancias, read obtiene los detalles de la instancia, use actualiza las instancias y manage crea, suprime o mueve instancias. Políticas de instancia de DDFS
Solicitudes de trabajo Utilice ddfs-instance-family o ddfs-work-request. inspect muestra las solicitudes de trabajo, los errores y los logs; read obtiene los detalles de la solicitud de trabajo; manage cancela las solicitudes de trabajo. Políticas de solicitud de trabajo de DDFS
Métricas Otorgue al grupo de usuarios el permiso para leer métricas en el compartimento que contiene la instancia de DDFS: Allow group <group-name> to read metrics in compartment <compartment-name>. Referencia de políticas y métricas
Suscripciones FHIR Otorgue los ámbitos de OAuth de la aplicación cliente DDFS para los recursos de suscripción a los que llama, como ddfssystem/Subscription.* y ddfssystem/SubscriptionTopic.*. Si una suscripción utiliza un secreto de OCI Vault para la autorización de salida, también otorgue al servicio DDFS acceso para leer el secreto. Autenticación y ámbitos, Extensión secreta de OCI Vault de suscripción y política secreta de autorización de suscripción
  1. Capture la operación exacta, el punto final de API o la página de la consola, el compartimento, la región, el código de respuesta, el texto de error y el identificador de solicitud.
  2. Determine si el fallo es para un recurso de servicio de OCI o una solicitud del plano de datos de FHIR. Para los recursos del servicio OCI, consulte las políticas de IAM. Para las solicitudes FHIR, compruebe los ámbitos de emisor, público y DDFS del token de OAuth.
  3. Verifique que el usuario está en el grupo de IAM denominado en la política y que la política se escribe para el compartimento que contiene el recurso o las métricas de DDFS.
  4. Compare la operación fallida con los permisos y políticas del servicio FHIR de datos del dispositivo. Agregue el verbo de privilegio mínimo o el permiso que cubre la operación.
  5. Para los fallos de suscripción, verifique que el cliente ha solicitado un nuevo token de acceso después de los cambios de ámbito y que el token contiene los valores de ámbito canónicos system/... necesarios para la operación de tema de suscripción o suscripción.
  6. Vuelva a intentar la operación después de las actualizaciones de política o ámbito. Si el error continúa, compruebe Audit o Logging Search para las solicitudes denegadas y confirme que la solicitud tiene como destino el compartimento y la región esperados.

Errores de autorización

Resolución de problemas de respuestas 401 y 403 de las API de FHIR de DDFS.

Una solicitud de API de FHIR de DDFS devuelve una respuesta 401 o 403.

Causa

Falta el token de acceso, caducó, tiene un emisor o público incorrecto o no incluye un ámbito de autorización de FHIR de DDFS admitido. DDFS no admite ámbitos de contexto SMART user/..., patient/... ni de inicio para la autorización de recursos de FHIR.

Solución

Confirme que el servidor de recursos, la aplicación cliente, el valor de público y los ámbitos de DDFS de los dominios de identidad de OCI están configurados correctamente.

  1. Verifique que el emisor de token, el emisor de inquilino y el público coincidan con la configuración de despliegue de DDFS.
  2. Verifique que el token contenga los ámbitos de recursos de DDFS canónicos requeridos por la solicitud, como system/Patient.rs o system/Observation.read. Los permisos de cliente y las solicitudes de token utilizan los valores con prefijo correspondientes, como ddfssystem/Patient.rs o ddfssystem/Observation.read.
  3. Elimine los ámbitos de inicio, usuario o paciente SMART no admitidos de los ejemplos de autorización y las solicitudes de cliente de DDFS FHIR.
  4. Para obtener información sobre la sintaxis del ámbito, el prefijo fijo orientado al cliente ddfs, la validación de público de token y los requisitos de supresión permanente, consulte Reference: Authentication and Scopes.

Códigos de estado de recurso

Solución de problemas de códigos de estado de respuesta de API de FHIR comunes.

Una llamada de API de FHIR de DDFS devuelve un código de estado inesperado.

Causa

La solicitud puede fallar debido a errores de autenticación, autorización, validación, operación no admitida o estado de recurso.

Solución

EstadoDescripción o cómo solucionarlo
200Lectura, búsqueda, actualización u operación correctas que devuelven un cuerpo de respuesta.
201Creación de recurso correcta.
204Supresión correcta sin cuerpo de respuesta.
400Sintaxis de solicitud, parámetros o carga útil no válidos.
401Falta el token de acceso de OAuth, ha caducado o no es válido.
403El token es válido, pero no autoriza la operación de recurso de FHIR solicitada.
404Read, history o hard-delete para los recursos que faltan.
405No existe un destino de actualización y la opción update-create no está soportada.
410El recurso solicitado se ha suprimido.
422Fallo de validación de regla de negocio, por ejemplo, sin disparador de suscripción coincidente.
500El servicio devolvió un error interno.