Corpo da Resposta

Ele também fornece um meio pelo qual as informações de contexto podem ser comunicadas entre os componentes cooperantes do domínio de identidades envolvidos no atendimento de solicitações. O ECID (Execution Context ID) e o RID (Relationship ID) são úteis para rastrear a sequência de eventos entre serviços.

• O ECID: Um identificador exclusivo. O ECID é exclusivo para cada nova tarefa raiz. Esse número permanece o mesmo que é compartilhado na árvore de tarefas associadas à tarefa raiz.

• O RID: Um identificador de relacionamento. O RID é um conjunto ordenado de números que descreve a localização de cada tarefa na árvore de tarefas. O número inicial é normalmente zero e, em seguida, os números aumentam para cada subtarefa adicional.

Os cabeçalhos HTTP X-ORACLE-DMS-ECID e X-ORACLE-DMS-RID são retornados como parte da resposta REST do domínio de identidades. Esses cabeçalhos HTTP correspondem ao ECID e ao RID da solicitação. Os valores desses cabeçalhos são definidos pelo domínio de identidades ao retornar a resposta. O chamador pode usar o ECID e o RID para rastrear e correlacionar solicitações que se originam com eventos que surgem do domínio de identidades.

Por exemplo, o cliente pode incluir esses valores como parte de uma mensagem de erro, porque é importante correlacionar eventos no cliente com erros no servidor. O formato padrão do Oracle para registro envolve um campo dedicado ao ECID. Depois que o ECID é conhecido, quando é lido de uma mensagem de log no nível de erro, por exemplo, é possível encontrar todas as outras mensagens de log associadas a essa tarefa consultando os arquivos de log em busca de mensagens que contenham esse ECID.

Use os relatórios de Dados de Diagnóstico dos domínios de identidades para exibir os dados de log capturados para fins de diagnóstico. Você pode encontrar o ECID e o RID no relatório e, em seguida, correlacionar esses identificadores ao ECID e ao RID que são retornados pelas chamadas REST de domínios de identidade que seus aplicativos fazem. Consulte Executando o Relatório de Dados de Diagnóstico.

Exemplos de Monitoramento Dinâmico

Solicitação POST para /Usuários

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

Cabeçalhos de Comandos cURL na Resposta

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

Resposta à Solicitação GET para /AuditEvents

Observação: Este exemplo mostra que o ECID é o mesmo que o usado pelo servidor para criar o usuário.

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

Resposta

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

Amostra de relatório de diagnóstico