Documentation Oracle Cloud Infrastructure

Configuration de l'accès aux données d'un domaine IoT

La configuration de l'accès à la vue de vos données est facultative et dépend du système à utiliser pour utiliser vos données IoT.

Selon l'endroit où vous souhaitez afficher vos données IoT dans le cadre de la configuration de chaque système, vous devez configurer l'authentification pour le domaine IoT afin d'accéder au système spécifique auquel vous souhaitez vous connecter.

  • Lorsque vous créez un domaine, vous pouvez spécifier les options d'accès aux données. Une fois le domaine créé, vous pouvez modifier les options d'authentification d'une connexion pour accéder à vos données.

    1. Sur la page de liste domains, sélectionnez le domaine avec lequel vous voulez travailler. Si vous avez besoin d'aide pour trouver la page de liste ou un domaine IoT, reportez-vous à Liste des domaines IoT.
    2. Pour afficher les options d'authentification configurées pour ce domaine IoT, sélectionnez l'onglet Accès aux données.

      En fonction du type de connexion de données configuré pour le domaine, affichez les détails d'authentification du groupe de domaines IoT. Par exemple, si vous voyez des noms de groupe d'identités, le domaine IoT est configuré pour s'authentifier afin de visualiser les données IoT à l'aide d'ORDS.

    3. Pour mettre à jour l'option utilisée par le domaine IoT pour visualiser les données IoT, sélectionnez le menu Actions, puis Modifier l'accès aux données.
    4. Sélectionnez un type d'accès pour entrer les détails d'authentification afin de visualiser les données de ce domaine IoT dans l'un des systèmes suivants :
      • Accès direct aux données : si vous voulez établir une connexion directe à la base de données pour visualiser les données de la base de données, vous devez créer un groupe dynamique d'identité. Ou si vous voulez vous connecter à Analytics Cloud, vous devez configurer créer un utilisateur de domaine d'identité. Entrez ensuite le ou les groupes d'identités IAM autorisés à se connecter à la base de données.

        Si plusieurs utilisateurs de domaine d'identité sont configurés, ajoutez plusieurs groupes d'identités pour accéder aux données de ce domaine IoT, puis sélectionnez Ajouter un autre groupe d'identités.

        Entrez l'une des options suivantes pour le groupe d'identités IAM :

        • Une valeur <identity-group-name> est le groupe d'identités des utilisateurs ou un groupe dynamique d'identités.
        • Si le domaine d'identité par défaut est <identity-group-name>, utilisez le format suivant :

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

        • Si <identity-group-name> ne figure pas dans le domaine d'identité par défaut, utilisez ce format pour indiquer le nom de domaine d'identité du groupe d'utilisateurs de domaine d'identité ou du groupe dynamique d'identité :

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

      • Accès Oracle REST Data Services (ORDS) : pour configurer l'accès à vos données dans ORDS, entrez le nom d'hôte du domaine d'identité autorisé à établir une connexion à l'hôte de données à l'aide d'ORDS :

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

      • Accès à Oracle Application Express (APEX) : si vous configurez l'accès à vos données dans APEX, entrez le mot de passe APEX initial pour l'espace de travail APEX de votre domaine IoT :

        <your-apex-initial-password>

        Remarque

        Le mot de passe APEX initial doit comporter au moins 12 caractères.
    5. Sélectionnez Mettre à jour.
    6. (Facultatif) Pour afficher la demande de travail pour une mise à jour, accédez au domaine, puis sélectionnez l'onglet Demande de travail.

      Sélectionnez le nom d'opération de la demande de travail pour afficher l'OCID.

      Sélectionnez Messages pour afficher les messages de journaux associés, les erreurs de journal et les ressources associées. Par exemple, les ressources associées aux groupes de domaines affichent les domaines associés.

      Pour plus d'informations, reportez-vous à Obtention des détails d'une demande de travail pour votre Internet of Things.

  • La configuration dépend du système auquel vous souhaitez vous connecter pour visualiser les données IoT. Les deux options suivantes nécessitent l'utilisation de la commande oci iot domain configure-direct-data-access au cours du processus de configuration :

    Utilisez la commande oci iot domain configure-direct-data-access et les paramètres requis pour configurer l'authentification d'un domaine IoT afin d'établir une connexion de base de données directe.

    Remplacez <tenancy-OCID:<identity-group-name> par les valeurs de votre environnement. <identity-group-name> peut faire référence à un groupe d'utilisateurs ou à un groupe dynamique d'identités.

    • Pour le paramètre <identity-group-name>, vous pouvez faire référence au groupe d'identités des utilisateurs ou au groupe dynamique d'identités : <tenancy-OCID>:<identity-group-name>
    • Si l'élément <identity-domain-name> ne figure pas dans le domaine d'identité par défaut, vous devez indiquer l'élément <identity-domain-name>. Par exemple :

      <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>"]'

    Pour visualiser vos données dans ORDS, vous devez configurer l'accès pour visualiser vos données IoT dans ORDS. Ce processus de configuration utilise la commande suivante.

    Utilisez la commande oci iot domain configure-ORDS-data-access et les paramètres requis pour configurer l'accès d'un domaine IoT à 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>

    Pour afficher vos données dans APEX, la configuration de l'accès permet de visualiser vos données IoT dans APEX à l'aide de la commande suivante.

    Utilisez la commande oci iot domain configure-apex-data-access et les paramètres requis pour configurer l'accès d'un domaine IoT à 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>"
    Remarque

    Le mot de passe APEX initial doit comporter au moins 12 caractères.

    Pour obtenir la liste complète des paramètres et des valeurs des commandes de la CLI, reportez-vous à Référence des commandes de la CLI.

  • Exécutez l'opération ConfigureIotDomainDataAccess pour authentifier un domaine IoT afin d'établir une connexion de base de données directe :

    Si vous souhaitez interroger les données IoT directement dans la base de données, vous devez configurer une connexion de base de données directe ou vous connecter à Oracle Analytics Cloud, vous devez configurer une connexion de base de données à Oracle Analytics Cloud. Dans le cadre du processus de configuration, vous pouvez utiliser l'API pour ajouter l'utilisateur ou le groupe de domaine d'identité à un domaine IoT configuré pour se connecter à la base de données IoT, par exemple :
    POST /20250531/iotDomains/{iotDomainId}/actions/configureDataAccess
{
    "type": "DIRECT", 
    "dbAllowlistedIdentityGroupNames": ["<identity-group-name>",...]
}
    Pour visualiser vos données dans ORDS, vous devez configurer l'accès pour visualiser vos données IoT dans ORDS. Dans le cadre du processus de configuration, vous pouvez utiliser l'API pour ajouter l'hôte de domaine d'identité à un domaine IoT afin de vous connecter à Oracle REST Data Services (ORDS), par exemple :
    POST /20250531/iotDomains/{iotDomainId}/actions/configureDataAccess
{
    "type": "ORDS",
    "dbAllowedIdentityDomainHost": "<idcs-<unique-id>.identity.oraclecloud.com>"
}
    Pour afficher vos données dans APEX, la configuration de l'accès permet de visualiser vos données IoT dans APEX. Dans le cadre de ce processus de configuration, vous pouvez utiliser l'API pour configurer APEX pour le domaine IoT, par exemple :
    POST /20250531/iotDomains/{iotDomainId}/actions/configureDataAccess
{
  "type": "APEX",
  "dbWorkspaceAdminInitialPassword": "<your-apex-initial-password>"
}
    Remarque

    Le mot de passe APEX initial doit comporter au moins 12 caractères.