Skip to content

Discovery Service Overview

Making sure that apps connect to the right system can be challenging. For instance, when selling apps to multiple customers, hard-coding destinations is not feasible or secure, and relying on users to remember system URLs may not be reliable. Discovery Service enables you to use what users know or can access, such as their email domain or an onboarding code, to connect to the right system landscape when first using the app (without requiring custom code lines per environment).

Using SAP BTP cockpit, you can add the application configurations or link the domain from the app itself. You can update or delete the configurations at any time. Some regions may not support Discovery Service.

For developers who use Discovery Service for app configurations, keep in mind:

  • When you create a domain-based configuration from any space in any region, and a client running the app requests the configuration from the global Discovery Service address, the app gets its configuration from your space.
  • When you create an onboarding-code-based configuration from any space in any region, and a client running the app requests the configuration from the global Discovery Service address, the app gets its configuration from your space.
  • For regions where the global Discovery Service is not available, you can overwrite the Discovery Service URL with a regional one by configuring STAND_ALONE_DISCOVERY_ADMIN on SAP Business Technology Platform. When configured, the server deploys the regional Discovery Hub instead of the global Discovery Hub. In installations where the regional solution is implemented, the regional URL appears on the SAP BTP cockpit Settings Discovery Service page for reference.

When customers terminate data service, all configuration items registered for the customer space are deleted.

Procedure for Onboarding Codes

  1. Generate onboarding codes in the SAP BTP cockpit.
  2. Assign onboarding codes to apps to make them discoverable.
  3. Enable apps built with the SAP SDK for Android or iOS to discover configurations.
  4. Have your users enter the configured onboarding code for apps to discover configurations.

Procedure for Custom Domains

  1. Register your custom domain in the Discovery Service settings in the SAP BTP cockpit.
  2. Assign registered domains to apps to make them discoverable.
  3. Enable apps built with the SAP SDK for Android or iOS to discover configurations.
  4. Have your users enter their email address for apps to discover configurations.
Feature Description
Claim domains for onboarding Use the SAP BTP cockpit to claim your domain for onboarding
Generate onboarding codes Generate onboarding codes for your users
Publish app configurations Enable individual applications for runtime discovery
Configure custom discovery Customize configuration returned to apps by Discovery Service

Last update: December 16, 2020