Track user requests

Akamai Identity Cloud provides tools you can leverage to track and respond to end user requests in a timely fashion.

Webhooks

Webhooks are a simple yet powerful notification system which is triggered by events in your Identity Cloud database. User request triggers webhook | Icons by Font Awesome, see fontawesome.com/license For example, you can configure a webhook to send a notification to your listener endpoint whenever a user record is updated. The notification will contain information such as the data attribute(s) that changed, the UUID of the user record, and the Entity Type where the record resides.

So when a user clicks the Delete My Account button, this would trigger a notification including something like the following:

"attributes": [
	"accountDeleteRequestTime"
],
"entityType": "user",
"sub": "6b004bc5-179c-45c2-815d-31b06169371d",

For more information on Identity Cloud webhooks, see Webhooks v3.

Entity API

For security purposes, the webhook notification will not include any actual user data. If needed, you can leverage the Identity Cloud Entity API to retrieve user data related to the request. Webhook triggers API call | Icons by Font Awesome, see fontawesome.com/license For example, you can use the information received in the example above to make a follow-up call to Identity Cloud to get the user’s email address and the account delete request date:

curl -X POST \
	https://my-registration-domain.janraincapture.com/entity \
	-H 'Authorization: Basic AUTHORIZATION CODE' \
	-H 'Content-Type: application/x-www-form-urlencoded' \
	--data-urlencode type_name=user \
	--data-urlencode uuid=6b004bc5-179c-45c2-815d-31b06169371d \
	--data-urlencode attributes='["email", "accountDeleteRequestTime"]'
Response:
{
	"result": {
		"email": "janesmith@example.com",
		"accountDeleteRequestTime": "2020-04-15 19:59:34 +0000"
	},
	"stat": "ok"
}

For more information on the Entity API, see /entity.

Take action

At this point, you can consume the information you’ve received from the Identity Cloud webhook and API and take action on it. Process data and take action | Icons by Font Awesome, see fontawesome.com/license For example, here are some common actions to take:

  • Record the information about this account delete request to a log file. See: Consume and store
  • Send an email to the end user confirming that you received their request and the account deletion is in process
  • Use the Entity API to delete the user’s record from the Identity Cloud database. See: /entity.delete
  • Use the email address (or other identifier) to also delete traces of this user account from your email marketing platform or other internal systems