mirror of
https://github.com/andwati/zitadel.git
synced 2026-11-17 19:05:13 +00:00
chore: naming inconsistency application (#11431)
This commit is contained in:
@@ -294,5 +294,5 @@ the [Sent information Response](./usage#sent-information-response) payload descr
|
||||
## Conclusion
|
||||
|
||||
You have successfully set up a target and execution to manipulate API responses in your ZITADEL instance.
|
||||
This feature can now be used to add necessary information for clients including the new login UI.
|
||||
This feature can now be used to add necessary information for applications including the new login UI.
|
||||
Find more information about the actions feature in the [API documentation](/concepts/features/actions_v2).
|
||||
|
||||
@@ -4,7 +4,7 @@ sidebar_label: Back-Channel Logout
|
||||
---
|
||||
|
||||
The Back-Channel Logout implements [OpenID Connect Back-Channel Logout 1.0](https://openid.net/specs/openid-connect-backchannel-1_0.html)
|
||||
and can be used to notify clients about session termination at the OpenID Provider. This guide will explain how
|
||||
and can be used to notify applications about session termination at the OpenID Provider. This guide will explain how
|
||||
back-channel logout is implemented inside ZITADEL and gives some usage examples.
|
||||
|
||||
<Callout type="info">
|
||||
@@ -24,8 +24,8 @@ understanding on the following topics before starting with this guide:
|
||||
## Concept
|
||||
|
||||
ZITADEL provides the possibility for OpenID Connect clients to be notified about the session termination, for example
|
||||
if a user signs out from another client using the same SSO session.
|
||||
This allows the client to also invalidate the user's session without the need for an active browser session.
|
||||
if a user signs out from another application using the same SSO session.
|
||||
This allows the application to also invalidate the user's session without the need for an active browser session.
|
||||
|
||||

|
||||
|
||||
@@ -57,7 +57,7 @@ provides the possibility to match the exact SSO session, which was terminated.
|
||||
|
||||
### Client
|
||||
|
||||
To enable the back-channel logout on a client, they simply need to register a `backchannel_logout_uri` as part of their
|
||||
To enable the back-channel logout on an application, they simply need to register a `backchannel_logout_uri` as part of their
|
||||
configuration, e.g. [creating an OIDC application](https://zitadel.com/docs/reference/api/management/management-service-add-oidc-app).
|
||||
|
||||
As soon as the URI is set, every new authorization request will register a back-channel notification to be sent once
|
||||
@@ -66,7 +66,7 @@ the session is terminated by a user sign out.
|
||||
## Back-Channel Request
|
||||
|
||||
When the session is terminated, ZITADEL will send back-channel logout requests asynchronously to every registered
|
||||
client of the corresponding session.
|
||||
application of the corresponding session.
|
||||
The request is an `application/x-www-form-urlencoded` POST request to the registered URI including a `logout_token`
|
||||
parameter in the body.
|
||||
|
||||
|
||||
@@ -25,7 +25,7 @@ You will have to paste it in the Entra ID Client later.
|
||||
|
||||
You need to have access to an Entra ID Tenant. If you do not yet have one follow [this guide from Microsoft](https://docs.microsoft.com/en-us/azure/active-directory/develop/quickstart-create-new-tenant) to create one for free.
|
||||
|
||||
### Register a new client
|
||||
### Register a new application
|
||||
|
||||
1. Browse to the [App registration menus create dialog](https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/CreateApplicationBlade/quickStartType~/null/isMSAApp~/false) to create a new app.
|
||||
2. Give the application a name and choose who should be able to login (Single-Tenant, Multi-Tenant, Personal Accounts, etc.) This setting will also have an impact on how to configure the provider later on in ZITADEL.
|
||||
|
||||
@@ -29,7 +29,7 @@ You will have to paste this URL in your external OIDC provider's application con
|
||||
|
||||
1. Log in to your external OIDC Provider's dashboard or management console.
|
||||
2. Navigate to the applications, clients, or integrations section (name may vary depending on your provider).
|
||||
3. Create a new application or client and select "OIDC" or "OpenID Connect" as the type.
|
||||
3. Create a new application and select "OIDC" or "OpenID Connect" as the type.
|
||||
4. Set a name for the application.
|
||||
5. [Paste the ZITADEL Callback URL you copied before](#open-the-generic-oidc-provider-template) into the "redirect URIs" or "sign-in redirect URIs" field.
|
||||
6. Save or copy the generated **Client ID** and **Client Secret**.
|
||||
|
||||
@@ -26,7 +26,7 @@ You will have to paste it in the Google Cloud Platform later.
|
||||
|
||||
## Google Configuration
|
||||
|
||||
### Register a new client
|
||||
### Register a new application
|
||||
|
||||
1. Go to the Google Cloud Platform and choose your project: [https://console.cloud.google.com/apis/credentials](https://console.cloud.google.com/apis/credentials)
|
||||
2. Click on "+ CREATE CREDENTIALS" and choose "OAuth client ID"
|
||||
|
||||
@@ -130,7 +130,7 @@ Example Response POST-binding:
|
||||
}
|
||||
```
|
||||
|
||||
Which expects your client to do a POST call to the URL `https://myapp.example.com/acs` with the payload containing the following attributes:
|
||||
Which expects your application to do a POST call to the URL `https://myapp.example.com/acs` with the payload containing the following attributes:
|
||||
|
||||
```
|
||||
RelayState: "CncN92gdF6is7bak63thXOsn0MmJn7CLQeGKWaXZo2L8nJN0sPEHbb4I",
|
||||
@@ -154,7 +154,7 @@ Example Response Redirect-binding:
|
||||
}
|
||||
```
|
||||
|
||||
Which expects your client to redirect to the url 'https://myapp.example.com/acs?RelayState=...&SAMLResponse=...' with all information as URL parameters.
|
||||
Which expects your application to redirect to the url 'https://myapp.example.com/acs?RelayState=...&SAMLResponse=...' with all information as URL parameters.
|
||||
|
||||
### SAML Endpoints
|
||||
|
||||
|
||||
@@ -225,7 +225,7 @@ This strategy aims to fulfill the following requirements:
|
||||
2. Applications have enough time to see the next activated web key on the [JWKS](#json-web-key-set) endpoint.
|
||||
3. Web keys are kept long enough to cover the access and ID token validity of 24 hours.
|
||||
4. Web keys are kept long enough to to allow usage of the `id_token_hint` for at least 3 months.
|
||||
Users that haven't logged in / refreshed tokens with the client app for that period,
|
||||
Users that haven't logged in / refreshed tokens with the client application for that period,
|
||||
will need to re-enter their username.
|
||||
|
||||
When the instance was created, resp. the feature was rolled out, the instance got two keys with the first one activated. When this feature becomes generally available, instance creation will setup the first two keys in the same way. So the initial state always looks like this:
|
||||
|
||||
@@ -40,7 +40,7 @@ In order to access role information via the token you must include the right aud
|
||||
|
||||
An important concept in OpenID Connect (OIDC) is the 'audience' (`aud`) claim, which is part of the token payload. The `aud` claim identifies who or what this token is intended for. If the recipient (e.g., a resource server) does not identify itself with a value in the `aud` claim when this claim is present, then the token must be rejected.
|
||||
|
||||
The audience is essential in multi-tier systems, where you may authenticate with one client (in one project) but access resources from another client (in a different project) or when you are accessing ZITADEL’s management APIs. Without the correct audience in your token, you will run into errors, such as the ‘Invalid audience’ error in ZITADEL.
|
||||
The audience is essential in multi-tier systems, where you may authenticate with one application (in one project) but access resources from another application (in a different project) or when you are accessing ZITADEL’s management APIs. Without the correct audience in your token, you will run into errors, such as the ‘Invalid audience’ error in ZITADEL.
|
||||
|
||||
You can determine the audience in two ways:
|
||||
|
||||
|
||||
@@ -51,7 +51,7 @@ ZITADEL supports two primary authentication methods for service users:
|
||||
* ZITADEL validates the signature using the service user's public key.
|
||||
* JWTs can include expiration dates and scopes to control access.
|
||||
|
||||
Follow our guide on using [private key JWT client authentication](./private-key-jwt) to get started authenticating service users and clients.
|
||||
Follow our guide on using [private key JWT client authentication](./private-key-jwt) to get started authenticating service users and applications.
|
||||
|
||||
#### Benefits of private key JWT authentication
|
||||
|
||||
@@ -74,7 +74,7 @@ Follow our guide on using [private key JWT client authentication](./private-key-
|
||||
* Presents a client ID and client secret associated with the service user.
|
||||
* Simpler than the JWT profile in specific scenarios.
|
||||
|
||||
Follow our guide on using [client credentials grant](./client-credentials) to get started authenticating service users and clients.
|
||||
Follow our guide on using [client credentials grant](./client-credentials) to get started authenticating service users and applications.
|
||||
|
||||
This method is still available in ZITADEL but is generally considered less secure than JWT due to:
|
||||
|
||||
@@ -86,7 +86,7 @@ This method is still available in ZITADEL but is generally considered less secur
|
||||
* **Ready-to-use tokens:** Generated for specific service users and can be directly included in the authorization header of API requests.
|
||||
* **Currently available only for machine users** (service users) and not regular human users.
|
||||
|
||||
Follow our guide on using [personal access tokens](./personal-access-token) to get started authenticating service users and clients.
|
||||
Follow our guide on using [personal access tokens](./personal-access-token) to get started authenticating service users and applications.
|
||||
|
||||
PAT offer some benefits, such as:
|
||||
|
||||
|
||||
@@ -12,7 +12,7 @@ Prerequisites:
|
||||
- Existing ZITADEL instance, organization, and project. Follow our [get started](/guides/start/quickstart) guide to get started. If not present follow [this guide](/guides/start/quickstart)
|
||||
- Existing Cloudflare account and [team domain](https://developers.cloudflare.com/cloudflare-one/glossary/#team-domain)
|
||||
|
||||
## Create the client in ZITADEL
|
||||
## Create the application in ZITADEL
|
||||
|
||||
<CreateApp components={props.components} appType="web" authType="code" appName="Cloudflare" redirectURI="https://<your-team-name>.cloudflareaccess.com/cdn-cgi/access/callback"/>
|
||||
|
||||
@@ -23,7 +23,7 @@ Make sure to enable "User Info inside ID Token" on your application settings.
|
||||

|
||||
|
||||
<Callout>
|
||||
Cloudflare will return an error "User email was not returned. API permissions are likely incorrect". Enable to send the user information inside the token on your client settings.
|
||||
Cloudflare will return an error "User email was not returned. API permissions are likely incorrect". Enable to send the user information inside the token on your application settings.
|
||||
</Callout>
|
||||
|
||||
## Configure Cloudflare Zero Trust Authentication
|
||||
|
||||
+12
-12
@@ -1,17 +1,17 @@
|
||||
Upon successful introspection, regardless of the token type or introspection method, a response with the boolean `active` is returned, indicating if the provided token is active and if the requesting client is part of the token audience. If `active` is true, further information will be provided:
|
||||
|
||||
| **Property** | **Description** |
|
||||
| --- | --- |
|
||||
| `aud` | The audience of the token |
|
||||
| `client_id` | The client_id of the application the token was issued to |
|
||||
| `exp` | Time the token expires (as unix time) |
|
||||
| `iat` | Time the token was issued at (as unix time) |
|
||||
| `iss` | Issuer of the token |
|
||||
| `jti` | Unique id of the token |
|
||||
| `nbf` | Time the token must not be used before (as unix time) |
|
||||
| `scope` | Space delimited list of scopes granted to the token |
|
||||
| `token_type` | Type of the inspected token. Value is always Bearer |
|
||||
| `username` | ZITADEL's login name of the user. Consists of username@primarydomain |
|
||||
| **Property** | **Description** |
|
||||
|--------------|----------------------------------------------------------------------|
|
||||
| `aud` | The audience of the token |
|
||||
| `client_id` | The client_id of the application the token was issued to |
|
||||
| `exp` | Time the token expires (as unix time) |
|
||||
| `iat` | Time the token was issued at (as unix time) |
|
||||
| `iss` | Issuer of the token |
|
||||
| `jti` | Unique id of the token |
|
||||
| `nbf` | Time the token must not be used before (as unix time) |
|
||||
| `scope` | Space delimited list of scopes granted to the token |
|
||||
| `token_type` | Type of the inspected token. Value is always Bearer |
|
||||
| `username` | ZITADEL's login name of the user. Consists of username@primarydomain |
|
||||
|
||||
Depending on the granted scopes, additional information about the authorized user is provided.
|
||||
|
||||
|
||||
+3
-3
@@ -40,9 +40,9 @@ Install the package via nuget
|
||||
dotnet add package Zitadel.Api
|
||||
```
|
||||
|
||||
### Create example client
|
||||
### Create example application
|
||||
|
||||
Change the program.cs file to the content below. This will create a client for the management api and call its `GetMyUsers` function.
|
||||
Change the program.cs file to the content below. This will create a application for the management api and call its `GetMyUsers` function.
|
||||
The SDK will make sure you will have access to the API by retrieving a Bearer Token using JWT Profile with the provided scopes (`openid` and `urn:zitadel:iam:org:project:id:zitadel:aud`).
|
||||
|
||||
Make sure to fill the const `apiUrl`, and `personalAccessToken` with your own instance data. The used vars below are from a test instance, to show you how it should look.
|
||||
@@ -86,7 +86,7 @@ result = await client.GetMyUserAsync(new());
|
||||
Console.WriteLine($"User: {result.User}");
|
||||
```
|
||||
|
||||
### Test client
|
||||
### Test application
|
||||
|
||||
After you have configured everything correctly, you can simply start the example by:
|
||||
|
||||
|
||||
@@ -35,9 +35,9 @@ You need to add the SDK into Go Modules by:
|
||||
go get -u github.com/zitadel/zitadel-go/v3
|
||||
```
|
||||
|
||||
### Create example client
|
||||
### Create example application
|
||||
|
||||
Create a new go file with the content below. This will create a client and call its `GetMyOrg` function on the ManagementService.
|
||||
Create a new go file with the content below. This will create a application and call its `GetMyOrg` function on the ManagementService.
|
||||
The SDK will make sure you will have access to the API by retrieving a Bearer Token using JWT Profile with the provided scopes (`openid` and `urn:zitadel:iam:org:project:id:zitadel:aud`).
|
||||
|
||||
```go reference
|
||||
@@ -82,5 +82,5 @@ Now you can proceed implementing our APIs by adding more calls or using a differ
|
||||
api.SessionService().CreateSession(ctx, &session.CreateSessionRequest{})
|
||||
```
|
||||
Checkout more [examples from the SDK](https://github.com/zitadel/zitadel-go/blob/next/example),
|
||||
like how you can integrate the [client in your own API](https://github.com/zitadel/zitadel-go/blob/next/example/api/client/main.go)
|
||||
like how you can integrate the [application in your own API](https://github.com/zitadel/zitadel-go/blob/next/example/api/client/main.go)
|
||||
or refer to our [API Docs](/apis/introduction).
|
||||
|
||||
@@ -13,7 +13,7 @@ import AppType from "./_application-types.mdx";
|
||||
## What is an application?
|
||||
|
||||
Applications are the entry point to your [Project Overview](/guides/manage/console/projects-overview)
|
||||
. Users either login into one of your clients (Frontend) and interact with them directly, or use one of your APIs (Backend).
|
||||
. Users either login into one of your applications (Frontend) and interact with them directly, or use one of your APIs (Backend).
|
||||
|
||||
All applications within a project share the same **Roles** and **Authorizations**. This means you define a role once (e.g., `admin`) on the Project level, and it applies across all your web, mobile, and API applications.
|
||||
|
||||
@@ -23,7 +23,6 @@ To access your applications, navigate to your Project in the Management Console
|
||||
alt="Granted project"
|
||||
src="/docs/img/guides/console/applications.png"
|
||||
width="750px"
|
||||
|
||||
/>
|
||||
|
||||
## Create an Application
|
||||
@@ -38,7 +37,7 @@ To add an application to your project, click on the **New** button and select yo
|
||||
|
||||
## Application Types
|
||||
|
||||
ZITADEL offers five client types to cover different architectural patterns:
|
||||
ZITADEL offers five application types to cover different architectural patterns:
|
||||
|
||||
<AppType components={props.components} />
|
||||
|
||||
|
||||
@@ -11,7 +11,7 @@ import AppType from "./_application-types.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 APIs.
|
||||
Users either login into one of your applications and interact with them directly or use one of your APIs.
|
||||
All applications share the roles and authorizations of their project.
|
||||
|
||||
To access your applications, navigate to your project and select your application.
|
||||
@@ -34,7 +34,7 @@ To add an application to your project, click on the add button and select your a
|
||||
|
||||
## Application Types
|
||||
|
||||
At the moment ZITADEL offers five client types:
|
||||
At the moment ZITADEL offers five application types:
|
||||
|
||||
<AppType components={props.components} />
|
||||
|
||||
|
||||
@@ -154,7 +154,7 @@ The Login Policy defines how the login process should look like and which authen
|
||||
### Default Redirect URI
|
||||
|
||||
The Default Redirect URI will be used, if a user calls the login page directly.
|
||||
More specifically, typically a client will initiate login with an auth request.
|
||||
More specifically, typically an application will initiate login with an auth request.
|
||||
The auth request contains a client-id and a redirect uri, that must match the configuration in ZITADEL.
|
||||
If there is no [auth request](https://zitadel.com/playgrounds/oidc), users will be redirected to the Default Redirect URI, which is by default `https://${CUSTOM_DOMAIN}/ui/console/`
|
||||
|
||||
|
||||
@@ -20,7 +20,7 @@ In a B2B use case, an organization typically represents a business partner who r
|
||||
## Structure and Delegation
|
||||
|
||||
### Projects within Organizations
|
||||
You can use **Projects** within your organization to manage the security context of closely related components, such as roles, grants, and authorizations for multiple clients. You can set up multiple projects within a single organization.
|
||||
You can use **Projects** within your organization to manage the security context of closely related components, such as roles, grants, and authorizations for multiple applications. You can set up multiple projects within a single organization.
|
||||
|
||||
### Organization Grants
|
||||
ZITADEL allows you to give *other* organizations permission to manage certain aspects of a project within *your* organization.
|
||||
|
||||
@@ -12,7 +12,7 @@ import ProjectDescription from "../../../concepts/structure/_project_description
|
||||
### Example
|
||||
|
||||
If you'd build a Point of Sales Platform, you would have one Project (maybe called `POS`) and all your applications (one Webapplication for administration, and your mobile applications for your users iOS and Android), would be part of it.
|
||||
You would have to create roles for administration and your clients in this very project, and then create authorizations based on them.
|
||||
You would have to create roles for administration and your applications in this very project, and then create authorizations based on them.
|
||||
|
||||

|
||||
|
||||
|
||||
@@ -28,7 +28,7 @@ The **Group** is for making multiple roles selectable more easy.
|
||||
|
||||
<img src="/docs/img/guides/console/roles.png" width="750px" alt="Roles" />
|
||||
|
||||
> The role client is for an other application of the project `POS`, as all possible roles from your POS applications are defined in your project.
|
||||
> The role client is for another application of the project `POS`, as all possible roles from your POS applications are defined in your project.
|
||||
|
||||
## Authorizations
|
||||
|
||||
|
||||
@@ -21,7 +21,7 @@ You can do so by using [Console](../console/users) or [setting user metadata](/r
|
||||
|
||||
Most of the methods below require you to login with the correct user while setting some scopes.
|
||||
Make sure you pick the right user when logging into the test application.
|
||||
Use the [OIDC authentication request playground](https://zitadel.com/playgrounds/oidc) or the configuration of an [example client](/sdk-examples/introduction) to set the required scopes and receive a valid access token.
|
||||
Use the [OIDC authentication request playground](https://zitadel.com/playgrounds/oidc) or the configuration of an [example application](/sdk-examples/introduction) to set the required scopes and receive a valid access token.
|
||||
|
||||
<Callout title="Getting a token">
|
||||
In case you want to test out different settings configure an application with code flow (PKCE).
|
||||
@@ -149,7 +149,7 @@ You can use the authentication service to request and search for the user's meta
|
||||
The introspection endpoint and the token endpoint in the examples above do not require a special scope to access.
|
||||
Yet when accessing the authentication service, you need to pass the [reserved scope](/apis/openidoauth/scopes#reserved-scopes) `urn:zitadel:iam:org:project:id:zitadel:aud` along with the authentication request.
|
||||
This scope allows the user to access ZITADEL's APIs, specifically the authentication API that we need for this method.
|
||||
Use the [OIDC authentication request playground](https://zitadel.com/playgrounds/oidc) or the configuration of an [example client](/sdk-examples/introduction) to set the required scopes and receive a valid access token.
|
||||
Use the [OIDC authentication request playground](https://zitadel.com/playgrounds/oidc) or the configuration of an [example application](/sdk-examples/introduction) to set the required scopes and receive a valid access token.
|
||||
|
||||
<Callout title="Invalid audience">
|
||||
If you get the error "invalid audience (APP-Zxfako)", then you need to add the reserved scope `urn:zitadel:iam:org:project:id:zitadel:aud` to your authentication request.
|
||||
|
||||
@@ -86,7 +86,7 @@ We'd appreciate if you could contribute to our repo with translations of your la
|
||||
### Projects and applications
|
||||
|
||||
As our Hosted Login is a separate authentication screen, you have to determine how you are directing your users from your applications.
|
||||
ZITADEL's Applications live under ZITADEL's Projects. You may add multiple applications for your different client-types (Native, Web, User Agent, or API). When setting up your applications consider reading our guide about [Authentication Flows](../integrate/login/oidc/login-users).
|
||||
ZITADEL's Applications live under ZITADEL's Projects. You may add multiple applications for your different application-types (Native, Web, User Agent, or API). When setting up your applications consider reading our guide about [Authentication Flows](../integrate/login/oidc/login-users).
|
||||
|
||||
### Access Control
|
||||
|
||||
|
||||
@@ -13,9 +13,11 @@ This sample app implements the [OIDC PKCE](/guides/integrate/login/oidc/login-us
|
||||
- Login: Exchanges a code challenge for an access token via ZITADEL.
|
||||
- Authorize: Uses the token to retrieve profile data from the userinfo endpoint.
|
||||
- Logout: Clears the local session and revokes the token.
|
||||
|
||||
## Get Started with ZITADEL Cloud
|
||||
|
||||
Set up your ZITADEL account and organization to begin managing identities for your applications.
|
||||
|
||||
### 1. Create your Account and Organization
|
||||
|
||||
You first need access to the ZITADEL Cloud Customer Portal.
|
||||
@@ -32,6 +34,7 @@ This is the administrative hub for managing your billing, teams, and instances.
|
||||
|
||||
Complete the brief onboarding questions.
|
||||
This data helps us prioritize the development of new features, SDKs, and integrations that matter most to our community.
|
||||
|
||||

|
||||
|
||||
### 3. Create your ZITADEL instance
|
||||
@@ -48,10 +51,12 @@ Follow these steps to deploy your first instance:
|
||||
5. **Deploy**: Review your configuration and click Create Instance.
|
||||
|
||||

|
||||
|
||||
### 4. Create your Project and Application
|
||||
|
||||
In ZITADEL, [**Applications**](/guides/manage/console/applications-overview) are grouped into [**Projects**](/guides/manage/console/projects-overview).
|
||||
This allows multiple apps (like a React frontend and a Go backend) to share the same roles and authorizations.
|
||||
This allows multiple applications (like a React frontend and a Go backend) to share the same roles and authorizations.
|
||||
|
||||
#### Launch the Management Console
|
||||
|
||||
Click **Create your app**. This opens the Management Console for your instance in a new tab.
|
||||
@@ -62,6 +67,7 @@ Log in using the Admin credentials you just created.
|
||||
- **Name**: Enter a name (e.g., Project1).
|
||||
- **Framework**: Select React (or choose Other if your stack isn't listed).
|
||||
- **Continue**: Click the Continue button.
|
||||
|
||||

|
||||
|
||||
#### Step 2: Review Default Configuration
|
||||
@@ -74,6 +80,7 @@ ZITADEL automatically configures the best security settings for your selected fr
|
||||

|
||||
|
||||
### 5. Collect your Integration Keys
|
||||
|
||||
To connect your React application to ZITADEL, you need two primary configuration values.
|
||||
These are typically stored as environment variables in your project.
|
||||
|
||||
@@ -85,7 +92,9 @@ These are typically stored as environment variables in your project.
|
||||

|
||||
|
||||
## Integrate ZITADEL into your React App
|
||||
|
||||
### How the Authentication Flow Works
|
||||
|
||||
ZITADEL handles the complexity of the OIDC handshake so your app stays secure without manual token management.
|
||||
1. **Login**: App redirects the user to ZITADEL with a PKCE challenge.
|
||||
2. **Auth**: User authenticates on the ZITADEL hosted login page.
|
||||
@@ -94,6 +103,7 @@ ZITADEL handles the complexity of the OIDC handshake so your app stays secure wi
|
||||
5. **Logout**: The app clears local tokens and terminates the ZITADEL session.
|
||||
|
||||
### 1. Prerequisites
|
||||
|
||||
- [Node.js](https://nodejs.org/): v16 or later.
|
||||
- Code Editor: [VS Code](https://code.visualstudio.com/) or similar
|
||||
- [Yarn](https://yarnpkg.com/): This project uses Yarn for dependency management.
|
||||
@@ -103,7 +113,8 @@ ZITADEL handles the complexity of the OIDC handshake so your app stays secure wi
|
||||
Clone the repository and move into the project directory:
|
||||
```bash
|
||||
git clone https://github.com/zitadel/zitadel-react.git
|
||||
cd zitadel-react```
|
||||
cd zitadel-react
|
||||
```
|
||||
|
||||
### 3. Build and Install
|
||||
|
||||
@@ -113,7 +124,8 @@ Since this repo contains the SDK source, you need to build the library before ru
|
||||
cd lib && yarn install && yarn build
|
||||
|
||||
# Install example app dependencies
|
||||
cd .. && yarn install```
|
||||
cd .. && yarn install
|
||||
```
|
||||
|
||||
### 4. Configure your Credentials
|
||||
|
||||
|
||||
Reference in New Issue
Block a user