You can subscribe to a source system to receive notification e-mails. They provide information about the job execution and links to download job logs, in case of failed or skipped entities.
Before subscribing yourself to a source system, make sure that the trust between your Identity Authentication and SAP BTP is properly set, otherwise the Identity Provisioning might not propagate your email address. To do that:
- Open SAP BTP cockpit and navigate to your Neo subaccount.
- Navigate to Security > Trust > Application Identity Provider.
- Check your current identity provider.
- If it's the default one – SAP ID Service (
https://accounts.sap.com), you don't need to do anything. - If it's a custom one, choose the link to open it for edit. Go to tab Attributes, and then follow steps 11–12 on page: Setting Up Trust Between Identity Authentication and SAP BTP
- If it's the default one – SAP ID Service (
When you subscribe to a source system, you can receive notification e-mails in the following cases:
-
You start or schedule a provisioning job and it fails.
You'll receive an e-mail with subject Provisioning Running with Error. Source System: <name>. You receive one e-mail per job, after the first failed entity. If more entities fail during this job, no additional e-mails will be sent. This behavior is related to property
ips.job.notification.skip.intermediate.notifications. -
The failed job has finished.
You'll receive an e-mail with subject Provisioning Finished with Error. Source System: <name>. By default, if the same job runs again and keeps failing, no further notifications will be sent to your e-mail. However, you can control the notifications via properties
ips.job.notification.ignored.consecutive.failuresandips.job.notification.repeat.on.failure. For more information, see: List of Properties -
The job is back to normal (the problem with the failed entities has been resolved).
After a new run, the job has successfully finished. You'll receive only one e-mail with subject Provisioning Success. Source System: <name>.
The notification e-mail tells you which are the source and the target systems, what is the job type, its start time and status. It contains the Navigate to details link that opens the Job Execution Details screen in the Identity Provisioning UI.
In case your job finished with failed or skipped entities, links to Download error logs and Download skipped entities logs are provided, respectively. The content of the downloaded log files depends on your configuration of the ips.trace.skipped.entity, ips.trace.skipped.entity.content and ips.trace.failed.entity.content properties. For more information, see: List of Properties
Sending navigation links to the download page of failed and skipped entities is supported for tenants running on SAP Cloud Identity Services infrastructure.
If you subscribe to a source system, and then run a successful provisioning job, no notification e-mails will be sent.
-
Access the Identity Provisioning UI and choose the Source Systems tile.
-
Sign in to the administration console of SAP Cloud Identity Services and navigate to Identity Provisioning > Source Systems.
-
Select the system you need to watch and choose Jobs.
Notifications are supported only for read and resync jobs.
-
Choose Subscribe.
-
To subscribe yourself, choose Subscribe me.
-
To subscribe another user or a group (distribution list), choose Subscribe others. Fill in the required fields and choose
Add.From the Recipients list, you can remove existing subscribers. To do that, go to the Action column and choose the
icon.
-
-
You can now run or schedule a provisioning job.
-
If you no longer need to be subscribed to a source system, choose Subscribe > Unsubscribe me.
Related Information