docs: improve documentation for v2 release (#4046)

* WIP: docs(proxy): describe proxy settings

* fix nginx

* refactor (docs): deploy and operate sections

* chore: ignore package-lock since we use yarn

* chore: update to rc1

* chore: broken links

* chore: update yarn

* docs: move disclaimer to bottom

* chore: fix broken links

* Update docs/docs/guides/operate/tls_modes.mdx

Co-authored-by: Fabi <[email protected]>

* test caddy files

* syntax highlight

* traefik example

* refactor: docs

* refactor

* working state

* got a working state

* remove bar

* mark rate limits for update

* remove zitadel.ch

* fix cases

* docs: zitadel quickstart

* docs: zitadel quickstart

* docs: create app and project

* docs: move customer portal docs to guides manage cloud

* docs: move customer portal docs to guides manage cloud

* docs: move customer portal docs to guides manage cloud

* docs: add help me choose in the quickstart

* docs: broken links

* fix broken links

* Update knative guide

* styling

* docs: support customer portal

* update to main instead v2-alpha

* use version 2 tag

* docs: images

* docs: move authentication and authorization guides to integrate

* docs: quickstart use examples

* docs: lb example

* fix broken link

* docs: update userinfo endpoints

* docs: update userinfo endpoints

* fix oidc endpoint

* docs: remove unused endpoints in app.module

Co-authored-by: Fabi <[email protected]>
Co-authored-by: Fabienne <[email protected]>
Co-authored-by: Livio Amstutz <[email protected]>
This commit is contained in:
Florian Forster
2022-07-29 10:13:45 +02:00
committed by GitHub
co-authored by Fabi Fabienne Livio Amstutz
parent fb52575f79
commit 3c3bce1a6b
123 changed files with 3212 additions and 25673 deletions
@@ -0,0 +1,74 @@
---
title: Applications
---
import ThemedImage from '@theme/ThemedImage';
import AuthType from '../../integrate/application/auth-type.mdx';
import RedirectURIs from '../../integrate/application/redirect-uris.mdx';
import GenerateKey from '../../integrate/application/generate-key.mdx';
import ReviewConfig from '../../integrate/application/review-config.mdx';
## What is an application?
Applications are the entry point to your project. Users either login into one of your clients and interact with them directly or use one of your API, maybe without even knowing. All applications share the roles and authorizations of their project.
<!-- TODO: oidc vs saml --->
## Application types
If you create a new application in ZITADEL Console you have to choose the type of your application. But which one do you have to choose?
Detailed information about authentication types can be found [here](../../integrate/login-users#create-application).
<ThemedImage
alt="Redirect URIs configuration"
sources={{
light: '/img/guides/app-types-light.png',
dark: '/img/guides/app-types-dark.png'
}}
/>
### Web
Server side rendered applications users interact with. For example if you develop an application using Thymeleaf in Java or Razor in .NET or want to enable SSO in Gitlab.
Following authentication types can be used:
<AuthType appType="web"/>
### Native
Applications installed on a thin client. For example on a smartphone or computer.
These applications uses the Key file generated by ZITADEL to authenticate.
<AuthType appType="native"/>
### User Agent
Applications that are executed in a web browser, for example single page applications executed in the browser developed with JavaScript frameworks like [Angular](../../../examples/login/angular) or [React](../../../examples/login/react)
Following authentication types can be used:
<AuthType appType="user-agent"/>
### API
Applications without human interaction. These applications are accessed by other applications, so called machine to machine communication.
Following authentication types can be used:
<AuthType appType="api"/>
## Redirect URIs
<RedirectURIs appType="web"/>
## Review Configuration
<ReviewConfig authType="code"/>
## Generate key for private key JWT
<GenerateKey appType="api"/>