Cuerpo de respuesta

También proporciona un medio por el cual la información de contexto se puede comunicar entre los componentes cooperantes del dominio de identidad que participan en la satisfacción de solicitudes. El ID de contexto de ejecución (ECID) y el ID de relación (RID) son útiles para realizar el seguimiento de la secuencia de eventos entre servicios.

• ECID: identificador único. El ECID es único para cada nueva tarea raíz. Este número sigue siendo el mismo que el que se comparte en el árbol de tareas asociadas con la tarea raíz.

• El RID: identificador de relación. El RID es un juego ordenado de números que describe la ubicación de cada tarea en el árbol de tareas. El número inicial suele ser cero y, a continuación, los números aumentan para cada subtarea adicional.

Las cabeceras HTTP X-ORACLE-DMS-ECID y X-ORACLE-DMS-RID se devuelven como parte de la respuesta de REST desde el dominio de identidad. Estas cabeceras HTTP corresponden al ECID y al RID de la solicitud. Los valores de estas cabeceras los define el dominio de identidad al devolver la respuesta. El emisor de llamada puede utilizar el ECID y el RID para realizar un seguimiento y correlacionar las solicitudes que se originan con eventos que surgen del dominio de identidad.

Por ejemplo, el cliente puede incluir estos valores como parte de un mensaje de error, porque es importante correlacionar los eventos del cliente con los errores del servidor. El formato estándar de Oracle para el registro implica un campo dedicado al ECID. Una vez que se conoce el ECID, cuando se lee desde un mensaje de registro de nivel de error, por ejemplo, es posible encontrar todos los demás mensajes de registro asociados con esa tarea consultando los archivos de registro para los mensajes que contienen ese ECID.

Utilice los informes de datos de diagnóstico de los dominios de identidad para ver los datos de registro capturados con fines de diagnóstico. Puede encontrar el ECID y el RID en el informe y, a continuación, correlacionar esos identificadores con el ECID y el RID que devuelven las llamadas REST de los dominios de identidad que realizan las aplicaciones. Consulte Ejecución del informe de datos de diagnóstico.

Ejemplos de Control Dinámico

Solicitud POST a /Usuarios

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

Cabeceras de Comando cURL en la Respuesta

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

Respuesta a la solicitud GET a /AuditEvents

Nota: En este ejemplo, se muestra que el ECID es el mismo que el utilizado por el servidor para crear el usuario.

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

Respuesta

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

Muestra de informe de diagnóstico