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 no rastreamento da 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 o local de cada tarefa na árvore de tarefas. Normalmente, o número à esquerda é 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 originadas 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 lado do cliente com erros no lado do servidor. O formato padrão da Oracle para registro em log envolve um campo dedicado ao ECID. Depois que o ECID é conhecido, quando é lido a partir 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 para obter 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 dos domínios de identidade que seus aplicativos fazem. Consulte Executando o Relatório de Dados de Diagnóstico.

Exemplos de Monitoramento Dinâmico

POST - Solicitação 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 Comando 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 é igual ao que foi 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 do Relatório de Diagnóstico