User events

When changes are made to a user's status on the AppDirect marketplace, a user event notification is triggered and sent to the vendor. Such events include assigning a user to an application, removing a user from an application, or updating the user's information.

Developers must register two URL endpoints to handle notifications for access management-related events: a User Assignment Notification URL and a User Unassignment Notification URL.

The Developer can use a URL for each event type or use a single URL to handle all event types. When an event occurs, AppDirect notifies the vendor by calling this URL, which is hosted by the vendor, and sends an eventUrl parameter. The eventUrl parameter identifies the location of an event, which the vendor can use to fetch information about that event. Upon notification, the vendor can perform an HTTP GET to the eventUrl to read an XML or JSON representation of the event.

These access URL endpoints are configured under the Edit Integration Settings section when Developers create and edit their products in the Developer Center. AppDirect recommends HTTPS endpoints secured with SSL certificates. Such certificates have to be valid and verifiable by the AppDirect server for the integration to work. If an SSL certificate does not pass this validation, the Developer must ensure that the certificate passes basic certification checks for example the certificate should be from a globally trusted source, not have expired, and have the proper chain of trust.

See Configure product integration security for details on how to securely receive event notifications and retrieve event details.