Corps de la réponse

Il fournit également un moyen de communiquer des informations contextuelles entre les composants de domaine d'identité coopérants impliqués dans l'exécution des demandes. L'ID contexte d'exécution (ECID) et l'ID relation (RID) sont utiles pour suivre la séquence des événements entre les services.

• L'ECID : Identificateur unique. L'ECID est unique pour chaque nouvelle tâche racine. Ce nombre reste le même qu'il est partagé dans l'arborescence des tâches associées à la tâche racine.

• RID : Identificateur de relation. Le RID est un ensemble ordonné de numéros qui décrit l'emplacement de chaque tâche dans l'arborescence des tâches. Le nombre de tête est généralement un zéro, puis les nombres augmentent pour chaque sous-tâche supplémentaire.

Les en-têtes HTTP X-ORACLE-DMS-ECID et X-ORACLE-DMS-RID sont retournés dans le cadre de la réponse REST du domaine d'identité. Ces en-têtes HTTP correspondent à l'ECID et au RID de la demande. Les valeurs de ces en-têtes sont définies par le domaine d'identité lors du retour de la réponse. L'appelant peut utiliser l'ECID et le RID pour suivre et corréler les demandes provenant d'événements provenant du domaine d'identité.

Par exemple, le client peut inclure ces valeurs dans un message d'erreur, car il est important de corréler les événements côté client avec les erreurs côté serveur. Le format standard Oracle pour la journalisation implique un champ dédié à l'ECID. Une fois l'ECID connu, lorsqu'il est lu à partir d'un message de journal de niveau erreur, par exemple, il est possible de trouver tous les autres messages de journal associés à cette tâche en interrogeant les fichiers journaux pour les messages qui contiennent cet ECID.

Utilisez les rapports sur les données de diagnostic des domaines d'identité pour voir les données de journalisation saisies à des fins de diagnostic. Vous pouvez trouver l'ECID et le RID dans le rapport, puis corréler ces identificateurs à l'ECID et au RID retournés par les appels REST des domaines d'identité que vos applications effectuent. Voir Exécution du rapport Données de diagnostic.

Exemples de surveillance dynamique

Demande POST à /Utilisateurs

curl -X POST -D dumpedHeadersPostUsers.txt
http://<domainURL>/admin/v1/Users
-H 'Authorization: Bearer eyJ4NXQjUzI....poYw'
-H 'Cache-Control: no-cache'
-H 'Content-Type: application/json'
-d '{
   "schemas": [ 
    "urn:ietf:params:scim:schemas:core:2.0:User"
   ],
   "name": {
 	"givenName": "Clarence",
 	"familyName": "Saladna"
   },
   "userName": "csaladna@example.com",
   "emails": [
 	{
 	  "value": "csaladna@example.com",
 	  "type": "work",
 	  "primary": true
 	},
 	{
 	  "value": "csaladna1@example.com",
 	  "primary": false,
 	  "type": "recovery" 
	}
   ]
 }'

En-têtes de commande cURL dans la réponse

HTTP/1.1 201 Created
Date: Thu, 04 Jan 2018 12:57:37 GMT
Content-Type: application/json;charset=utf-8
Content-Length: 1227
Proxy-Connection: Keep-Alive
X-ORACLE-DMS-RID: 0
X-ORACLE-DMS-ECID: 0000M31FtLAFo2H6yvR_6G1QJ7Wl0000K

Réponse à la demande GET à /AuditEvents

Note : Cet exemple montre que l'ECID est le même que celui utilisé par le serveur pour créer l'utilisateur.

http://<domainURL>/admin/v1/AuditEvents?filter=actorName sw "adm" and ecId eq "0000M31FtLAFo2H6yvR_6G1QJ7Wl0000K^"

Réponse

{
  "schemas": [
    "urn:scim:api:messages:2.0:ListResponse"
  ],
  "totalResults": 1,
  "Resources": [
    {
      "idcsCreatedBy": {
        "type": "User",
        "display": "admin opc",
        "value": "<user-id>",
        "$ref": "https://<domainURL>/admin/v1/Users/<user-id>"
      },
      "actorName": "admin@oracle.com",
      "id": "2a02fb8bc9a548edb21fe1c80ff6ada0",
      "actorDisplayName": "admin opc",
      "meta": {
        "created": "2024-01-04T12:57:46.314Z",
        "lastModified": "2024-01-04T12:57:46.314Z",
        "resourceType": "AuditEvent",
        "location": "https://<domainURL>/admin/v1/AuditEvents/2a02fb8bc9a548edb21fe1c80ff6ada0"
      },
      "actorId": "<user-id>",
      "adminResourceId": "a06ff8169b3640a29792a15ece75c906",
      "adminResourceName": "csaladna@example.com",
      "timestamp": "2024-01-04T12:57:46.312Z",
      "idcsLastModifiedBy": {
        "value": "<user-id>",
        "display": "admin opc",
        "type": "User",
        "$ref": "https://<domainURL>/admin/v1/Users/<user-id>"
      },
      "quotaCount": 0,
      "ecId": "0000M31FtLAFo2H6yvR_6G1QJ7Wl0000K^",
      "rId": "0",
      "eventId": "admin.user.create.success",
      "ssoAuthnLevel": 0,
      "adminResourceType": "User",
      "actorType": "User",
      "serviceName": "Admin",
      "adminValuesAdded": "{\"schemas\":[\"urn:ietf:params:scim:schemas:core:2.0:User\"],\"name\":{\"familyName\":\"Saladna\",\"givenName\":\"Clarence\",\"formatted\":\"Clarence Saladna\"},\"userName\":\"csaladna@example.com\",\"emails\":[{\"value\":\"csaladna@example.com\",\"primary\":\"true\",\"type\":\"work\",\"verified\":\"false\"},{\"value\":\"csaladna@example.com\",\"primary\":\"false\",\"type\":\"recovery\",\"verified\":\"false\"}],\"id\":\"a06ff8169b3640a29792a15ece75c906\",\"displayName\":\"Clarence Saladna\",\"urn:ietf:params:scim:schemas:oracle:idcs:extension:user:User\":{\"status\":\"verified\"},\"active\":\"true\",\"password\":\"*********\",\"urn:ietf:params:scim:schemas:oracle:idcs:extension:passwordState:User\":{\"mustChange\":\"true\",\"lastSuccessfulSetDate\":\"2024-01-04T12:57:37.940Z\",\"cantChange\":\"false\",\"expired\":\"false\",\"passwordHistory\":[{\"sequenceNumber\":\"1\",\"value\":\"*********\"}]},\"urn:ietf:params:scim:schemas:oracle:idcs:extension:userState:User\":{\"locked\":{\"on\":\"false\"},\"loginAttempts\":\"0\"},\"meta\":{\"created\":\"2024-01-04T12:57:37.951Z\",\"lastModified\":\"2024-01-04T12:57:37.951Z\"},\"idcsCreatedBy\":{\"value\":\"<user-id>\",\"type\":\"User\",\"display\":\"admin opc\"},\"idcsLastModifiedBy\":{\"value\":\"<user-id>\",\"type\":\"User\",\"display\":\"admin opc\"}}",
      "schemas": [
        "urn:ietf:params:scim:schemas:oracle:idcs:AuditEvent"
      ]
    }
  ],
  "startIndex": 1,
  "itemsPerPage": 50
}

Exemple de rapport de diagnostic