Scénario : connexion de données IoT à Oracle REST Data Services (ORDS)

• Utilisez l'API de données Internet of Things pour visualiser vos données IoT. Pour plus d'informations, reportez-vous à la documentation relative à l'API de données IoT.
• Utilisez ORDS pour créer et publier des API REST personnalisées avec vos propres données Internet of Things. Créez une logique dans votre base de données et exposez les opérations et les objets de base de données à l'aide de CRUD en tant qu'adresses REST pour créer des microservices RESTful personnalisés connectés à des requêtes PL/SQL ou SQL.

1. Dans votre location IoT, connectez-vous en tant qu'administrateur à la console Oracle Cloud Infrastructure.
2. Ouvrez le menu de navigation et sélectionnez Identité et sécurité. Sous Identité, sélectionnez Domaines.
3. Sélectionnez le nom du domaine d'identité avec lequel vous voulez travailler. Vous devrez peut-être modifier le compartiment pour trouver le domaine d'identité à utiliser. Vous pouvez également avoir besoin de créer un domaine d'identité supplémentaire. Lorsque vous créez l'application confidentielle, vous devez utiliser un domaine d'identité qui n'est pas le domaine par défaut. Vous pouvez créer des domaines d'identité supplémentaires pour gérer différents groupes d'utilisateurs, exigences de sécurité et environnements au sein d'une même location. Pour plus d'informations, reportez-vous à Utilisation de plusieurs domaines d'identité et à Gestion des domaines d'identité.

   Le compartiment doit se trouver dans la même région que la base de données IoT.

   Si vous utilisez un domaine existant ou créez un domaine, utilisez les paramètres suivants :

   • type de domaine : gratuit
   • Sous Administrateur de domaine, désactivez l'option Utiliser cette adresse électronique comme nom utilisateur.
   • Sur la page Détails du domaine, accédez à l'onglet Paramètres, sous Paramètres de domaine - Paramètres régionaux, sélectionnez Modifier les paramètres de domaine.
   • Pour configurer l'accès du client au certificat de signature pour le domaine d'identité sans que le client se connecte au domaine d'identité, procédez comme suit :

     Sous Accès au certificat de signature, activez l'option Configurer l'accès client et sélectionnez Enregistrer les modifications.

     Désormais, sous Paramètres de domaine - Certificat de signature d'accès, Configurer l'accès client est activé.

4. Sur la page de détails du domaine, sélectionnez l'onglet Applications intégrées.
5. Sélectionnez Ajouter une application, Application confidentielle, puis Lancer le workflow.
6. Sur la page de détails Ajouter une application, entrez un nom d'application et une description. Sélectionnez Soumettre.

   Pour obtenir la liste complète des options, reportez-vous à Ajout d'une application confidentielle.

7. La page Détails de l'application intégrée s'ouvre. Dans le menu Actions, sélectionnez Activer. Sélectionnez Activer l'application.
8. Sélectionnez l'onglet Configuration OAuth, puis Modifier la configuration OAuth.
9. Sous Configuration du serveur de ressources, sélectionnez Configurer cette application comme serveur de ressources maintenant.
10. Entrez /<domain-group-short-id> dans le champ Public principal. Sélectionnez Soumettre.

    L'hôte de données provient du groupe de domaines IoT et contient l'ID abrégé du groupe de domaines.

    Afin de trouver l'hôte de données pour le groupe de domaines IoT, utilisez la commande oci iot domain-group get et remplacez <iot-domain-group-OCID> par l'OCID du groupe de domaines IoT afin d'obtenir les détails du groupe de domaines IoT, y compris l'hôte de données du groupe de domaines, avec l'ID abrégé du groupe de domaines :

    oci iot domain-group get --iot-domain-group-id <iot-domain-group-OCID>

    Dans la réponse, vous pouvez trouver l'ID abrégé du groupe de domaines que vous devez entrer en tant que public principal.

    data-host:<domain-group-short-id>.data.iot.<region>.oci.oraclecloud.com

    Pour plus d'informations, reportez-vous à la section Get an IoT Domain Group's Details.

    Remarque
    
    /<domain-group-short-id> doit être en minuscule.
11. Pour activer la portée, sélectionnez Ajouter des portées.
12. Sur la page Ajouter une portée, entrez la portée au format suivant :/iot/<domain-short-id>. Choisissez Ajouter.

    L'hôte de périphérique provient du domaine IoT et contient l'ID abrégé de domaine.

    Afin de rechercher l'hôte de périphérique pour le domaine IoT, utilisez cette commande et remplacez <iot-domain-OCID> par l'OCID de votre domaine IoT afin d'obtenir les détails du domaine IoT, y compris l'hôte de périphérique du domaine par l'ID abrégé de domaine :

    oci iot domain get --iot-domain-id <iot-domain-OCID>

    Dans la réponse, vous pouvez trouver l'ID abrégé de domaine que vous devez entrer en tant que portée.

    device-host:<domain-short-id>.device.iot.<region>.oci.oraclecloud.com

    Pour plus d'informations, reportez-vous à Obtention des détails d'un domaine IoT.

13. Sous Configuration du client, sélectionnez Configurer l'application comme client maintenant.
14. Sous Autorisation, cochez les cases suivantes :
    • Propriétaire de ressource
    • Informations d'identification client
    • Assertion JWT
    • Jeton d'actualisation
15. Sous Opérations autorisées, sélectionnez Introspect pour autoriser l'accès à une adresse d'introspection de jeton pour votre application.
16. Sous Police d'assurance de jetons, sélectionnez Tout, puis Soumettre.
17. Sur la page Configuration OAuth, sous Configurer les API d'application devant être protégées par OAuth, l'audience principale est affichée avec /domaingroupshortid et sous Portées, /iot/domainshortid s'affiche.
18. Sous Informations générales, l'ID client s'affiche.
19. Sous Clé secrète client, l'option Afficher la clé secrète est affichée avec la valeur masquée.
20. En haut de la page, sélectionnez l'onglet Utilisateurs, puis Affecter des utilisateurs.
21. Cochez la case en regard du nom utilisateur à affecter à cette application intégrée. Sélectionnez Affecter.
22. Sélectionnez Applications intégrées pour revenir à la page de détails du domaine.
23. Sur la page de détails du domaine, sélectionnez l'onglet Gestion des utilisateurs.
24. Sélectionnez Créer un groupe.
25. Sur la page Créer un groupe, entrez un nom et une description facultative. Evitez de saisir des informations confidentielles.
26. Cochez la case en regard de l'utilisateur que vous voulez ajouter au groupe. Choisissez Créer.
27. Sélectionnez Groupes pour revenir à la page Détails du domaine, puis sélectionnez l'onglet Applications intégrées.
28. Sélectionnez l'application intégrée créée à l'étape précédente.
29. Sélectionnez l'onglet Groupes. Sélectionnez Affecter des groupes.
30. Cochez la case en regard des groupes auxquels vous souhaitez affecter l'accès à cette application intégrée. Sélectionnez Affecter.
31. Sur la page Détails du domaine, copiez l'URL du domaine.

32. 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).

    Remplacez <idcs-<unique-id>.identity.oraclecloud.com> par l'URL de domaine de la page de détails du domaine, sans https :// ni le numéro de port :

    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 plus d'informations, voir Configuration de l'accès aux données d'un domaine IoT.

33. Facultatif. Pour vérifier la progression de l'opération, utilisez la commande de demande de travail :

    Utilisez la commande oci iot work-request get et le paramètre requis pour obtenir les détails de la demande de travail :

    oci iot work-request get --work-request-id <work-request-id>

    Pour plus d'informations, voir Obtention des détails d'une demande de travail.

34. Facultatif. Pour vérifier les détails d'un domaine IoT, utilisez la commande oci iot domain get et le paramètre requis afin d'obtenir les détails d'un domaine IoT :

    oci iot domain get --iot-domain-id <iot-domain-OCID>

    Dans cet exemple de réponse, vous pouvez vérifier que les détails d'accès aux données du domaine IoT utilisent le format URL de domaine d'identité :

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

    Pour plus d'informations, reportez-vous à Obtention des détails d'un domaine IoT.

    {
      "compartment-id": "<compartment-OCID>",
      "data-retention-periods-in-days": {
        "historized-data": 30,
        "raw-command-data": 16,
        "raw-data": 16,
        "rejected-data": 16
      },
      "db-allow-listed-identity-group-names": ["<tenancy-OCID>:<identity-domain-name>/<identity-group-name>"],
      "db-allowed-identity-domain-host": "<idcs-<unique-id>.identity.oraclecloud.com>",
      "defined-tags": {
        "Oracle-Tags": {
          "CreatedBy": "default/user",
          "CreatedOn": "2025-08-05T18:02:51.633Z"
        }
      },
      "description": <your-description>,
      "device-host": "<domain-short-id>.device.iot.<region>.oci.oraclecloud.com",
      "display-name": "iot-domain-sample",
      "freeform-tags": {},
      "id": "<iot-domain-OCID>",
      "iot-domain-group-id": "<iot-domain-group-OCID>",
      "lifecycle-state": "ACTIVE",
      "system-tags": {},
      "time-created": "2025-08-05T18:02:53.418000+00:00",
      "time-updated": "2025-08-05T18:04:42.585000+00:00"
    },
    "etag": "<unique-id>"

curl --request POST 
    --url 'https://idcs-<identity-hostname>.identity.oraclecloud.com:443/oauth2/v1/token' \
    --header 'Content-Type: application/x-www-form-urlencoded' \
    --header 'Authorization: Basic <secret-from-integrated-application>' \
    --data 'scope=/<domain-group-short-id>/iot/<domain-short-id>' \
    --data 'grant_type=password' \
    --data 'password=<your-password>' \
    --data username=user@oracle.com

1. Dans votre location IoT, connectez-vous en tant qu'administrateur à la console Oracle Cloud Infrastructure.
2. Ouvrez le menu de navigation et sélectionnez Identité et sécurité. Sous Identité, sélectionnez Domaines.
3. Recherchez le domaine avec lequel vous voulez travailler, sélectionnez le nom du domaine.
4. Sur la page Détails du domaine, sélectionnez l'onglet Gestion des utilisateurs. Recherchez l'utilisateur pour lequel réinitialiser le mot de passe, à la fin de la ligne, sélectionnez le menu Actions et sélectionnez Réinitialiser le mot de passe.