Documentación de Oracle Cloud Infrastructure

Configuración del acceso a datos de un dominio IoT

La configuración del acceso a la vista de los datos es opcional y depende del sistema que desee utilizar para consumir los datos IoT.

Según dónde desee ver los datos IoT como parte de la configuración de cada sistema, debe configurar la autenticación para el dominio IoT para acceder al sistema específico al que desea conectarse.

  • Al crear un dominio, puede especificar las opciones de acceso a los datos. Después de crear un dominio, puede cambiar las opciones para autenticar una conexión para acceder a los datos.

    1. En la página de lista dominios, seleccione el dominio con el que desea trabajar. Si necesita ayuda para buscar la página de lista o un dominio IoT, consulte Listado de dominios IoT.
    2. Para ver qué opciones de autenticación están configuradas para este dominio IoT, seleccione el separador Acceso a datos.

      Según el tipo de conexión de datos que se haya configurado para el dominio, consulte los detalles de autenticación del grupo de dominios IoT. Por ejemplo, si ve Nombres de grupo de identidad, el dominio IoT se configura para autenticarse para ver los datos IoT mediante ORDS.

    3. Para actualizar la opción que utiliza el dominio IoT para ver los datos IoT, seleccione el menú Acciones y, a continuación, seleccione Cambiar acceso a datos.
    4. Seleccione cualquier tipo de acceso para introducir los detalles de autenticación para ver los datos de este dominio IoT en cualquiera de los siguientes sistemas:
      • acceso directo a los datos: si desea establecer una conexión directa a la base de datos para ver los datos de la base de datos, debe crear un grupo dinámico de identidades. O si desea conectarse a Analytics Cloud, debe configurar crear un usuario de dominio de identidad. Después de eso, introduzca el grupo o los grupos de identidad de IAM que pueden conectarse a la base de datos.

        Si hay varios usuarios de dominio de identidad configurados, agregue varios grupos de identidad para acceder a los datos de este dominio IoT, seleccione Agregar otro grupo de identidad.

        Introduzca cualquiera de las siguientes opciones para el grupo de identidades de IAM:

        • <identity-group-name> es el grupo de identidades de los usuarios o un grupo dinámico de identidades.
        • Si <identity-group-name> está en el dominio de identidad por defecto, utilice este formato:

          <tenancy-OCID:<identity-group-name>

        • Si <identity-group-name> no está en el dominio de identidad por defecto, utilice este formato para especificar el nombre de dominio de identidad para el grupo de usuarios de dominio de identidad o el grupo dinámico de identidad:

          <tenancy-OCID:<identity-domain-name>/<identity-group-name>

      • Acceso a Oracle REST Data Services (ORDS): para configurar el acceso a los datos en ORDS, introduzca el nombre de host de dominio de identidad autorizado para establecer una conexión con el host de datos mediante ORDS:

        idcs-<unique-id>.identity.oraclecloud.com

      • Acceso a Oracle Application Express (APEX): si configura el acceso a sus datos en APEX, introduzca la contraseña de APEX inicial para el espacio de trabajo de APEX del dominio IoT:

        <your-apex-initial-password>

        Nota

        La contraseña de APEX inicial debe tener al menos 12 caracteres.
    5. Seleccione Actualizar.
    6. (Opcional) Para ver la solicitud de trabajo de una actualización, vaya al dominio y, a continuación, seleccione el separador solicitud de trabajo.

      Seleccione el nombre de operación de la solicitud de trabajo para ver el OCID.

      Seleccione Mensajes para ver los mensajes de log relacionados, los errores de log y los recursos asociados. Por ejemplo, los recursos asociados para grupos de dominios muestran los dominios relacionados.

      Para obtener más información, consulte Obtención de detalles de una solicitud de trabajo para su Internet of Things.

  • La configuración depende del sistema con el que desee conectarse para ver los datos IoT. Ambas opciones requieren el uso del comando oci iot domain configure-direct-data-access durante el proceso de configuración:

    Utilice el comando oci iot domain configure-direct-data-access y los parámetros necesarios para configurar la autenticación de un dominio IoT para establecer una conexión directa a la base de datos.

    Sustituya <tenancy-OCID:<identity-group-name> por los valores de su entorno. <identity-group-name> puede hacer referencia al grupo de identidades de usuarios o al grupo dinámico de identidades.

    • Para el parámetro <identity-group-name>, puede hacer referencia al grupo de identidades de los usuarios o al grupo dinámico de identidades: <tenancy-OCID>:<identity-group-name>
    • Si <identity-domain-name> no está en el dominio de identidad por defecto, debe especificar <identity-domain-name>. Por ejemplo:

      <tenancy-OCID>:<identity-domain-name>/<identity-group-name>

    oci iot domain configure-direct-data-access --iot-domain-id <iot-domain-OCID> --db-allow-listed-identity-group-names '["<tenancy-OCID:<identity-domain-name>/<identity-group-name>"]'

    Para ver los datos en ORDS, es necesario configurar el acceso para ver los datos IoT en ORDS. Este proceso de configuración utiliza el siguiente comando.

    Utilice el comando oci iot domain configure-ORDS-data-access y los parámetros necesarios para configurar el acceso de un dominio IoT a Oracle REST Data Services (ORDS):

    oci iot domain configure-ords-data-access --iot-domain-id <iot-domain-OCID> --db-allowed-identity-domain-host <idcs-<unique-id>.identity.oraclecloud.com>

    Para ver los datos en APEX, es necesario configurar el acceso para ver los datos de IoT en APEX mediante el siguiente comando.

    Utilice el comando oci iot domain configure-apex-data-access y los parámetros necesarios para configurar el acceso de un dominio IoT a Oracle Application Express (APEX):

    oci iot domain configure-apex-data-access --iot-domain-id <iot-domain-OCID> --db-workspace-admin-initial-password "<your-apex-initial-password>"
    Nota

    La contraseña inicial de APEX debe tener al menos 12 caracteres.

    Para obtener una lista completa de los parámetros y valores de los comandos de la CLI, consulte Referencia de comandos de la CLI.

  • Ejecute la operación ConfigureIotDomainDataAccess para autenticar un dominio IoT para establecer una conexión directa a la base de datos:

    Si desea consultar los datos IoT directamente en la base de datos, debe configurar una conexión directa a la base de datos o si desea conectarse a Oracle Analytics Cloud, debe configurar una conexión a la base de datos con Oracle Analytics Cloud. Como parte del proceso de configuración, puede utilizar la API para agregar el usuario o grupo del dominio de identidad a un dominio IoT configurado para conectarse a la base de datos IoT, por ejemplo:
    POST /20250531/iotDomains/{iotDomainId}/actions/configureDataAccess
{
    "type": "DIRECT", 
    "dbAllowlistedIdentityGroupNames": ["<identity-group-name>",...]
}
    Para ver los datos en ORDS, es necesario configurar el acceso para ver los datos IoT en ORDS. Como parte del proceso de configuración, puede utilizar la API para agregar el host del dominio de identidad a un dominio IoT para conectarse a Oracle REST Data Services (ORDS), por ejemplo:
    POST /20250531/iotDomains/{iotDomainId}/actions/configureDataAccess
{
    "type": "ORDS",
    "dbAllowedIdentityDomainHost": "<idcs-<unique-id>.identity.oraclecloud.com>"
}
    Para ver los datos en APEX, es necesario configurar el acceso para ver los datos de IoT en APEX. Como parte de este proceso de configuración, puede utilizar la API para configurar APEX para el dominio IoT, por ejemplo:
    POST /20250531/iotDomains/{iotDomainId}/actions/configureDataAccess
{
  "type": "APEX",
  "dbWorkspaceAdminInitialPassword": "<your-apex-initial-password>"
}
    Nota

    La contraseña inicial de APEX debe tener al menos 12 caracteres.