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: src/content/docs/authenticate/device-authorization-flow/quick-start.mdx
+19-19Lines changed: 19 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,30 +8,30 @@ relatedArticles:
8
8
- 888b1546-8047-4609-af59-8cf859527aa0
9
9
---
10
10
11
-
The Device authorization Flow allows users to authenticate on one device (like a TV or smart device) using another device (like a phone or computer). This is perfect for devices with limited input capabilities.
11
+
The Device Authorization Flow allows users to authenticate on one device (like a TV or smart device) using another device (like a phone or computer). This is perfect for devices with limited input capabilities.
12
12
13
13
In this quick start, you'll learn how to implement the Device Authorization Flow using Kinde in just 5 minutes.
14
14
15
15
## Prerequisites
16
16
17
17
-`curl` or a similar HTTP client
18
18
19
-
## Step 1 - Create a Device Authorization app
19
+
## Step 1: Create a Device Authorization app
20
20
21
-
1. From the home page select **Add application**
22
-
2. Enter a name
23
-
3. Choose **Device and IoT**
24
-
4. Select **Save**
25
-
5. Make a note of the Client ID, you'll need this later
21
+
1. From the Kinde home page select **Add application**.
22
+
2. Enter a name for the application.
23
+
3. Choose **Device and IoT**.
24
+
4. Select **Save**.
25
+
5. Make a note of the Client ID, you'll need this later.
26
26
27
-
## Step 2 - Enable an authentication method for your application
27
+
## Step 2: Enable an authentication method for your application
28
28
29
-
1.Select **Authentication** from the left hand menu
30
-
2. Select **Configure** on the **Passwordless** > **Email + code** card
31
-
3. Under **Applications** select the application you created in step 1
32
-
4. Select **Save**
29
+
1.Go to **Settings > Authentication**.
30
+
2. Select **Configure** on the **Passwordless** > **Email + code** card.
31
+
3. Under **Applications** select the application you created in step 1.
32
+
4. Select **Save**.
33
33
34
-
## Step 3 - Request a device code
34
+
## Step 3: Request a device code
35
35
36
36
Request a device code from Kinde's authorization endpoint:
37
37
@@ -56,14 +56,14 @@ The response will include a `device_code`, `user_code`, and `verification_uri`:
56
56
}
57
57
```
58
58
59
-
## Step 4 - Display the user code
59
+
## Step 4: Display the user code
60
60
61
61
Show the `user_code` to the user and provide the `verification_uri_complete` or QR code from the response. The user should:
62
62
63
-
1. Visit the `verification_uri_complete` URL on their phone or computer
64
-
2. Complete the authentication process
63
+
1. Visit the `verification_uri_complete` URL on their phone or computer.
64
+
2. Complete the authentication process.
65
65
66
-
## Step 5 - Poll for the access token
66
+
## Step 5: Poll for the access token
67
67
68
68
While the user is authenticating, poll the token endpoint:
69
69
@@ -86,7 +86,7 @@ Continue polling every 5 seconds (or the `interval` value from the response) unt
86
86
}
87
87
```
88
88
89
-
## Step 6 - Use the access token
89
+
## Step 6: Use the access token
90
90
91
91
Once you have received the access token, you can call your protected APIs:
92
92
@@ -95,7 +95,7 @@ curl -X GET https://your-api.com/protected-resource \
95
95
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
96
96
```
97
97
98
-
## Useful tips
98
+
## Set an app as default
99
99
100
100
You can set an application to be the default for device flows. This will be the application that is used if no Client ID is specified in the request.
0 commit comments