You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<strong>Kanvas</strong> delivers a collaborative experience similar to how Google Workplace transforms the digital work environment and how Figma democratizes UX design tooling. Kanvas simplifies the complexity of Kubernetes and multi-cloud infrastructure management accessible to all. Kanvas provides a visual, multi-player experience that allows you to create, configure, deploy, and manage modern infrastructure with confidence.</div></div>
<strong>Kanvas</strong> delivers a collaborative experience similar to how Google Workplace transforms the digital work environment and how Figma democratizes UX design tooling. Kanvas simplifies the complexity of Kubernetes and multi-cloud infrastructure management accessible to all. Kanvas provides a visual, multi-player experience that allows you to create, configure, deploy, and manage modern infrastructure with confidence.
Copy file name to clipboardExpand all lines: content/en/cloud/self-hosted/white-labeling/_index.md
+50-22Lines changed: 50 additions & 22 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -37,12 +37,12 @@ Layer5 Cloud supports customizing themes on a per organization basis. This inclu
37
37
38
38
As an [Organization Administrator](/cloud/security/roles/organization-roles/), you can add your organization's logo to the global navigation bar, which supports a large, horizontal logo for desktop users and a small, square logo for mobile users. The logo appears at the top of each user's window for all Layer5 Cloud pages within your organization.
39
39
40
-
{{% card header="Prefrence Example" footer="<i>Example: Selection of theme</i>" %}}
40
+
{{% card header="Preference Example" footer="<i>Example: Selection of theme</i>" %}}
41
41
This example shows how to customize through different themes
You can upload your own logo for your organization. Logo appears in upper left corner of all Layer5 Cloud pages. All teams, workspaces, and users in your organization will use these custom logos.
If you upload a smaller or larger image, the image is resized to exactly 389 x 32 pixels. If the aspect ratio does not match, then the image will be distorted. For example, a 132 x 132 pixel image expands to 389 x 32 pixels, causing distortion.
60
60
61
-
<!-- Insert example logo here -->
62
61
<pre>
63
-
Square logo (mark): 32 width x 32 height pixels
62
+
Square logo (mark): 32 width x 32 height pixels
64
63
</pre>
65
-
{{% card header="Square Logo Example" footer="<i>Example: CNCF branding on Dashboard</i>" %}}
66
-
<p>
67
-
This example includes a custom branding with colors and logo mark as would be displayed on a mobile device.</p>
{{% tab header="Full-sized Logo Example" lang="en" active="true" %}}
68
+
69
+
When users register through the [Open Organization Invitation Link](https://docs.layer5.io/cloud/identity/organizations/org-management/#using-the-open-organization-invitation-link), they will see the full-sized logo.
On the [Organizations page](https://cloud.layer5.io/identity/organizations), you can upload your custom logo for your organization.
80
88
81
89
1. Go to Menu and then [**Identity** > **Organization**].
82
90
1. To open the Edit window, click the pencil icon next to the organization name.
83
-
1. Click Select file to upload and select the logo image on your computer. You'll see a preview your logo.
91
+
1. Click Select file to upload and select the logo image on your computer. You'll see a preview of your logo.
84
92
1. Click Save, if satisfied. You may change your custom logo images at any time.
85
93
86
-
## Customizing your Organization\'s Dashboard
94
+
## Organization Dashboard Customization
87
95
88
96
Layer5 Cloud supports customizing dashboard layouts on a per organization basis. As an administrator of your organization, you can customize the dashboard experience for all members of your organization. To customize your organization's dashboard, select from a collection of widgets to include or exclude.
89
97
@@ -98,12 +106,14 @@ Layer5 Cloud supports customizing dashboard layouts on a per organization basis.
98
106
{{% card header="Add and Remove Widgets" footer="<i>Pick and choose which widgets to include. Reposition and resize each as you like.</i>" %}}
{{% card header="Save and Publish Dashboard" footer="<i>Make your customize layout available to all members of your org or reset your changes to revert to the default layout.</i>" %}}
109
+
{{% card header="Save and Publish Dashboard" footer="<i>Make your customized layout available to all members of your org or reset your changes to revert to the default layout.</i>" %}}
Each of the prebuilt widgets can be added to a dashboard only once. If find that a particular widget that you would like to have is not available, [please let us know](https://layer5.io/company/contact).
Each of the prebuilt widgets can be added to a dashboard only once. If you find that a particular widget that you would like to have is not available, [please let us know](https://layer5.io/company/contact).
116
+
{{< /alert >}}
107
117
108
118
## Custom Domain Name and Login Screen
109
119
@@ -126,21 +136,33 @@ In Layer5 Cloud, navigate to your Provider Organization.
126
136
127
137
Under your Organization name, click Edit. If you cannot click the "Edit" action, verify that you are a [Provider Administrator](/cloud/security/roles).
128
138
129
-
Under "Custom domain", type your custom domain, then click Save. This will create a server configuration will require a reboot in order to take affect.
139
+
Under "Custom domain", type your custom domain, then click Save. This will create a server configuration that will require a reboot in order to take effect.
130
140
131
-
*Note: If your custom domain is an internationalized domain name, you must enter the Punycode encoded version.*
If your custom domain is an internationalized domain name, you must enter the Punycode encoded version.
143
+
{{< /alert >}}
132
144
133
145
Navigate to your DNS provider and create a CNAME record that points your subdomain to the default domain for your site. For example, if you want to use the subdomain `hub.cncf.io` for your user site, create a CNAME record that points `hub.cncf.io` to `cloud.layer5.io`. For more information about how to create the correct record, see your DNS provider's documentation.
134
146
135
147
{{< alert title="Warning" color="warning" >}}
136
148
Warning: We strongly recommend that you do not use wildcard DNS records, such as `*.example.com`. These records put you at an immediate risk of domain takeovers, even if you verify the domain. For example, if you verify example.com this prevents someone from using `a.example.com`, but they could still take over `b.a.example.com` (which is covered by the wildcard DNS record).
137
149
{{< /alert >}}
138
150
151
+
#### Domain Format Requirements
152
+
153
+
1.**Uniqueness:** The domain must be unique across all organizations in Meshery Cloud. It cannot be in use by another organization.
154
+
155
+
2.**Format:** Do not include the protocol (http:// or https://) or the www. prefix. You should enter the pure hostname (e.g., meshery.mycompany.com).
156
+
157
+
3.**Length:** The domain name must be between 3 and 63 characters long.
158
+
159
+
4.**Removing a Domain:** To remove a custom domain assignment, simply clear the domain field and save. An empty field is treated as a request to nullify the domain linkage.
160
+
139
161
#### Verifying your custom domain
140
162
141
163
Open Terminal.
142
164
143
-
To confirm that your DNS record configured correctly, use the dig command, replacing `hub.cncf.io` with your subdomain.
165
+
To confirm that your DNS record is configured correctly, use the dig command, replacing `hub.cncf.io` with your subdomain.
144
166
145
167
<pre>
146
168
$ dig WWW.EXAMPLE.COM +nostats +nocomments +nocmd
@@ -158,7 +180,13 @@ Optionally, to enforce HTTPS encryption for your site, select Enforce HTTPS. It
158
180
Frequently asked questions about white labeling.
159
181
160
182
**Do users have to use my custom URL to access the Organization?**
183
+
161
184
No. In addition to your custom URL, you'll always be able to log in from our website and access your Organization from <https://cloud.layer5.io>.
162
185
163
186
**When I send someone a link that includes my custom URL, do they need to be logged in?**
187
+
164
188
Yes. Users will need to be signed in through your custom URL (not through cloud.layer5.io) in order to open links that include your custom URL. Users who are not logged in can quickly do so, and subsequently, be redirected to the link you have shared.
189
+
190
+
**Why does the custom domain work for my colleagues but not for me?**
191
+
192
+
This issue could potentially be related to your local network environment. It's possible that a local proxy client, VPN, or network accelerator on your computer might be intercepting the network request before it can reach the public internet.
0 commit comments