docs: Update customer portal docs/screenshots (#9604)
# Which Problems Are Solved With the recent updates of our customer portal design, our onboarding guide and customer portal docs were outdated. # How the Problems Are Solved - Updated screenshots of customer portal - Updated screenshots of onboarding in management console - Updated quickstarts with changes that have been made in the onbaording --------- Co-authored-by: Maximilian <mpa@zitadel.com>
@@ -1,14 +1,7 @@
|
|||||||
---
|
---
|
||||||
title: Settings / Billing
|
title: Billing
|
||||||
---
|
---
|
||||||
|
|
||||||
## General
|
|
||||||
|
|
||||||
In the general settings you can change your team name, notification settings and delete your team.
|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||
|
|
||||||
## Billing
|
## Billing
|
||||||
|
|
||||||
In the billing page shows your configured payment methods and the invoice
|
In the billing page shows your configured payment methods and the invoice
|
||||||
|
@@ -54,9 +54,8 @@ To upgrade you must enter your billing information.
|
|||||||
If you hit a limit from the free tier you will automatically be asked to add your credit card information and to subscribe to the pro tier.
|
If you hit a limit from the free tier you will automatically be asked to add your credit card information and to subscribe to the pro tier.
|
||||||
You can also upgrade manually at any time.
|
You can also upgrade manually at any time.
|
||||||
|
|
||||||
1. Go to the settings tab
|
1. Click the "Upgrade to PRO" button in the menu or go to the billing menu
|
||||||
2. You can now see your Plan: "FREE"
|
2. If you choose the billing menu, you can now see your Free plan, click "Upgrade to Pro"
|
||||||
3. Click "Upgrade"
|
|
||||||
4. Add the missing data
|
4. Add the missing data
|
||||||
- Payment method: Credit Card Information
|
- Payment method: Credit Card Information
|
||||||
- Customer: At least you have to fill the country
|
- Customer: At least you have to fill the country
|
||||||
@@ -70,7 +69,7 @@ We recommend register a custom domain to access your ZITADEL instance.
|
|||||||
The primary custom domain of your ZITADEL instance will be the issuer of the instance. All other custom domains can be used to access the instance itself
|
The primary custom domain of your ZITADEL instance will be the issuer of the instance. All other custom domains can be used to access the instance itself
|
||||||
|
|
||||||
1. Browse to the "Custom Domains" Tab
|
1. Browse to the "Custom Domains" Tab
|
||||||
2. Click **Add**
|
2. Click **Add domain**
|
||||||
3. Enter the domain you want and select the instance where the domain should belong to
|
3. Enter the domain you want and select the instance where the domain should belong to
|
||||||
4. In the next screen you will get all the information you will have to add to your DNS provider to verify your domain
|
4. In the next screen you will get all the information you will have to add to your DNS provider to verify your domain
|
||||||
|
|
||||||
|
@@ -2,7 +2,10 @@
|
|||||||
title: Settings
|
title: Settings
|
||||||
---
|
---
|
||||||
|
|
||||||
Manage your team, email subscriptions, and billing information on the [Settings](https://zitadel.com/admin/settings) page.
|
|
||||||
|
In the settings you can change your team name, notification settings and delete your team.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
## Team name
|
## Team name
|
||||||
|
|
||||||
|
@@ -103,25 +103,35 @@ The order of creation for the above components may vary depending on the specifi
|
|||||||
|
|
||||||

|

|
||||||
|
|
||||||
### 2. Create your first instance
|
### 2. Complete onboarding questions
|
||||||
|
|
||||||
As a user of the ZITADEL Cloud Customer Portal, you now can create multiple instances to suit your specific needs. This includes instances for development, production, or user acceptance testing, as well as instances for different clients or applications. For example, you might create an instance for each product in a B2C scenario, or an instance for each tenant or customer in a B2B scenario. The possibilities are endless. You can create your first instance for free.
|
To begin, we'll ask you a few questions.
|
||||||
|
These will help us understand your needs and personalize your ZITADEL experience, ensuring you get the most out of it.
|
||||||
|
|
||||||
1. Let’s create an instance. Click on “Create new instance”.
|

|
||||||
|
|
||||||

|
### 3. Create your first instance
|
||||||
|
|
||||||
|
As a user of the ZITADEL Cloud Customer Portal, you now can create multiple instances to suit your specific needs.
|
||||||
|
This includes instances for development, production, or user acceptance testing, as well as instances for different clients or applications.
|
||||||
|
The possibilities are endless. You can create your first instance for free.
|
||||||
|
|
||||||
|
1. Create an instance.
|
||||||
|
by clicking on “Create Instance”.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
2. Provide a name for your instance and click on the “Continue” button at the bottom of this screen.
|
2. Provide a name for your instance and click on the “Continue” button at the bottom of this screen.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
3. Next, you should see the following screen. Add a username and password for the instance manager and click "Create".
|
3. Next, you should see the following screen. Add a username and password for the instance administrator and click "Create".
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
3. Now you will see the details of your first instance. You can click on "Visit" at the top right to go to your instance.
|
3. After creating your first instance, you're ready to configure user authentication. To access the management console, click the 'Sign in to your instance' button.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
6. To log in to your instance, provide the username and password you set in the instance creation, and click “next”.
|
6. To log in to your instance, provide the username and password you set in the instance creation, and click “next”.
|
||||||
|
|
||||||
@@ -129,23 +139,33 @@ As a user of the ZITADEL Cloud Customer Portal, you now can create multiple inst
|
|||||||
|
|
||||||
8. And there you go! You now have access to your instance.
|
8. And there you go! You now have access to your instance.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
### 3. Create your first project
|
### 4. Create your first project and app
|
||||||
|
|
||||||
1. To create a project in the instance you just created, click on "Projects" in the navigation and then “Create a project”.
|
Because applications are always associated with a project, we'll guide you through setting up both in the following steps.
|
||||||
|
|
||||||
2. Insert “Project1” (or any name of your choice) as the project’s name and click the “Continue” button.
|
1. Click the "Create Application" button or the Framework/Language of your choice on the right side
|
||||||
|
|
||||||

|
2. Insert “Project1” (or any name of your choice) as the project’s name and select the framework/language of your choice in our case "React" and click the “Continue” button. (If you can't find your framework/languages select "Other")
|
||||||
|
|
||||||
3. Now you will be taken to the screen below. “Project1” has been created.
|

|
||||||
|
|
||||||

|
3. An overview of the configuration for the framework you have selected is shown
|
||||||
|
|
||||||
### 4. Add users (optional)
|

|
||||||
|
|
||||||
[Skip optional steps](quickstart/#7-create-an-application-in-your-project) and jump directly to the create application step.
|
What the configuration does:
|
||||||
|
- We recommend using the [Authentication Code Flow](/docs/apis/openidoauth/grant-types#authorization-code) with [Proof Key for Code Exchange (PKCE)](/docs/apis/openidoauth/grant-types#authorization-code) for secure OIDC configuration. This setup includes specific App, Grant, and Response Types, as well as an Authentication Method. More about the different app types can be found [here](/docs/guides/integrate/login/oidc/oauth-recommended-flows#different-client-profiles).
|
||||||
|
- The redirect URI is where the ZITADEL authorization server redirects the user after they have been authenticated. The "Redirect URI" is preconfigured to [http://localhost:3000/callback](http://localhost:3000/callback) and the “Post Logout URI” to [http://localhost:3000/](http://localhost:3000/) for the React example
|
||||||
|
|
||||||
|
4. The detailed configuration of your app will be shown
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
### 5. Add users (optional)
|
||||||
|
|
||||||
|
[Skip optional steps](quickstart/#7-create-an-application-in-your-project) and jump directly to the obtain ClientId and OIDC endpoints.
|
||||||
|
|
||||||
1. To add users, click on “Users” at the top menu. You will see that the user you already created is listed as a user here. Click on the “New” button to create a new user.
|
1. To add users, click on “Users” at the top menu. You will see that the user you already created is listed as a user here. Click on the “New” button to create a new user.
|
||||||
|
|
||||||
@@ -163,7 +183,7 @@ As a user of the ZITADEL Cloud Customer Portal, you now can create multiple inst
|
|||||||
|
|
||||||

|

|
||||||
|
|
||||||
### 5. Add roles to your project (optional)
|
### 6. Add roles to your project (optional)
|
||||||
|
|
||||||
1. To add roles to your project, click on “Roles” on the left as shown below. Next, click on the “New” button.
|
1. To add roles to your project, click on “Roles” on the left as shown below. Next, click on the “New” button.
|
||||||
|
|
||||||
@@ -181,7 +201,7 @@ As a user of the ZITADEL Cloud Customer Portal, you now can create multiple inst
|
|||||||
|
|
||||||

|

|
||||||
|
|
||||||
### 6. Add authorizations to your project (optional)
|
### 7. Add authorizations to your project (optional)
|
||||||
|
|
||||||
1. Click on “Authorizations” on the top menu.
|
1. Click on “Authorizations” on the top menu.
|
||||||
|
|
||||||
@@ -211,54 +231,6 @@ As a user of the ZITADEL Cloud Customer Portal, you now can create multiple inst
|
|||||||
|
|
||||||

|

|
||||||
|
|
||||||
### 7. Create an application in your project
|
|
||||||
|
|
||||||
We will now create an application in the project, which will allow our React client application to access protected resources through the use of the OpenID Connect (OIDC) protocol.
|
|
||||||
|
|
||||||
1. Go to “Projects” and click on “Project1”.
|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||
2. Click on “New” to add a new application.
|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||
3. Provide the name of the app as “React-SPA”. Select “User Agent” and click on “Continue”.
|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||
4. Select “PKCE” because we recommend the use of [Authorization Code](/docs/apis/openidoauth/grant-types#authorization-code) in combination with [Proof Key for Code Exchange (PKCE)](/docs/apis/openidoauth/grant-types#authorization-code) for all web applications. More about the different app types can be found [here](/docs/guides/integrate/login/oidc/oauth-recommended-flows#different-client-profiles). Click on "Continue".
|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||
5. The Redirect URL in your application is where the ZITADEL authorization server redirects the user after they have been authenticated. Set your “Redirect URI” to [http://localhost:3000/callback](http://localhost:3000/callback) and “Post Logout URI” to [http://localhost:3000/](http://localhost:3000/). Click on “Continue”.
|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||
6. Now you will be presented with the details of your application for review. Click on “Create”.
|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||
7. After that, a window will appear showing you your “ClientId”. Click on “Close”.
|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||
8. On the following screen, you may notice some warnings at the top. These warnings are displayed because the URLs for our application are using unsecure HTTP instead of HTTPS. To resolve this, we will need to update our URLs, but there is a workaround to this so that we can continue using HTTP during the development phase.
|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||
9. To proceed with HTTP, go to “Redirect Settings” on the left.
|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||
10. Now activate “Development Mode” as shown below and click “Save”.
|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||
11. Now if you go to “Projects” and “Project1”, you will see the “React-SPA” app listed as an application in the project:
|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||
### 8. Obtain ClientId and OIDC endpoints for your application {#referred1}
|
### 8. Obtain ClientId and OIDC endpoints for your application {#referred1}
|
||||||
|
|
||||||
You will need the ClientId and the OIDC endpoints (issuer and userinfo) when building your React application. The issuer URL is the base URL for the OIDC provider and includes the path to the OIDC discovery document, which contains information about the OIDC provider, including the authorization and token endpoints. By providing the issuer URL, you can use the OIDC library to automatically determine the endpoints for these requests.
|
You will need the ClientId and the OIDC endpoints (issuer and userinfo) when building your React application. The issuer URL is the base URL for the OIDC provider and includes the path to the OIDC discovery document, which contains information about the OIDC provider, including the authorization and token endpoints. By providing the issuer URL, you can use the OIDC library to automatically determine the endpoints for these requests.
|
||||||
|
@@ -139,6 +139,7 @@ module.exports = {
|
|||||||
items: [
|
items: [
|
||||||
"guides/manage/cloud/start",
|
"guides/manage/cloud/start",
|
||||||
"guides/manage/cloud/instances",
|
"guides/manage/cloud/instances",
|
||||||
|
"guides/manage/cloud/settings",
|
||||||
"guides/manage/cloud/billing",
|
"guides/manage/cloud/billing",
|
||||||
"guides/manage/cloud/users",
|
"guides/manage/cloud/users",
|
||||||
"guides/manage/cloud/support",
|
"guides/manage/cloud/support",
|
||||||
|
BIN
docs/static/img/guides/quickstart/20.png
vendored
Before Width: | Height: | Size: 227 KiB |
BIN
docs/static/img/guides/quickstart/21.png
vendored
Before Width: | Height: | Size: 910 KiB |
BIN
docs/static/img/guides/quickstart/38.png
vendored
Before Width: | Height: | Size: 758 KiB |
BIN
docs/static/img/guides/quickstart/39.png
vendored
Before Width: | Height: | Size: 387 KiB |
BIN
docs/static/img/guides/quickstart/41.png
vendored
Before Width: | Height: | Size: 539 KiB |
BIN
docs/static/img/guides/quickstart/42.png
vendored
Before Width: | Height: | Size: 387 KiB |
BIN
docs/static/img/guides/quickstart/43.png
vendored
Before Width: | Height: | Size: 308 KiB |
BIN
docs/static/img/guides/quickstart/44.png
vendored
Before Width: | Height: | Size: 338 KiB |
BIN
docs/static/img/guides/quickstart/45.png
vendored
Before Width: | Height: | Size: 1.0 MiB |
BIN
docs/static/img/guides/quickstart/46.png
vendored
Before Width: | Height: | Size: 1.3 MiB |
BIN
docs/static/img/guides/quickstart/47.png
vendored
Before Width: | Height: | Size: 1.1 MiB |
BIN
docs/static/img/guides/quickstart/48.png
vendored
Before Width: | Height: | Size: 1.1 MiB |
BIN
docs/static/img/guides/quickstart/49.png
vendored
Before Width: | Height: | Size: 425 KiB |
BIN
docs/static/img/guides/quickstart/50.png
vendored
Before Width: | Height: | Size: 1.0 MiB |
BIN
docs/static/img/guides/quickstart/app_detail_overview_react.png
vendored
Normal file
After Width: | Height: | Size: 500 KiB |
BIN
docs/static/img/guides/quickstart/create_instance.png
vendored
Normal file
After Width: | Height: | Size: 607 KiB |
BIN
docs/static/img/guides/quickstart/create_instance_admin.png
vendored
Normal file
After Width: | Height: | Size: 637 KiB |
BIN
docs/static/img/guides/quickstart/create_instance_name.png
vendored
Normal file
After Width: | Height: | Size: 636 KiB |
BIN
docs/static/img/guides/quickstart/create_project_react.png
vendored
Normal file
After Width: | Height: | Size: 294 KiB |
BIN
docs/static/img/guides/quickstart/instance_dashboard.png
vendored
Normal file
After Width: | Height: | Size: 622 KiB |
BIN
docs/static/img/guides/quickstart/onboarding_questions.png
vendored
Normal file
After Width: | Height: | Size: 783 KiB |
BIN
docs/static/img/guides/quickstart/project_config_overview_react.png
vendored
Normal file
After Width: | Height: | Size: 418 KiB |
BIN
docs/static/img/guides/quickstart/sign_in_instance.png
vendored
Normal file
After Width: | Height: | Size: 605 KiB |
BIN
docs/static/img/guides/quickstart/v3_10.png
vendored
Before Width: | Height: | Size: 142 KiB |
BIN
docs/static/img/guides/quickstart/v3_11.png
vendored
Before Width: | Height: | Size: 228 KiB |
BIN
docs/static/img/guides/quickstart/v3_12.png
vendored
Before Width: | Height: | Size: 229 KiB |
BIN
docs/static/img/guides/quickstart/v3_16.png
vendored
Before Width: | Height: | Size: 394 KiB |
BIN
docs/static/img/guides/quickstart/v3_9.png
vendored
Before Width: | Height: | Size: 316 KiB |
Before Width: | Height: | Size: 279 KiB After Width: | Height: | Size: 364 KiB |
Before Width: | Height: | Size: 218 KiB After Width: | Height: | Size: 302 KiB |
Before Width: | Height: | Size: 214 KiB After Width: | Height: | Size: 307 KiB |
Before Width: | Height: | Size: 318 KiB After Width: | Height: | Size: 439 KiB |
Before Width: | Height: | Size: 278 KiB After Width: | Height: | Size: 368 KiB |
Before Width: | Height: | Size: 201 KiB After Width: | Height: | Size: 248 KiB |
Before Width: | Height: | Size: 353 KiB After Width: | Height: | Size: 475 KiB |
Before Width: | Height: | Size: 217 KiB After Width: | Height: | Size: 335 KiB |
Before Width: | Height: | Size: 458 KiB After Width: | Height: | Size: 349 KiB |
Before Width: | Height: | Size: 283 KiB After Width: | Height: | Size: 399 KiB |
Before Width: | Height: | Size: 186 KiB After Width: | Height: | Size: 411 KiB |