Dashboard for Salesforce Commerce Cloud On-Demand Sandboxes
Overview of on-demand Sandboxes.
Sandbox or Test Environments are typically isolated from the Production Environment. Usually, client applications are tested against a non-production instance with test data so that testing doesn’t impact the integrity of information in the production & ensure correct data exchange. Salesforce provides an on-demand sandbox model via web service as compared to the legacy process of requesting sandboxes and then getting them enabled, which took many days.
An on-demand sandbox is a public-cloud-based sandbox. When you use on-demand sandboxes, you can expand your sandbox usage when required and roll back usage during slow periods. To access an on-demand sandbox, you must purchase sandbox credits, enable appropriate permissions and users, and configure a client API ID. Then you can use the self-service API to create the sandbox environments yourself. Using the API, you can also control how many on-demand sandboxes you use and how long the on-demand sandboxes are active.
Permissions for creating and managing on-demand sandboxes are integrated with the B2C Commerce Account Manager. When you create an on-demand sandbox, you can specify Open Commerce API and WebDav permissions. You can also specify a time-to live (TTL) value to automatically delete a sandbox after a specified time interval.
With the new model, the merchants are able to perform various actions with the Sandboxes on the fly by making use of REST API. It turns the process Short and enables the merchants to have full control from Create to Delete. The new API model is a “Pay-as-you-use” model. Designated number of seconds are allocated/assigned to every merchant, to be used by the sandboxes either Idle or Running.
Challenges with Existing API based Swagger Access And Control center
As part of practice, even after provision of efficient management of old and new sandboxes, the new model uses API based interface which favors adaptability towards Developers with sound technical orientation rather than the Merchants who would like to:
Monitor Sandbox Credits.
Identify Costly Sandboxes : Identify Sandboxes which are either Idle or Running for a long time without anyone using them – causing ultimate drain of assigned sandbox seconds, violating limitation. In that case, for a typical merchant, the API based interface for creating & managing Sandboxes is not friendly, being so technically complex and having programming language related commands to execute every time. More over the new control center dashboard does not give the complete visibility and ease of managing sandboxes to get optimal gain.
ODS Dashboard Features
Monitor Created, Idle & Running Sandboxes along with the total consumption of minutes.
Quickly START, STOP, RESTART, DELETE, RESET,CREATE the sandboxes in a matter of click(s) rather than going through filling of unfriendly inputs to execute a single operation.
Reports for individual sandboxes with details about points consumption, Diskspace usage, history and operations.
Adding or removing a sandbox from Scheduler
Updating Time to live for a Sandbox
Experience Better Visualization of current status of active Sandboxes.
View links to sandbox resources
Getting started.
you will need to register along with maximum 5 emails from your organization which will be using the sandbox.
you will receive a confirmation email along with link to dashboard. you can start by sending an email to ods-sfcc@royalcyber.com having subject: “ODS Registration“. you can specify 5 email address from your organization which will be using the dashboard. You will receive confirmation email within 24hrs. Once confirmation email is received you can skip the form below and continue with step1: or alternatively you can fill the form below to request for registration.
Note: you will not be able to access dashboard if you have not registered your emails first using the form below or by email.
Once you get the confirmation email you will need to perform following steps in order to start using.
Step1: Create API Key
In order to use the dashboard you will need to create an On-demand sandbox API key using the following Steps and values.
Configure an API Client ID
To allow users access to the Sandbox API, the administrator uses Account Manager to create an API client ID.
Login to account manager and navigate to API Client and Than create new client using button as in screen shot below.
After Filling in the display name and password make sure Access Control is enabled.
Select your organization as in image below.
You will need to add Sandbox API User role in Roles Section to the API and than select All sandboxes to avoid being kicked out.
Next fill in the Default scope, Redirect URI and other fields same as image below.
.
The following table shows same values as in image above to copy and paste.
Table 1. Recommended Settings for API Client ID |
|
Setting | Value |
---|---|
Default Scopes |
|
Redirect URLs | https://odsdashboard.royalcyber.org/openAuthRedictHandler |
Token Endpoint Auth Method |
|
Access Token Format |
|
Step2: Assign Role to User
You will also need to make sure to assign users with role “Sandbox API User” in order for them to access the control panel.
Note: All the users who want to use dashboard need to be have role sandbox API user assigned and access to all sandboxes given in order to use dashboard else it will log user out for now.
Once completed press save and copy the API key generated like in screen shot below.
Step3: Login
Once the API is generated you are now ready to start using the dashboard. Start by navigating the following link odsdashboard.royalcyber.org
Enter the API client key generate in steps above. Once Authenticated user will redirected to Dashboard.
Step4 : Using Features.
1. How to see credits by Realm and use Date range control
2. Monitor Sandboxes
3. Using the Command button
4. Using The status
5. Creating a new Sandbox
6. Edit Existing Sandbox
7. View detailed report on a sandbox.
view Detailed sandbox report including Credits, Usage history, Memory Used and Useful links.
8- Scheduling the Realm and Viewing Existing Configurations.
9- Inbound and Out Bound IP Address for Creating Alias or White listing.
10 - Update Realm Configurations Including Scheduler.
11- Support for multiple Realms handling.
Clients can now configure multiple realms from single place.
12- Added support for Inline Realm Configurations and Schedule if None is defined or configured
13- Added Support for Adding Purchased Credits and Date of Purchase to Calculate Remaining Credits.
|
|
Results for single Realm after configuration. Now Credits Remaining can be seen. you can always update the purchased credits and date of purchase later using the configure credits button.
|
This feature helps to auto calculate remaining credits instead of only showing Used Credits. this helps merchants to keep track of remaining credits. Future road map considers upgrading this feature with email alerts for lower remaining credits.
14- Complete Realm Credit Report In Case of Multiple Realms.
If a merchant/vendor is operating multiple Realms, It can now view Aggregated Realm Credit report with option to in place edit/configure purchased credits to view remaining credits per Realm.
Note: please note that the credits per year is prorated based on the month your order form was created and has an end date of Feb 2022. In order to get accurate report please make sure date purchase and total credits purchased are correct.
You can check the order form that you have signed for more information.
Two tables will be visible in this case. One with Realms for whom purchased credits have been added and one without such entry.
15- Sandbox Scheduling
Enables user to schedule sandbox/sandboxes specific to timezones. It allows to schedule sandboxes for different start/stop time and timezones in a same realm. To enable this feature, user first has to follow below steps:
Client ID Authentication
Use the client ID configured in earlier step for authentication.
Job Schedule
Enables user to schedule job to bring up/down sandboxes based on timezones. Realm can have one job scheduled against each timezone. This allows to create separate jobs to cater sandboxes in different timezones.
Sandbox Schedule
Select Schedule option from Action dropdown.
Modal popup will appear to set schedule sandbox.
Schedule Multiple Sandboxes
Enables user to schedule multiple sandboxes simultaneously using different start/stop date, time and timezone against each of them.
Dashboard with sandboxes schedule details
16- New Menu options to view Road Map and Submit a Bug.
Trouble Shooting
I am redirected to login page. https://odsdashboard.royalcyber.org/?registered=false
Answer: This can happen if you have not registered your emails with Royalcyber. Use the form above to register your emails and get access.
I am redirected to login page suddenly after some time.
Answer: This can happen due to your token expiration or you might not have permission to perform that operation.
I am redirected to login page when i try to perform an operation.
Answer: This can be due to the reason that you are not authorized to perform that action on sandbox.
Feedback
In case you face any problem using the Dashboard feel free to contact via form below. our team will contact you and solve the problem within 24 hrs.
Updates (Q3) 2021
Feature Name | Is Premium | Status |
---|---|---|
Support for multiple Realms handling. | Yes | Complete |
Added support for Inline Realm Configurations and Schedule if None is defined or configured | Yes | Complete |
Added Support for Adding Purchased Credits and Date of Purchase to Calculate Remaining Credits. | Yes | Complete |
Complete Realm Credit Report In Case of Multiple Realms. | yes | Complete |
New Menu options to view Road Map and Submit a Bug. | yes | Complete |
Updates (Q4) 2021
Feature Name | Is Premium | Status |
---|---|---|
Ability to Download Reports As Excel PDF and print | Yes | Complete |
Ability to view Sandbox Level Credits Report for each Realm | Yes | Complete |
Ability to Add detailed information per sandbox Such as Who was the sandbox assigned to purpose of assignment and easily track back to current User. | Yes | Complete |
Ability to Send email to Sandbox Current users in order to communicate with Real End users and keep them updated regarding Credits over usage, Resets, or deletion of sandbox. | yes | Complete |
1- Ability to Download Reports As Excel PDF and print for All reports and Tables in dashboard.
2- Updated Realm Credit Report. Ability to view Sandbox Level Credits Report for each Realm
3- Option to Add information for each sandbox in and view it in sandbox Details page.
| ||
|
4- Send Email to Users Assigned to Sandbox (If User Information is configured in above step you can now email them directly from sandbox details page.)
Existing Premium Features List
Multi-Realm Handling
Multi Realm Aggregated Credits Report.
Ability to Export Reports as Excel , PDF etc.
Ability to Add information regarding End users and Track for Record purposes.
New Report. Track Credits Usage per sandbox bases as a Report.
Future Road Map
Features Q3-2021 – Expected Release Date - August
Feature Name | Is Premium | Status |
---|---|---|
Ability to View Combined Credit report for All Realms. | Yes | Complete |
Ability to Add Number of Credit a Realm Have to Report Remaining Credits. | Yes | Complete |
Q4-2021 To Q2-2022
Feature Name | Is Premium | Status |
---|---|---|
Ability to Download Reports As Excel PDF and print | Yes | Complete |
Ability to view Sandbox Level Credits Report for each Realm | Yes | Complete |
Ability to Add detailed information per sandbox Such as Who was the sandbox assigned to purpose of assignment and easily track back to current User. | Yes | Complete |
Ability to Send email to Sandbox Current users in order to communicate with Real End users and keep them updated regarding Credits over usage, Resets, or deletion of sandbox. | yes | Complete |
Time zone based Scheduler for individual Sandboxes in single Realm for different geographical regions | yes |
|
Alerts based on Sandbox usage exceeding threshold. | yes |
|
Alerts based on remaining mins less than threshold. | yes |
|
Alert based on Sandbox Started state for more than a week. | yes |
|
SFCC CI integration (for CICD). | yes |
|
Code Deployment to Sandboxes. | yes |
|
More control on User based access to sandboxes and Commands they execute. | yes |
|
User Tracking and Logging using each sandbox. | yes |
|
Company specific Dashboard for Configuring which alerts to mute of enable along with other configurations. | Yes |
|