Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion docs/enterprise/adfs-sso.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,10 @@ StackBlitz is excited to offer SAML-based Single Sign-on (SSO) to organizations
## StackBlitz Admin Panel Auth Settings Page

:::warning IMPORTANT:
Admin accounts should not be made with an individual work email that will be used to create a separate user account later. Should this happen, we recommend the following steps:
Each user account (including the Admin User) must have a unique email address. Use a service account email address (like IT@yourcompany.com) to ensure that the admin account doesn't cause email collisions for SSO users. If your admin email address matches an SSO user's email address, said SSO user will receive an "invalid login or password" error when signing in.
\
 
Should this happen, we recommend the following steps:
- Log in as admin
- Navigate to `https://editor.stackblitz.[COMPANY.COM]/users/edit` to change your email address to a different one. It will show the same screen as the changing email/password when first logging in as an admin, but you only need to change your email.
:::
Expand Down
Binary file modified docs/enterprise/assets/okta-sso/okta-integration-5.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/enterprise/assets/saml-config.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 2 additions & 0 deletions docs/enterprise/installation/quickstart-gcp.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,8 @@ Getting started on GCP (no GKE, no existing cluster):
- 8080
- 6443
- Run the kots intaller command: `curl -sSL https://k8s.kurl.sh/stackblitz | sudo bash`.
- **Note:** The KURL installer may prompt some packages for manual installation.
See: [Host Package Requirements](https://kurl.sh/docs/add-ons/kubernetes#host-package-requirements).

:::tip Using load balancers?
Ports 80 and 443 should be forwarded from the load balancer. The remaining ports are for inbound rules on the security group.
Expand Down
2 changes: 2 additions & 0 deletions docs/enterprise/installation/quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,8 @@ Getting started on bare metal (no existing Kubernetes cluster):
- 8080
- 6443
- Run the kots intaller command: `curl -sSL https://k8s.kurl.sh/stackblitz | sudo bash`.
- **Note:** The KURL installer may prompt some packages for manual installation.
See: [Host Package Requirements](https://kurl.sh/docs/add-ons/kubernetes#host-package-requirements).

:::tip Using load balancers?
Ports 80 and 443 should be forwarded from the load balancer. The remaining ports are for inbound rules on the security group.
Expand Down
7 changes: 5 additions & 2 deletions docs/enterprise/okta-sso.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,10 @@ StackBlitz SAML integration relies on a user-level token. To ensure consistent d
### Navigate to Auth Settings Page Within the Admin Panel

:::warning IMPORTANT:
Admin accounts should not be made with an individual work email that will be used to create a separate user account later. Should this happen, we recommend the following steps:
Each user account (including the Admin User) must have a unique email address. Use a service account email address (like IT@yourcompany.com) to ensure that the admin account doesn't cause email collisions for SSO users. If your admin email address matches an SSO user's email address, said SSO user will receive an "invalid login or password" error when signing in.
\
 
Should this happen, we recommend the following steps:
- Log in as admin
- Navigate to `https://editor.stackblitz.[COMPANY.COM]/users/edit` to change your email address to a different one. It will show the same screen as the changing email/password when first logging in as an admin, but you only need to change your email.
:::
Expand All @@ -43,7 +46,7 @@ Next, fill out the `App name` for the SAML integration. This is what the App wil
On the next page, you'll need to fill out a few options using values from the Auth Settings page in the StackBlitz admin dashboard.

- For the `Single sign on URL`, use the `Assertion Customer Service URL` from the StackBlitz Auth Settings page.
- For `Audience URI (SP Entity ID)`, choose an identifier for the SAML application. We recommend using `stackblitz`. Use the same value in your StackBlitz SAML settings for `Issuer (Service Provider Entity ID)`.
- For `Audience URI (SP Entity ID)`, choose an identifier for the SAML application. We recommend using `stackblitz`. Use the same value in your StackBlitz SAML settings for `Client ID (Service Provider Entity ID / Issuer)`.
- In the `Attribute Statements (optional)` section, you must configure the `email` and `name` attributes for your users. We recommend using `user.email` for the `email` attribute, and `user.firstName + " " + user.lastName` for the `name` attribute.

![Configure SAML Integration in Okta](./assets/okta-sso/okta-integration-3.png)
Expand Down
9 changes: 7 additions & 2 deletions docs/enterprise/sso.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,10 +17,15 @@ StackBlitz SAML integration relies on a user-level token. To ensure consistent d
- StackBlitz offers just-in-time provisioning. This means that if a user logs into StackBlitz for the first time using SSO, an account will automatically be created.
:::



### Configure your IdP

:::warning IMPORTANT:
Admin accounts should not be made with an individual work email that will be used to create a separate user account later. Should this happen, we recommend the following steps:
Each user account (including the Admin User) must have a unique email address. Use a service account email address (like IT@yourcompany.com) to ensure that the admin account doesn't cause email collisions for SSO users. If your admin email address matches an SSO user's email address, said SSO user will receive an "invalid login or password" error when signing in.
\
 
Should this happen, we recommend the following steps:
- Log in as admin
- Navigate to `https://editor.stackblitz.[COMPANY.COM]/users/edit` to change your email address to a different one. It will show the same screen as the changing email/password when first logging in as an admin, but you only need to change your email.
:::
Expand Down Expand Up @@ -57,4 +62,4 @@ Please ensure that the email addresses in the IdP are what your users will be us

### Troubleshooting

If you're unable to login after verifying these things, please reach out to [enterprise@stackblitz.com](mailto:enterprise@stackblitz.com) for support.
If you're unable to login after verifying these things, please reach out to [enterprise@stackblitz.com](mailto:enterprise@stackblitz.com) for support.
5 changes: 5 additions & 0 deletions docs/platform/api/javascript-sdk.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,11 @@ og_image: javascript-sdk.png

The StackBlitz JavaScript <abbr title="Software Development Kit">SDK</abbr> lets you programmatically create StackBlitz projects to be opened in a new window or embedded in your docs, example pages, or blog posts. Once embedded, the projects can be controlled by using [the SDK’s VM interface][sdk_vm_docs].

:::tip Interactive Tutorial
In addition to this guide, you can also play with our _interactive_ StackBlitz SDK tutorial (build with [TutorialKit](https://tutorialkit.dev/)): [StackBlitz SDK Tutorial](https://stackblitz-sdk-tutorial.pages.dev/)
:::


## Install the SDK

The SDK is _3kB gzipped_ and can be installed from npm:
Expand Down
Binary file modified docs/platform/webcontainers/assets/chrome-memory-saver.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/platform/webcontainers/assets/chrome-settings-cookies-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/platform/webcontainers/assets/chrome-settings-cookies-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/platform/webcontainers/assets/chrome-settings-cookies-3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/platform/webcontainers/assets/chrome-settings-popups.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/platform/webcontainers/assets/firefox-settings-popups.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
5 changes: 5 additions & 0 deletions docs/platform/webcontainers/browser-config.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,7 @@ This can happen automatically if your popups settings, [chrome://settings/conten

```
https://[*.]webcontainer.io
https://[*.]webcontainer-api.io
```

<img class="mx-auto" alt="Chrome popups settings showing the *.webcontainer.io origins as exceptions" src="./assets/chrome-settings-popups.png" width="800" height="502.37" />
Expand All @@ -40,6 +41,7 @@ Lastly, if Chrome's [memory saver][CHROME_MEMORY_SAVER] is turned on, this step

```
https://webcontainer.io
https://webcontainer-api.io
https://stackblitz.com
```

Expand Down Expand Up @@ -70,6 +72,7 @@ To allow all StackBlitz projects to use Service Workers, go to your browser’s
```
https://[*.]stackblitz.io
https://[*.]webcontainer.io
https://[*.]webcontainer-api.io
```

For instance, in Chrome, go to `chrome://settings/cookies` and add those exceptions in the “Sites that can always use cookies” section.
Expand Down Expand Up @@ -123,6 +126,7 @@ To add exceptions for StackBlitz, scroll down to the “Cookies and Site Data”
```
https://stackblitz.io
https://webcontainer.io
https://webcontainer-api.io
```

<img
Expand All @@ -142,6 +146,7 @@ This can happen automatically if your popups settings, [about:preferences#privac

```
https://webcontainer.io
https://webcontainer-api.io
```

<img alt="Firefox popups settings showing the webcontainer.io site allowed as an exception" src="./assets/firefox-settings-popups.png" width="800" height="649" />
Expand Down
16 changes: 16 additions & 0 deletions docs/public/img/logo/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# StackBlitz Logo

The files in this folder serve as a resource for third parties to access StackBlitz logos.

- ![](https://developer.stackblitz.com/img/logo/stackblitz-bolt-blue.svg)
https://developer.stackblitz.com/img/logo/stackblitz-bolt-blue.svg
- ![](https://developer.stackblitz.com/img/logo/stackblitz-bolt-white.svg)
https://developer.stackblitz.com/img/logo/stackblitz-bolt-white.svg
- ![](https://developer.stackblitz.com/img/logo/stackblitz-logo-black_blue.svg)
https://developer.stackblitz.com/img/logo/stackblitz-logo-black_blue.svg
- ![](https://developer.stackblitz.com/img/logo/stackblitz-logo-black.svg)
https://developer.stackblitz.com/img/logo/stackblitz-logo-black.svg
- ![](https://developer.stackblitz.com/img/logo/stackblitz-logo-white_blue.svg)
https://developer.stackblitz.com/img/logo/stackblitz-logo-white_blue.svg
- ![](https://developer.stackblitz.com/img/logo/stackblitz-logo-white.svg)
https://developer.stackblitz.com/img/logo/stackblitz-logo-white.svg
3 changes: 3 additions & 0 deletions docs/public/img/logo/stackblitz-bolt-blue.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 3 additions & 0 deletions docs/public/img/logo/stackblitz-bolt-white.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
13 changes: 13 additions & 0 deletions docs/public/img/logo/stackblitz-logo-black.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
13 changes: 13 additions & 0 deletions docs/public/img/logo/stackblitz-logo-black_blue.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
13 changes: 13 additions & 0 deletions docs/public/img/logo/stackblitz-logo-white.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading