Branding

Updated: May 6, 2021
Contents

The CloudBlue Connect platform enables Distributors to brand (white-label) various aspects of its portals, as shown in the below example:

This image has an empty alt attribute; its file name is connect-branding-1-1024x412.png

Branding can only be configured by Connect staff and doesn’t currently have self-service configuration in the Distributor Portal. This article covers various elements of the branding configuration and covers data that must be provided to your account manager to configure the branding.

Portals Branding

Different portals of Connect (Vendor Portal, Distributor Portal and Customer Activation Screens) supports branding that includes the following attributes:

This image has an empty alt attribute; its file name is connect-branding-2-1024x570.png
#
Attribute
Description
1
Favicon
Image that is shown on the browser
2    
Logo
Distributor logo. It will be shown within the Distributor and Vendor Portals
3
Main color
Main color used on the different screens, including the top frame on top after accessing the portals
4
Name
Name of the different portals, we may specify different name for Distributor and Vendor portals
5
Domains    
Domain where the different portals must answer, for example:
Distributor Portal: https://distributor.example.com
Vendor Portal: https://vendor.example.com
Activation UI for customers: https://activate.example.com
API endpoint: https://api.example.com
6
Title
Title to be shown on the Vendor or Distributor portal, each one may have different title
7
Sign UP URL
In case that Distributor runs a program to allow onboarding of vendors, URL where to redirect them in case that vendor has no account

Email Notifications Branding

Connect sends in multiple cases emails to different actors, for example when a vendor receives a new request, connect may send him a notification. Distributor may customize three (3) aspects for it’s brand:

This image has an empty alt attribute; its file name is connect-branding-3.png
#
Attribute
Description
8
Company
Company name used as sender of email notifications
9
Address
email address uses as from value for emails
10
Footer
Text that will be added at the bottom of each email sent by connect platform, it may contain the standard disclaimer of emails sent by the company

User Agreement Branding

Connect may enforce the acceptance of a user agreement each time that a user is enrolled on any of it’s portals. This enrollment may happen due the creation of new vendors accounts, or due an existing vendor invites a new user to his account. The user will need to supply it’s contact data and agree with the agreement that may be referenced from an external source

This image has an empty alt attribute; its file name is connect-branding-4.png
#
Attribute
Description
11
User Agreement
URL where to redirect customers to read the user agreement

Help Portal Branding

Distributors have an option to either deploy branded help portal or redirect users to any external URL managed externally.

In case that external url is desired, Connect will send a JWT signed with agreed secret that will contain following information:

{
  "redirect": {
    "path": "/support/tickets/new", ## Agreed path where to redirect
    "brand": "vendor.XXXXXXX", # Brand 
    "system": "help" 
  },
  "user": {
    "id": "UR-841-574-187", # Unique ID of the individual user
    "accounts": [ # Array of accounts that such user may be able to access
      {
        "id": "PA-425-033", # id of the account
        "name": "ACME Distributor" # Name of the vendor account
      },
      {
        "id": "VA-004-290", #Unique user id
        "name": "John Doe" #Name of the user
      }
    ],
    "emails": [
      john.doe@null.com # Array of emails of the user
    ],
    "name": "John Doe" #User first and last name
  },
  "exp": 1538746869 #Token Expiration
}

Support Portal Branding

Distributors have an option to either deploy branded support portal experience (managed by Ingram Micro staff) or redirect users to any external URL of the ticketing system, managed externally.

In case that external url is desired, Connect will send a JWT signed with agreed secret containing following information:

{
  "redirect": {
    "path": "/support/tickets/new", ## Agreed path where to redirect
    "brand": "vendor.XXXXXXX", # Brand 
    "system": "tickets" 
  },
  "user": {
    "id": "UR-841-574-187", # Unique ID of the individual user
    "accounts": [ # Array of accounts that such user may be able to access
      {
        "id": "PA-425-033", # id of the account
        "name": "ACME Distributor" # Name of the vendor account
      },
      {
        "id": "VA-004-290", #Unique user id
        "name": "John Doe" #Name of the user
      }
    ],
    "emails": [
      john.doe@null.com # Array of emails of the user
    ],
    "name": "John Doe" #User first and last name
  },
  "exp": 1538746869 #Token Expiration
}

SSL Certificates

Connect users interacts with the platform using 4 different domains / access points, each of following access points are protected using an SSL certificate

  • Distributor portal
  • Vendor portal
  • Fulfillment API endpoint
  • Activation screen for end customers

In order to issue you a CSR you will need to provide the following information:

#
Attribute
Example
16Organization
Acme Inc
17Organizational Unit
Acme Cloud
18Country
US
19State
California
20Locality
Irvine
21Email AddressJohn.doe@acme.com

Requesting your brand

In order to request a brand creation, please contact your Technical Account manager and provide following table filled changing the Example values for desired ones:

#
Attribute
Example
1
Faviconhttps://vendor.connect.cloud.im/favicons/vendor/favicon.ico
2    
Logohttps://vendor.connect.cloud.im/logos/logo.svg
3
Main colorRgb(136,0,7)
4
Name– Distributor Portal: distributor.connect.domain.com
– Vendor Portal: vendor.connect.domain.com
– Activate UI: activate.connect.domain.com
– Fulfillment API: api.connect.domain.com
5
Domains    – Distributor Portal: distributor.connect.domain.com
– Vendor Portal: vendor.connect.domain.com
– Activate UI: activate.connect.domain.com
– Fulfillment API: api.connect.domain.com
6
Title– Distributor Portal: “ACME Distributor PORTAL”
– Vendor Portal: “ACME VENDOR PORTAL”
7
Sign UP URLhttps://vendorprogram.domain.com
8CompanyAcme Inc
9Email Addressno-replay@acme.com
10FooterThis email may contain material that is confidential, and proprietary to Acme Inc, for the sole use of the intended recipient. Any review, reliance or distribution by others or forwarding without express permission is strictly prohibited. If you are not the intended recipient, please contact the sender and delete all copies.”
11User Agreementhttps://www.acme.com/eulas/user_agreement_vendors.html
12Help URLhttps://kb.acme.com
13Help Secret7vpdcAdtP
14Support URLhttps://support.acme.com
15Support SecretZqdiMgB8h
16Organization for CSRAcme Inc
17Organizational Unit for CSRAcme Cloud
18Country for CSRUS
19State for CSRCalifornia
20Locality for CSRIrvine
21Email Address for CSRjohn.doe@acme.com
Is this page helpful?
Translate with Google
Copied to clipboard