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
Copy file name to clipboardExpand all lines: docs/getting-started/core-concepts.mdx
+21-9Lines changed: 21 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -39,34 +39,46 @@ To get started, see the [configuration docs](/docs/guides/configure/auth-strateg
39
39
40
40
## Building your application
41
41
42
-
The Clerk JavaScript SDK, or ClerkJS, is where Clerk all started. It is the core SDK that powers all other JavaScript SDKs, including React and Next.js. The following sections will introduce you to the main objects that make up ClerkJS.
42
+
### Session token
43
43
44
-
### Clerk
44
+
When a user is authenticated in your application, Clerk generates a short-lived session token that you can use to authenticate requests to your backend. This token is a JSON Web Token (JWT) that contains information about the user and their session.
45
+
46
+
Read more about Clerk session tokens and how they work in [the guide on how Clerk works](/docs/guides/how-clerk-works/overview).
47
+
48
+
### Key Clerk objects
49
+
50
+
The Clerk JavaScript SDK, or ClerkJS, is where Clerk all started. It is the core SDK that powers all other JavaScript SDKs, including React and Next.js. As you build, you'll likely interact with the following objects.
51
+
52
+
#### Clerk
45
53
46
54
The [`Clerk`](/docs/reference/javascript/clerk) class is the main entry point for the Clerk JavaScript SDK. All other objects are accessible from the `Clerk` object. As you're building your application, you'll likely interact with these objects, either directly or through helpers provided by the other SDKs, like React hooks or Vue composables.
47
55
48
-
### Client
56
+
####Client
49
57
50
58
A client represents the current device or software accessing an application such as your web browser, native application, or Chrome Extension. It is represented by the [`Client`](/docs/reference/javascript/client) object.
51
59
52
-
### Session
60
+
####Session
53
61
54
62
A session is a secure representation of the authentication state of the current user. Each client can hold multiple sessions on the same device. It is represented by the [`Session`](/docs/reference/javascript/session) object.
55
63
56
-
### User
64
+
####User
57
65
58
66
The [`User`](/docs/reference/javascript/user) object represents the current user of the session. It holds all the basic user information such as the user's name, email addresses, and phone numbers, and including their public, private, and unsafe metadata.
59
67
60
-
### Organization
68
+
####Organization
61
69
62
70
Organizations are a flexible and scalable way to manage users and their access to resources within your Clerk application. With organizations, you can assign specific roles and permissions to users, making them useful for managing projects, coordinating teams, or facilitating partnerships.
63
71
64
-
Users can belong to many organizations. One of them will be the ["active organization"](/docs/guides/organizations/overview#active-organization) of the session. It is represented by the [`Organization`](/docs/reference/javascript/organization) object. To learn about organizations, see the [dedicated guide](/docs/guides/organizations/overview).
72
+
Users can belong to many organizations. One of them will be the [active organization](!active-organization) of the session. It is represented by the [`Organization`](/docs/reference/javascript/organization) object. To learn about organizations, see the [dedicated guide](/docs/guides/organizations/overview).
65
73
66
-
### Sign in
74
+
####Sign in
67
75
68
76
The [`SignIn`](/docs/reference/javascript/sign-in) object holds the state of the current sign-in and provides helper methods to navigate and complete the sign-in process. It is used to manage the sign-in lifecycle, including the first and second factor verification, and the creation of a new session.
69
77
70
-
### Sign up
78
+
####Sign up
71
79
72
80
The [`SignUp`](/docs/reference/javascript/sign-up) object holds the state of the current sign-up and provides helper methods to navigate and complete the sign-up process. Once a sign-up is complete, a new user is created.
81
+
82
+
## Deep dive
83
+
84
+
For a deeper dive into how Clerk works, like how our authentication model works, see the [dedicated guide](/docs/guides/how-clerk-works/overview).
Copy file name to clipboardExpand all lines: docs/guides/organizations/overview.mdx
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -58,7 +58,7 @@ Verified domains can be used to streamline enrollment into an organization. For
58
58
In the Clerk Dashboard, there are two types of workspaces:
59
59
60
60
-**Personal account**: A personal account/workspace is a user's unique, individual space, independent of any organization.
61
-
-**Organization workspace**: An organization workspace is owned and managed by an organization, which can have multiple members, also known as collaborators. The organization workspace that a user is currently viewing is called the [active organization](/docs/guides/organizations/overview#active-organization).
61
+
-**Organization workspace**: An organization workspace is owned and managed by an organization, which can have multiple members, also known as collaborators. The organization workspace that a user is currently viewing is called the [active organization](!active-organization).
62
62
63
63
Most multi-tenant applications want every user to be part of an organization rather than operating in an isolated personal account. Accordingly, **personal accounts are disabled by default** once you enable organizations. After signing up, [a user must create or join an organization before they can proceed](/docs/guides/configure/session-tasks).
Copy file name to clipboardExpand all lines: docs/guides/sessions/session-tokens.mdx
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -98,7 +98,7 @@ Read more about Clerk session tokens and how they work in [the guide on how Cler
98
98
|`sid`| session ID | The ID of the current session. |`sess_123`|
99
99
|`sub`| subject | The ID of the current user of the session. See [RFC 7519](https://datatracker.ietf.org/doc/html/rfc7519#section-4.1.2) for more information. |`user_123`|
100
100
101
-
The following claims are only included if the user is part of an organization and that organization is [active](/docs/guides/organizations/overview#active-organization):
101
+
The following claims are only included if the user is part of an organization and that organization is [active](!active-organization):
102
102
103
103
| Claim | Abbreviation expanded | Description | Example |
0 commit comments