On Boarding SaaS Service using JC Connect

JSDN enables organizations to transform its business and IT operations models by deploying a Cloud Service Broker solution. It allows service providers, technology providers, system integrators, IT distributors, and enterprise/government IT organizations to unify delivery and management of private and public cloud application/services and distribute them to customers, partners, and employees through a customer-facing self- service/Appstore.

Jamcracker Connect (JC Connect) provides “self service” on-boarding of cloud services and enable cloud service providers to publish the services on to the JSDN cloud services platform by giving them access to a global wide cloud distribution network. It provides a sophisticated and easy-to-use web interface that enables them to quickly on-board a new cloud service to the platform. Using JC Connect, you can specify information such as how the services should be displayed on the store catalog and shopping cart. You can enter service display information, service name, service description, catalog logo, subscription plans and prices. In addition, you can configure the service provisioning events so that full administration of the service and its offers can be performed by a customer/user.

Using JC Connect

Jamcracker Services Delivery Network (JSDN) provides a comprehensive cloud service brokerage (CSB) enablement solution that facilitates aggregation, delivery and management of cloud services (SaaS, IaaS, PaaS). It enables Service Providers, Technology OEM's, SI's, Distributors, Government, and Enterprises to aggregate and deliver a vast array of cloud services to customers, partners, or employees directly or indirectly. Jamcracker Connect provides a self-service portal that enables cloud providers to publish their cloud services easily to the JSDN by giving them access to a global wide cloud distribution network.

This guide takes you through the steps involved in adding and publishing cloud services to the JSDN platform. Once you on-board a service, the platform allows you to test the service using a test store. It also allows you edit or remove the service from the platform.

Process Overview

Once cloud providers have been granted access to Jamcracker Connect, they login to the portal and start their on-boarding process using a web-based wizard. The information that they provide will define the catalog content and “adapter” requirements that enable the service to be presented, ordered, provisioned, and accessed from multiple JSDN-powered marketplaces.

To add a service, the provider need to complete the sections – Catalog Listing, Order Flow, and Service Provisioning by filling information.

Catalog Listing: Use the Catalog Listing section to configure how the provider’s services are displayed within a JSDN catalog. This includes the service description, different offers (packages) related to each service and their descriptions, pricing options, collaterals, and service logos.

Order Flow: Define the ordering parameters, i.e. the data fields required to provision an organization and users into their service along with the billing parameters. This step will create the ordering form that is presented to end-customers, as well as how they are billed.

Service Provisioning: Define the provisioning and SSO events. Typical SaaS provisioning events include new customer orders and user account creation, increasing/decreasing license quantities, updating/deleting users, and cancelling customer accounts.

The information from the Self-Service Portal can be used to build an automated provisioning “adapter” using Jamcracker’s XML-based Services Integration Framework as well as by leveraging 3rd party integration tools (e.g. IBM Cast Iron, Dell Boomi, Talend). You can also provide the information and provide the service manually for each customer as well.

After the Service Configuration steps and “adapter” (automated or manual provisioning) have been completed; the service configuration, ordering form are then published to a JSDN sandbox environment where the cloud provider is provided a JSDN storefront to view how their service will be displayed within a catalog, test the order flow, and validate that the provisioning life-cycle events are working properly.

Once the provider completes the self-testing process, the service then undergoes final certification review by Jamcracker and is then published to live JSDN marketplaces.

Supported Operating Systems and Browsers

The supported Operating Systems are:

  • Windows 7+
  • Mac (Apple) 4.8+

On the windows operating system, use the following browsers for best results:

  • Microsoft Internet Explorer Version 11+
  • Mozilla Firefox Version 45+
  • Google Chrome 49+

On MAC operating system, use the following browsers for best results:

  • Safari 9.0.3 (Supported only on Mac operating systems)

Register with JC Connect

If you are new to JC Connect, you need to register before start using JC Connect. Once registered, an e-mail will be sent to you with user credentials. In addition to this, a dedicated store will be allotted to you in the Jamcracker Platform. Once you complete configuring the services on the JC Connect portal, you can test the service.

Getting Registered with JC Connect

To register with JC Connect, do the following:

  1. Click the Register link on the Sign In page. The Register window is displayed.
  2. Type your name in the Your Name field.
  3. Type the company name in the Company Name field.
  4. Type a valid E-mail ID in the E-mail ID field. Your registered e-mail ID will be your log in ID to access JC Connect.
  5. Click Register.

After registering successfully, a confirmation e-mail will be sent to your e-mail with your user credentials.

Log into JC Connect

To log into JC Connect, do the following:

  1. In the Sign-In window, type your username in the Username field.
  2. Type the password in the Password field.
  3. Click the Sign-In link.

Use the Manage Services page to add a new cloud service and configure events which are needed to provision the service to users.

Adding a New Service

  1. On the Manage Services page, click Add New Service button.
  2. The Catalog Listing page is displayed. Use the Catalog Listing tab to configure the service name, description, logo, subscription plans, system requirements, FAQs and service category.

Catalog Listing

Step 1 - Adding Service Information

Step 1 helps you to provide the information that you want to display on the catalog page. Use the Catalog Listing > Name and Description tab to provide the following information.

  1. Type the service name in the Service Name field.
  2. Type a short description about the service in the Short Description field. You can write a short description in 2-3 sentences. The information you enter here will be displayed on the Catalog.
  3. Type an overview about the service you are onboarding in the Long Description field. You can write about the features of the service and that will be displayed on the catalog. The customers can refer this information on the catalog if they want to know more.

    As you fill in the information, a small green check mark will appear indicating that the field is completed satisfactorily and another big green check mark will appear indicating that the step itself is complete. If you see an orange triangle, it means that you have not entered all the expected information. Please make sure to fill in proper information according, otherwise when the time comes to test the system end-to-end, there may be gaps you do not want. If you see a red exclamation mark that means you have not entered required information.

  4. Click Next. The Logo page is displayed.

Step 2 - Upload Service Logos

Use the Logo page to upload the service logos that will appear on the catalog and ordering process. You can select a logo that should appear on the catalog, another logo that should appear on the shopping cart page, and yet another one that should appear on the Dashboard page.

It is imperative that you provide logos that are the exact size. If you see an error message, it is more than likely that you have not provided a logo of the right size.

  1. Click in the Catalog Listing section to upload a service catalog that should appear on the store catalog.
  2. Click in the Shopping Cart section to upload a service catalog that should appear on the shopping cart.
  3. Click in the Dashboard section to upload a service catalog that should appear on the customer Dashboard page.

    It is important that you provide the logos that are in the exact sizes. Otherwise, you will get errors.

  4. Click Next.

The Subscription Plans page is displayed. Use the Subscription Plans page to create different offers for the service.

Step 3 - Subscription Plans

  1. Type a unique offer name in the Name field.
  2. Select the Unit of the offer from the Unit Description drop-down list.
  3. Select the billing cycle from the Billing Cycle drop-down list.
  4. Click the Add another link to add another offer. You can add as many offers as you want.
  5. Click Next.

The System Requirements, FAQs page is displayed. Use this page to specify the system requirements, frequently asked questions and answers and upload marketing collaterals.

Step 4 - Enter System Requirements and Upload Marketing Collaterals

  1. Type the system requirements in the System Requirements field.
  2. Type the FAQs in the FAQs field.
  3. Click Upload in the Upload Marketing Collateral section to upload the marketing collaterals of the service.
  4. Click Next.

The Service Category page is displayed.

Step 5 - Select the category

Categories organize service catalog items into logical groups in the catalog. Select and enable categories to which you want the service to be displayed under by marking them. The selected categories with the main category will be displayed in the Selected Categories list.

Order Flow

Use the Order Flow tab to configure the shopping cart options, license agreement and build additional information form.

Step 1 - Shopping Cart Options

  1. Click the Order Flow tab.
  2. Select the existing static quantity status. You can select either Yes or No. Static quantity means that customers cannot decide the quantity when ordering the service. The quantity defined in the minimum quantity field is what will be provided to the customer. It will display the previously defined offers for your service. For each one, you will select whether these offers are sold as a Static Quantity (i.e. in a fixed amount). If you select "Yes" the minimum quantity should indicate that fixed amount you sell that offer in (it defaults to one, as that is the most common fixed amount). Alternatively, if you permit multiple units to be purchased, select "No" and indicate the minimum quantity order you will accept. By Static Quantity, it means that a service can only be purchased in a fixed amount. For example, a company usually only buys 1 email server license (which itself is configured for several users).

The License Agreement tab is displayed.

Step 2 - License Agreement

  1. Enter the service license agreement or upload the license agreement in html file. Step 2 prompts you to enter the SLA you apply to your services. This will be displayed during the checkout process and the purchaser will be required to agree to that SLA. You can enter your SLA by typing it in or uploading a file that contains the information.
  2. Click Next.

Step 3 - Build Additional Info Form

The Build Additional Info Form tab is displayed. Use this tab to build a form using which you can collect any additional information from the customer which is necessary for provisioning the service. The information is collected when a customer orders a service.

  1. Click Select From Existing Fields button. The Fields window is displayed. The tabs that display are organizational fields and user fields.
    1. Organization Fields: These are fields that are associated with the organization. In the JSDN store, the customer admin will be asked to enter the organization level fields during the checkout process of the service.
    2. User Fields: These are the fields associated with the user. In the JSDN store, the administrator will be asked to enter the user level fields during the assignment of the service to the end-user.

Create New Organizational Fields:

You can create new Organizational field or user field by clicking on the “Create New Organizational Field/User Fields link. When you click on the link, you will get the option to choose what type of field should be created.

Once you make your selection, the Build Additional Info form is displayed where you have to to enter the field configuration details:

  • Unique Field Name: Enter a unique field name.
  • Field Label: Enter a unique lable name.
  • Description: Enter a quick description for this field. The content entered here will appear as a tooltip in the store.
  • Data Type: Select the data type from the drop-down list.
  • Default value: When the field type Id drop-down or multi-select box, the values to be displayed to the user should be entered in this field separated by semicolon. Example: for a Yes/No drop-down, the value in default value field should be Yes; No

Enable the Share this field value across services checkbox, to ensure the values are shared with other services in JSDN as well. During the setup of other services, this field will be listed existing fields list. If the checkbox next to this field is checked while building the additional info form, this field and its value will be included as part of the new service.

In the store, once a value is entered by the user for this field, the field value will be shared across all the services that are using this field i.e. the same field cannot have different value for different services.

Delete a field

All the fields that have been added by the user will be listed. In order to delete the field you have to click on the “X” option next to the field. When you click the delete icon, the system will check if the field is associated with any other service. If the field is already in use by the current service or any other service, it will not delete. However, the system will show an error message, “This field is in use and cannot be deleted”.
Note: Default fields cannot be deleted. If the you try to delete a default field, the system will show an error message “Default fields cannot be deleted.”
  1. From the All Fields drop-down list, select JSDN DefaultField. All the JSDN Default fields will be displayed. Select the fields which you want to be available on the Form. In addition to the JSDN Default fields, you can create additional fields which are needed to collect information.

    The selected fields will be displayed on the Build Additional Form

  2. Click Next.

Service Provisioning

The Global Service Provisioning Options tab is displayed.

Global Service Provisioning Options

Select the Do not allow provisioning to any more users if customer does not have enough licenses option if you want to restrict the service provisioning to users if sufficient licenses are not available.

Select the Automatically Provision the service to the user ordering the service option if you want to provision the service automatically to the user who order the service.

Provisioning Events

You’ll define how each of the provisioning events should be provided to you by the JSDN.

Use the Service Provisioning tab to configure both organization level and user level provisioning events.

There are six events defined for service provisioning. These are divided into Organization and User events. Each event should be configured so that full administration of the service and its offerings can be performed.

Organizational Events

New Order Event Configuration

To configure the new order event, click the Configure button next to What has to happen when a new order is placed. Select either Automatic or Manual provisioning method.

If you choose an automatic provisioning method, you need to develop a service provisioning adapter to handle the new order event.

Download the Adapter Development Guide to refer to the guidelines for developing the adapter. Click the Configure button.

Automatic Provisioning Method

If you select Automatic method, specify the adapter url and credentials that must be used by the system when sending the request for this event.

  1. Select Automatic option based on your requirement.
  2. Download the Adapter Development Guide to refer to the guidelines for developing the adapter.
  3. Click the Configure button.
  4. Select whether you want the XML request inside SOAP Envelope - select Yes or No.
  5. Type the Adapter URL in the Adapter URL field.
  6. Now, type the Username and Password to access the adapter.
  7. Type the username in the Username field.
  8. Type the password in the Password field.
  9. Select the fields about which the JSDN adapter should send as information to the ISV adapter
  10. Click the Add Service Fields button to add as many fields as you want.

If your adapter is configured, you can go ahead and test the adapter configuration by clicking on the Test button.

Manual Provisioning Method

In the Manual provisioning method, the system sends out e-mails to the e-mail addresses you configure. You need to configure the e-mail and the data to help fulfill the new order request.

  1. In the From field, type the sender (From e-mail address) for the e-mail.
  2. In the To field, type the e-mail id of the receiver.
  3. Type the required E-mail ID in the CC field.
  4. Select the fields which you want JSDN to send information about to the configured e-mail Id.

Increase or Decrease License

  1. To configure Increase or Decrease License events, click Configure button next to What has to happen when we increase or decrease license?. Select either Automatic or Manual provisioning method.
  2. If you choose an automatic provisioning method, you need to develop a service provisioning adapter to handle the increasing or decreasing license event.
  3. Select Automatic or Manual method based on your requirement. Download the Adapter Development Guide to refer to the guidelines for developing the adapter.

Follow the steps as in the New OrderAutomatic Provisioning Methodand Manual Provisioning Methodmethod to configure the increase or decrease licensing event.

Order Cancellation

  1. To configure Order Cancellation event, click Configure button next to What has to happen when an order is cancelled ?. Select either Automatic or Manual provisioning method.
  2. To configure the new order event, click Configure button next to What has to happen when an order is cancelled. Select either Automatic or Manual provisioning method. If you choose an automatic provisioning method, you need to develop a service provisioning adapter to handle the new order event.
  3. Select Automatic or Manual method based on your requirement. Download the Adapter Development Guide to refer to the guidelines for developing the adapter.

Follow the steps as in the New OrderAutomatic Provisioning Methodand Manual Provisioning Methodmethod to configure the order cancellation event.

User Events

The following are the user events you need to configure.

Provision Service to User

  1. To configure Order Cancellation event, click Configure button next to Provision Service to User. Select either Automatic or Manual provisioning method.
  2. If you choose an automatic provisioning method, you need to develop a service provisioning adapter to handle provision service to user event.
  3. Select Automatic or Manual method based on your requirement. Download the Adapter Development Guide to refer to the guidelines for developing the adapter.

Follow the steps as in the New OrderAutomatic Provisioning Methodand Manual Provisioning Methodmethod to configure the user event.

User Info Updated

  1. To configure Order Cancellation event, click Configure button next to Provision Service to User. Select either Automatic or Manual provisioning method.
  2. If you choose an automatic provisioning method, you need to develop a service provisioning adapter to provisioning a service to a user.
  3. Select Automatic or Manual method based on your requirement. Download the Adapter Development Guide to refer to the guidelines for developing the adapter.

Follow the steps as in the New OrderAutomatic Provisioning Methodand Manual Provisioning Methodmethod to configure the update user event.

De-provision service from user

  1. To configure Order Cancellation event, click Configure button next to De-Provision Service from User. Select either Automatic or Manual provisioning method. Select either Automatic or Manual provisioning method.
  2. To configure the new order event, click Configure button next to What has to happen when a service is de- provisioned. Select either Automatic or Manual provisioning method. If you choose an automatic provisioning method, you need to develop a service provisioning adapter to handle the new order event.
  3. Select Automatic or Manual method based on your requirement. Download the Adapter Development Guide to refer to the guidelines for developing the adapter.

Follow the steps as in the New OrderAutomatic Provisioning Methodand Manual Provisioning Methodmethod to configure de-provisioning of services from user event.

Single Sign On (SSO)

The Single Sign On (SSO) tab is displayed. You can configure the single-sign on event.

  1. Type the SSO URL in the SSO URL field.
  2. Select the HTTPS Method - Get or Post for retrieving information. Specify the SSO parameters
  3. Type the parameter name in the Parameter Name field.
  4. Type the parameter value in the Parameter Value field. Click Link to Field to select and link the field. Click Finish.

Once you complete, you can send it for approval. The administrators who are authorized to approve the service can approve the service.

Managing Service

The Manage Services page lists all the services that you have configured using JC Connect. Use the Manage Services page to add or configure a new service, edit, publish or remove a service.

Adding a Service

Use the Add New Service link to add a new cloud service. You can enter service related information such as service name, description, price and provisioning information. Refer to the Adding a new service for more information.

Editing a Service

Click the Edit link next to a service to edit the service.

Publishing a Service

Click the Publish link to publish a service. Once published, the service will be moved to Saved status and it will be added to as part of the catalog listing on the store allocated to you. You can log in to the store and review the service listing and configuration.
Note: If JC Connect is not part of your marketplace, you have to contact our Support team to get the service added to your marketplace.

Removing a Service

Click the Remove link next to the service. You will be prompted with an alert asking whether you really want to remove the service. Click Confirm.

Managing User Profile

Use the My Profile page to update your profile details.

  1. Click at the top of any page. A small window is displayed with your profile details.
  2. Click the Profile link in the window. The Profile Details page is displayed. You can modify the profile information as required.
  3. You can edit your name in the Your Name field.
  4. You can edit the company name in the Company field.
  5. You can edit the e-mail id in the E-mail ID field.
  6. You can edit the password in the Password field.
  7. Select a security question from the Security Question drop-down list.
  8. Type the answer in the Answer field. The security question and answer will help the system to verify your identity and help you reset your password.
  9. Click Save to save the updates.