This chapter described how you can configure and manage partner applications by using Oracle Communications Services Gatekeeper API management platform and its partner relationship management (PRM) portal applications.
Partners create their applications by using Partner Portal. Partners can subscribe APIs to their applications when they create them or later. Partner managers supply the APIs for partner applications.
The following topics explain how to manage partner applications:
An application goes through the following stages:
A partner creates an application and submits it in Partner Portal. The application state is set to CREATE PENDING APPROVAL.
As the partner manager, you review the application in Partner and API Management Portal and do one of the following:
Approve the application.
The application state is set to ACTIVE. The partner sees the approval on the Messages page of his Partner Portal.
Reject the application.
The application is returned to the partner. The partner sees the rejection on the Messages page of his Partner Portal.
When the application is active, the application is updated in one or both of the following ways:
The partner edits the application and submits it in Partner Portal. The application state is set to UPDATE PENDING APPROVAL.
As a partner manager you update the API.
As a partner manager, you approve or reject the updates made by the partner to the application. If the automatic approval of applications is enabled, Services Gatekeeper approves or rejects the updated application.
When a partner decides to delete an application, the partner submits a request in Partner Portal.
As the partner manager, you review the application in Partner and API Management Portal and do one of the following:
Approve the deletion. The application is deleted from Partner Portal.
Reject the deletion. The application continues to display in an active state in Partner Portal.
Services Gatekeeper uses notifications to alert the users of the PRM portals of events associated with application-related requests and responses.
When a partner registers or updates an application in Partner Portal, the partner manager receives a corresponding notification in Partner and API Management Portal. The partner waits to receive the results of the review before attempting further updates on the application. When the partner manager reviews a notification and approves or rejects the request, the partner receives a notification in Partner Portal. The partner is now able to take further action on the application. When a partner deletes an application, the application is removed from Partner Portal, unless the partner manager rejected the deletion.
All notifications for a partner manager are displayed on the WORKFLOW page of the Partner and API Management Portal. All notifications for a partner are displayed on the MESSAGES page of the Partner Portal.
When a network service supplier applies for a network service supplier account, the partner manager receives the registration request in Partner and API Management Portal. When the network service supplier signs in to Network Service Supplier Portal and registers, updates or deletes a network service interface, partner manager receives a corresponding notification in Partner and API Management Portal. However, the partner manager reviews the notification and is not required to approve or delete the notification.
Services Gatekeeper maintains data integrity by disallowing partner actions if the partner manager is currently changing the application.
At times, a partner may log in to Partner Portal and access the application submitted for approval at the same time as when the partner manager is reviewing the application request in Partner and API Management Portal.
In order to maintain data integrity of applications, Services Gatekeeper takes the following precautions. For:
Newly-created applications
When a partner creates an application and submits it, Services Gatekeeper displays the approval request for the application from Partner Portal with a CREATE PENDING APPROVAL notification in Partner and API Management Portal.
The partner cannot update that newly-created application the period when it is under review by the partner manager. Services Gatekeeper locks the application data.
The partner cannot submit another request for approval by the partner manager.
The partner can delete the newly-created application during the period when the partner manager is reviewing it.
When the partner manager completes his review of that newly-created application, Services Gatekeeper deletes the partner manager's approval or rejection of that application.
The deleted application is no longer available in Partner Portal or Partner and API Management Portal.
Updating active applications
If the partner manager is reviewing an active application at the current time:
The partner cannot update the application during the period when it is under review by the partner manager. Services Gatekeeper locks the application data.
The partner cannot submit another request for approval by the partner manager.
The partner can delete the application during the period when the partner manager is reviewing it.
When the partner manager completes his review of that updates, Services Gatekeeper deletes the partner manager's approval or rejection of the updates to that application.
The deleted application is no longer available in Partner Portal or Partner and API Management Portal.
Deleting active applications
When a partner accesses an active application and deletes it, Services Gatekeeper removes the application from Partner Portal. It displays the deletion request for the application from Partner Portal with a DELETE PENDING APPROVAL notification in Partner and API Management Portal.
Partners cannot delete an active application when the application is in Partner and API Management Portal with an DELETE PENDING APPROVAL notification.
See ”Managing EDRs, CDRs, and Alarms” in Services Gatekeeper System Administrator's Guide for more information collecting information about applications, and action chain processing in particular using EDRs.