Antwortbody

Es bietet auch ein Mittel, mit dem Kontextinformationen zwischen kooperierenden Identitätsdomainkomponenten, die an der Erfüllung von Anforderungen beteiligt sind, kommuniziert werden können. Die Ausführungskontext-ID (ECID) und die Beziehungs-ID (RID) sind nützlich, um die Abfolge von Ereignissen zwischen Services zu verfolgen.

• Die ECID: Eine eindeutige ID. Die ECID ist für jede neue Hauptaufgabe eindeutig. Diese Zahl bleibt gleich wie in der Baumstruktur der Aufgaben, die mit der Hauptaufgabe verknüpft sind.

• Die RID: Eine Beziehungs-ID. Die RID ist eine geordnete Gruppe von Zahlen, die den Speicherort jeder Aufgabe in der Aufgabenhierarchie beschreibt. Die führende Zahl ist in der Regel eine Null, und dann erhöhen sich die Zahlen für jede zusätzliche Unteraufgabe.

Die HTTP-Header X-ORACLE-DMS-ECID und X-ORACLE-DMS-RID werden als Teil der REST-Antwort von der Identitätsdomain zurückgegeben. Diese HTTP-Header entsprechen der ECID und der RID der Anforderung. Die Werte für diese Header werden von der Identitätsdomain festgelegt, wenn die Antwort zurückgegeben wird. Der Aufrufer kann die ECID und die RID verwenden, um Anforderungen zu verfolgen und zu korrelieren, die von Ereignissen aus der Identitätsdomain stammen.

Beispiel: Der Client kann diese Werte als Teil einer Fehlermeldung einschließen, da es wichtig ist, Ereignisse auf der Clientseite mit Fehlern auf der Serverseite zu korrelieren. Das Oracle-Standardformat für das Logging umfasst ein Feld, das für die ECID dediziert ist. Wenn die ECID bekannt ist und beispielsweise aus einer Logmeldung auf Fehlerebene gelesen wird, können Sie alle anderen mit dieser Aufgabe verknüpften Logmeldungen suchen, indem Sie die Logdateien auf Meldungen abfragen, die diese ECID enthalten.

Mit den Diagnosedatenberichten für Identitätsdomains können Sie Loggingdaten anzeigen, die zu Diagnosezwecken erfasst wurden. Sie finden die ECID und die RID im Bericht und korrelieren diese IDs dann mit der ECID und der RID, die von den REST-Aufrufen der Identitätsdomains zurückgegeben werden, die Ihre Anwendungen ausführen. Siehe Diagnosedatenbericht ausführen.

Beispiele für dynamisches Monitoring

POST-Anforderung an/Benutzer

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

cURL-Befehlsheader in der Antwort

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

Antwort auf die GET-Anforderung an /AuditEvents

Hinweis: In diesem Beispiel wird gezeigt, dass die ECID mit der vom Server zum Erstellen des Benutzers verwendeten ECID identisch ist.

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

Response

{
  "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
}

Beispiel für Diagnosebericht