Managing Apps
The App Details page lists your app's information.
You can view/edit your app details and manage your app, as well as perform the following tasks:
- View app details
- Managing whitelisting
- Change app status
- Verify app URLs
- Viewing app logs
- View app installation metrics
- Change app publication status
- View services
- Edit Product API access and restrictions
- Testing your app's endpoints
Managing App Details
Viewing app details
The app details page lists the following information for your app:
- Provider: Name of the app's App Provider.
- Version: The version of the app.
- Support Contact: The email address users should use to contact you if there are issues with your app.
- Product Access: The CX products for which the app can be installed.
- Updated: The date the app was last updated.
- Install Link: The app's install URL. Provide this URL to users to install your app when your app is ready for publication. Until you change your app's publication status to CA or GA, the Install Link will display as " Install Link (testing only)". See App Installation for more information about the entire process.
-
Application Keys: The application keys used to sign requests for your JSON Web Tokens for the app to interact with AMS and the Oracle Marketing product.
-
ID (App UUID): A unique identifier to identify the app.
-
Token Key: App Token Key. Your public key, which you will include in the JWT token. This token is tied to your app.
-
Token Secret: App Token Secret. Your private key which you will use to generate a signature for your JWT token. On authorization, AMS will also use this secret to verify the sender of the JWT.
-
- Application URLs: The app's endpoint URLs specified during app creation.
- Application Logos: The app's logos specified during app creation.
Managing whitelisting
Click Publication Whitelist URLs > edit to manage the list of whitelisted tenants. A tenant must be whitelisted to install your app if your app is in Development or CA status.
Changing app status
Click App Status to change your app's status. The three statuses are: Up, Maintenance, and Down. See Check or Update your App's Install Status for more information about what each status entails for your app.
Verifying URLs
Click URL Verification to test your app's endpoints. AMS will send an OPTIONS request to each of your app's endpoints to ensure they can be reached successfully. Learn more.
Viewing app metrics
Click Metrics to view metrics about your app such as which accounts installed your app and when. For more information, see Viewing App Metrics.
Editing app details
Click Edit App to modify any of your app details such as your app URL endpoints or app logo.
Changing app status
Click App Status to change your app's status. The three statuses are: Up, Maintenance, and Down. See Check or Update your App's Install Status for more information about what each status entails for your app.
Changing publication status
An app's publication status determines whether or not the app can be installed. Clicking Publication Status will change your app's publication status:
- Generally Available: Apps can be installed by anyone.
- Controlled Availability: Apps can only be installed by tenants that are whitelisted.
- Development: The app cannot be installed by anyone, unless the tenant is added to the app provider whitelist for testing purposes.
See App Publication for more information on how this works.
Viewing service details
Click a service to view or edit the service's details. Click Create Service to create new services for your app.
Editing Product API Access and Restrictions
The Product API Access and Restrictions section lists the Product APIs and the corresponding CRUD API operations your app has access to. Each product has its own set of APIs and operations for which you can enable or disable for your app.
Edit your app to change the product APIs access if this wasn't done when you created the app.
Viewing app logs
Click Logs to view your app's logs.
Testing your app's endpoints
Click the Testing tab to test your app's endpoints. See Testing Your App's Endpoints for more information.
[Manage apps, managing apps, app details, app management, installation metrics, publication status, app publication, publication, install metrics, app status, maintenance, URL Verification, verification, url verification, vericating urls, down]
Verifying Application Endpoint URLs